alexvanin/rclone
1
0
Fork 0
forked from TrueCloudLab/rclone
Code Pull requests Activity

bin/make_backend_docs: allow generation of docs for just one backend

Browse source
This commit is contained in:
buengese 2022-06-15 15:01:16 +02:00 committed by Sebastian Bünger
parent 0279bf3abb
commit 621c4ebe15
1 changed files with 24 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
bin/make_backend_docs.py
View file

@ -3,9 +3,11 @@
Make backend documentation Make backend documentation
""" """
import sys
import os import os
import io import io
import subprocess import subprocess
from pathlib import Path
marker = "{{< rem autogenerated options" marker = "{{< rem autogenerated options"
start = marker + " start" start = marker + " start"
@ -16,18 +18,19 @@ def find_backends():
"""Return a list of all backends""" """Return a list of all backends"""
return [ x for x in os.listdir("backend") if x not in ("all",) ] return [ x for x in os.listdir("backend") if x not in ("all",) ]
def output_docs(backend, out): def output_docs(backend, out, cwd):
"""Output documentation for backend options to out""" """Output documentation for backend options to out"""
out.flush() out.flush()
subprocess.check_call(["rclone", "help", "backend", backend], stdout=out) subprocess.check_call(["./rclone", "help", "backend", backend], stdout=out)
def output_backend_tool_docs(backend, out): def output_backend_tool_docs(backend, out, cwd):
"""Output documentation for backend tool to out""" """Output documentation for backend tool to out"""
out.flush() out.flush()
subprocess.call(["rclone", "backend", "help", backend], stdout=out, stderr=subprocess.DEVNULL) subprocess.call(["./rclone", "backend", "help", backend], stdout=out, stderr=subprocess.DEVNULL)
def alter_doc(backend): def alter_doc(backend):
"""Alter the documentation for backend""" """Alter the documentation for backend"""
rclone_bin_dir = Path(sys.path[0]).parent.absolute()
doc_file = "docs/content/"+backend+".md" doc_file = "docs/content/"+backend+".md"
if not os.path.exists(doc_file): if not os.path.exists(doc_file):
raise ValueError("Didn't find doc file %s" % (doc_file,)) raise ValueError("Didn't find doc file %s" % (doc_file,))
@ -41,8 +44,8 @@ def alter_doc(backend):
in_docs = True in_docs = True
start_full = (start + "\" - DO NOT EDIT - instead edit fs.RegInfo in backend/%s/%s.go then run make backenddocs\" " + end + "\n") % (backend, backend) start_full = (start + "\" - DO NOT EDIT - instead edit fs.RegInfo in backend/%s/%s.go then run make backenddocs\" " + end + "\n") % (backend, backend)
out_file.write(start_full) out_file.write(start_full)
output_docs(backend, out_file) output_docs(backend, out_file, rclone_bin_dir)
output_backend_tool_docs(backend, out_file) output_backend_tool_docs(backend, out_file, rclone_bin_dir)
out_file.write(stop+" "+end+"\n") out_file.write(stop+" "+end+"\n")
altered = True altered = True
if not in_docs: if not in_docs:
@ -55,7 +58,18 @@ def alter_doc(backend):
if not altered: if not altered:
raise ValueError("Didn't find '%s' markers for in %s" % (start, doc_file)) raise ValueError("Didn't find '%s' markers for in %s" % (start, doc_file))
if __name__ == "__main__":
def main(args):
# single backend
if (len(args) == 2):
try:
alter_doc(args[1])
print("Added docs for %s backend" % args[1])
except Exception as e:
print("Failed adding docs for %s backend: %s" % (args[1], e))
return
# all backends
failed, success = 0, 0 failed, success = 0, 0
for backend in find_backends(): for backend in find_backends():
try: try:
@ -66,3 +80,6 @@ if __name__ == "__main__":
else: else:
success += 1 success += 1
print("Added docs for %d backends with %d failures" % (success, failed)) print("Added docs for %d backends with %d failures" % (success, failed))
if __name__ == "__main__":
main(sys.argv)