rougail-tutorials_builder/build.py

171 lines
7.5 KiB
Python
Raw Normal View History

2024-07-21 11:27:47 +02:00
#!/usr/bin/env python3
2025-05-05 18:21:57 +02:00
import sys
2024-07-21 11:27:47 +02:00
from pathlib import Path
from ruamel.yaml import YAML
from ansi2html import Ansi2HTMLConverter
2025-05-05 18:21:57 +02:00
from rougail import Rougail
from rougail.config import get_rougail_config
2025-11-02 20:39:39 +01:00
from rougail.output_console import RougailOutputConsole
from rougail.user_data_yaml import RougailUserDataYaml
2024-07-21 11:27:47 +02:00
from rougail.output_doc import RougailOutputDoc
if __name__ == "__main__":
2025-05-05 18:21:57 +02:00
version = sys.argv[1]
# rougailconfig = RougailConfig.copy()
rougailconfig = get_rougail_config(backward_compatibility=False, add_extra_options=False)
2025-11-02 20:39:39 +01:00
rougailconfig['main_structural_directories'] = ['firefox']
rougailconfig['default_structural_format_version'] = version
2025-05-05 18:21:57 +02:00
if Path('config/namespace').is_file():
has_namespace = True
2024-07-21 11:27:47 +02:00
has_foxyproxy = False
2025-05-05 18:21:57 +02:00
elif Path('foxyproxy').is_dir():
has_foxyproxy = True
has_namespace = True
2024-07-21 11:27:47 +02:00
rougailconfig['main_namespace'] = 'Firefox'
2025-11-02 20:39:39 +01:00
rougailconfig['extra_namespaces'] = {'FoxyProxy': ['foxyproxy']}
2024-07-21 11:27:47 +02:00
else:
2025-05-05 18:21:57 +02:00
has_foxyproxy = False
has_namespace = False
2024-07-21 11:27:47 +02:00
rougailconfig['main_namespace'] = None
# rougailconfig['tiramisu_cache'] = "cache.py"
2025-05-05 18:21:57 +02:00
if Path('mode').is_file():
rougailconfig['modes_level'] = ['basic', 'standard', 'advanced']
has_mode = True
else:
has_mode = False
2025-11-02 20:39:39 +01:00
rougail = Rougail(rougailconfig)
config = rougail.run()
# print(config.value.get())
rougailconfig['step.output'] = 'doc'
rougailconfig['doc.output_format'] = 'github'
rougailconfig['doc.title_level'] = 3
inventory = RougailOutputDoc(config, rougailconfig=rougailconfig.copy())
inventory.load_formatter()
rougailconfig['step.output'] = 'console'
2025-05-05 18:21:57 +02:00
summary = Path('summary_before.md')
if summary.is_file():
with summary.open('r') as sfh:
doc = sfh.read() + '\n\n'
else:
doc = ''
2024-07-21 11:27:47 +02:00
yaml = YAML()
namespace = 'firefox'
file_found = False
if rougailconfig['main_namespace']:
2025-11-02 20:39:39 +01:00
all_dirs = [[rougailconfig['main_structural_directories']], [['foxyproxy']]]
2024-07-21 11:27:47 +02:00
else:
2025-11-02 20:39:39 +01:00
all_dirs = [[rougailconfig['main_structural_directories']]]
2024-07-21 11:27:47 +02:00
2025-11-02 20:39:39 +01:00
doc += inventory.formatter.title('Screenshot', 2) + '\n'
2025-05-05 18:21:57 +02:00
doc += f'<img src="{namespace}.png" width=50% height=50% alt="{namespace.capitalize()} Proxy setting"/>\n\n'
# with doc_file.open('r') as docfh:
# doc += docfh.read()
2025-11-02 20:39:39 +01:00
doc += '\n' + inventory.formatter.title('Structure', 2) + '\n'
print(all_dirs)
2024-07-21 11:27:47 +02:00
for r in all_dirs:
for dirs in r:
for d in dirs:
2025-11-02 20:39:39 +01:00
print(d)
2024-07-21 11:27:47 +02:00
files = list(Path(d).iterdir())
files.sort()
for f in files:
namespace = f.parent.name
file_found = True
if f.name.endswith('.yml') or f.name.endswith('.yaml'):
2025-11-02 20:39:39 +01:00
doc += inventory.formatter.title(str(f), 3)
2025-05-05 18:21:57 +02:00
doc += '\n```yml\n'
2024-07-21 11:27:47 +02:00
with f.open(encoding="utf8") as file_fh:
2025-05-05 18:21:57 +02:00
doc += file_fh.read()
doc += '\n```\n'
2025-11-02 20:39:39 +01:00
rougailconfig['step.output'] = 'doc'
inv_doc = inventory.run()[1]
rougailconfig['step.output'] = 'console'
2025-05-05 18:21:57 +02:00
if file_found and inv_doc:
2025-11-02 20:39:39 +01:00
doc += inventory.formatter.title('Generated documentation', 3)
2025-05-05 18:21:57 +02:00
CMD = f"foo@bar:~$ rougail -v {version} -m firefox/ "
if has_namespace:
CMD += "-s Firefox "
2024-07-21 11:27:47 +02:00
if has_foxyproxy:
2025-05-05 18:21:57 +02:00
CMD += "-xn FoxyProxy -xd 0 foxyproxy/ "
if has_mode:
CMD += "--modes_level basic standard advanced "
cmd = CMD + "-o doc -do github"
2024-07-21 11:27:47 +02:00
doc += f'```console\n{cmd}\n```\n'
2025-05-05 18:21:57 +02:00
doc += inv_doc
2024-07-21 11:27:47 +02:00
#
config = Path('config')
if config.is_dir():
2025-11-02 20:39:39 +01:00
doc += inventory.formatter.title('User data', 2)
2024-07-21 11:27:47 +02:00
configs = list(config.iterdir())
configs.sort()
for idx, dirname in enumerate(configs):
2025-05-05 18:21:57 +02:00
if dirname.is_file():
continue
2024-07-21 11:27:47 +02:00
for filename in dirname.iterdir():
if filename.name.endswith('.yml') or filename.name.endswith('.yaml'):
2025-11-02 20:39:39 +01:00
doc += inventory.formatter.title(f'Example {idx + 1}', 3)
doc += inventory.formatter.title(str(filename), 4)
2025-05-05 18:21:57 +02:00
doc += '\n```yml\n'
2024-07-21 11:27:47 +02:00
with filename.open(encoding="utf8") as file_fh:
2025-05-05 18:21:57 +02:00
doc += file_fh.read()
doc += '\n```\n'
# with filename.open(encoding="utf8") as file_fh:
# objects = yaml.load(file_fh)
2025-11-02 20:39:39 +01:00
# doc += inventory.formatter.yaml(objects)
2025-05-05 18:21:57 +02:00
#readme = dirname / 'README.md'
#if readme.is_file():
2025-11-02 20:39:39 +01:00
# doc += inventory.formatter.title('Description', 4)
2025-05-05 18:21:57 +02:00
# with readme.open() as fh:
# doc += fh.read() + '\n\n'
2024-07-21 11:27:47 +02:00
rougail = Rougail(rougailconfig)
2025-11-02 20:39:39 +01:00
tiramisu_config = rougail.run()
rougailconfig['step.user_data'] = ['yaml']
rougailconfig['yaml.filename'] = [str(filename.absolute())]
data = RougailUserDataYaml(tiramisu_config, rougailconfig=rougailconfig)
2025-05-05 18:21:57 +02:00
ret = data.run()
errors = rougail.user_datas(ret)
2025-11-02 20:39:39 +01:00
export = RougailOutputConsole(tiramisu_config,
rougailconfig=rougailconfig,
user_data_errors=errors['errors'],
user_data_warnings=errors['warnings'],
)
console = export.run()[1]
2024-07-21 11:27:47 +02:00
conv = Ansi2HTMLConverter(inline=True)
2025-11-02 20:39:39 +01:00
doc += inventory.formatter.title('Output', 4)
cmd = CMD + f"-u yaml -ff {filename}"
2024-07-21 11:27:47 +02:00
doc += f"```console\n{cmd}\n```\n"
2025-11-02 20:39:39 +01:00
conv_data = '<pre>' + conv.convert(console, full=False) + "</pre>\n"
2025-05-05 18:21:57 +02:00
doc += conv_data
with open(dirname / 'output_ro.html', 'w') as fh_output:
fh_output.write(conv_data)
if (config / 'read_write').is_file():
2025-11-02 20:39:39 +01:00
tiramisu_config.property.read_write
export = RougailOutputConsole(tiramisu_config,
rougailconfig=rougailconfig,
user_data_errors=data.errors,
user_data_warnings=data.warnings,
)
console = export.run()[1]
2024-07-21 11:27:47 +02:00
conv = Ansi2HTMLConverter(inline=True)
2025-11-02 20:39:39 +01:00
doc += inventory.formatter.title('Output in read write mode', 4)
cmd = cmd + " --cli.read_write"
2024-07-21 11:27:47 +02:00
doc += f"```console\n{cmd}\n```\n"
2025-11-02 20:39:39 +01:00
conv_data = '<pre>' + conv.convert(console, full=False) + "</pre>\n"
2025-05-05 18:21:57 +02:00
doc += '<pre>' + conv_data + "</pre>\n"
with open(dirname / 'output_rw.html', 'w') as fh_output:
fh_output.write(conv_data)
#
summary = Path('summary_after.md')
if summary.is_file():
with summary.open('r') as sfh:
doc += '\n\n' + sfh.read()
2024-07-21 11:27:47 +02:00
#
2025-05-05 18:21:57 +02:00
doc_file = Path('README.md')
2024-07-21 11:27:47 +02:00
with doc_file.open('w') as docfh:
docfh.write(doc)
with doc_file.open('w') as docfh:
docfh.write(doc)