Factorize README generation into a function
This commit is contained in:
parent
b2d19fd022
commit
f6d0b63166
1 changed files with 33 additions and 28 deletions
|
@ -4,40 +4,45 @@ import os
|
|||
|
||||
from jinja2 import Environment, FileSystemLoader
|
||||
|
||||
parser = argparse.ArgumentParser(description='Automatically (re)generate README for apps')
|
||||
parser.add_argument('app_path',
|
||||
help='Path to the app to generate/update READMEs for')
|
||||
|
||||
args = parser.parse_args()
|
||||
app_path = args.app_path
|
||||
def generate_READMEs(app_path):
|
||||
|
||||
if not os.path.exists(app_path):
|
||||
raise Exception("App path provided doesn't exists ?!")
|
||||
if not os.path.exists(app_path):
|
||||
raise Exception("App path provided doesn't exists ?!")
|
||||
|
||||
env = Environment(loader=FileSystemLoader('./templates'))
|
||||
env = Environment(loader=FileSystemLoader('./templates'))
|
||||
|
||||
for lang, lang_suffix in [("en", ""), ("fr", "_fr")]:
|
||||
for lang, lang_suffix in [("en", ""), ("fr", "_fr")]:
|
||||
|
||||
template = env.get_template(f'README{lang_suffix}.md.j2')
|
||||
template = env.get_template(f'README{lang_suffix}.md.j2')
|
||||
|
||||
manifest = json.load(open(os.path.join(app_path, "manifest.json")))
|
||||
upstream = manifest.get("upstream", {})
|
||||
manifest = json.load(open(os.path.join(app_path, "manifest.json")))
|
||||
upstream = manifest.get("upstream", {})
|
||||
|
||||
if os.path.exists(os.path.join(app_path, "doc", "screenshots")):
|
||||
screenshots = os.listdir(os.path.join(app_path, "doc", "screenshots"))
|
||||
if ".gitkeep" in screenshots:
|
||||
screenshots.remove(".gitkeep")
|
||||
else:
|
||||
screenshots = []
|
||||
if os.path.exists(os.path.join(app_path, "doc", "screenshots")):
|
||||
screenshots = os.listdir(os.path.join(app_path, "doc", "screenshots"))
|
||||
if ".gitkeep" in screenshots:
|
||||
screenshots.remove(".gitkeep")
|
||||
else:
|
||||
screenshots = []
|
||||
|
||||
if os.path.exists(os.path.join(app_path, "doc", f"DISCLAIMER{lang_suffix}.md")):
|
||||
disclaimer = open(os.path.join(app_path, "doc", f"DISCLAIMER{lang_suffix}.md")).read()
|
||||
# Fallback to english if maintainer too lazy to translate the disclaimer idk
|
||||
elif os.path.exists(os.path.join(app_path, "doc", "DISCLAIMER.md")):
|
||||
disclaimer = open(os.path.join(app_path, "doc", "DISCLAIMER.md")).read()
|
||||
else:
|
||||
disclaimer = None
|
||||
if os.path.exists(os.path.join(app_path, "doc", f"DISCLAIMER{lang_suffix}.md")):
|
||||
disclaimer = open(os.path.join(app_path, "doc", f"DISCLAIMER{lang_suffix}.md")).read()
|
||||
# Fallback to english if maintainer too lazy to translate the disclaimer idk
|
||||
elif os.path.exists(os.path.join(app_path, "doc", "DISCLAIMER.md")):
|
||||
disclaimer = open(os.path.join(app_path, "doc", "DISCLAIMER.md")).read()
|
||||
else:
|
||||
disclaimer = None
|
||||
|
||||
out = template.render(lang=lang, upstream=upstream, screenshots=screenshots, disclaimer=disclaimer, manifest=manifest)
|
||||
with open(os.path.join(app_path, f"README{lang_suffix}.md"), "w") as f:
|
||||
f.write(out)
|
||||
out = template.render(lang=lang, upstream=upstream, screenshots=screenshots, disclaimer=disclaimer, manifest=manifest)
|
||||
with open(os.path.join(app_path, f"README{lang_suffix}.md"), "w") as f:
|
||||
f.write(out)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
parser = argparse.ArgumentParser(description='Automatically (re)generate README for apps')
|
||||
parser.add_argument('app_path',
|
||||
help='Path to the app to generate/update READMEs for')
|
||||
|
||||
args = parser.parse_args()
|
||||
generate_READMEs(args.app_path)
|
||||
|
|
Loading…
Reference in a new issue