# Export documents to other formats.

Literate programs can be translated into many formats. Commonly markup langauges focus on translation to other markup languages, we add an extra ability to convert markup to source code.

    import pidgy, pathlib, typing, textwrap, IPython
    try: from . import util
    except: import util

We can reuse existing nbconvert machinery if we expand every file to a notebook.

    def file_to_nb(file: pathlib.Path) -> "nbformat.NotebookNode":
        import nbformat
        if file.suffix in {'.md', '.markdown'}:
            return nbformat.v4.new_notebook(cells=[nbformat.v4.new_code_cell(file.read_text())])
        return nbformat.reads(file.read_text(), 4)

A notebook can also be flattened.

    def flattennb(nb: typing.Union[str, "nbformat.NotebookNode"]):
        if isinstance(nb, str): return nb
        return [textwrap.indent(''.join(x.source), x.cell_type != 'code' and '# ' or '') for x in nb.cells]

    def to_markup(input: typing.Union[str, "nbformat.NotebookNode"], exporter: "nbconvert.Exporter") -> str:
        return exporter.from_notebook_node(input)[0]

    def to_python(input, tangle = pidgy.tangle.pidgyManager()):
        import black, isort
        code = pidgy.loader.tangle(flattennb(input))
        code = isort.SortImports(file_contents=code).output
        code = black.format_str(code, mode=black.FileMode(line_length=100))
        return code

    def convert(*files, to: {'python', 'markdown'}, write: bool=False):
        import nbconvert
        exporter = nbconvert.get_exporter(to)()
        for file in util.yield_files(files):
            nb = file_to_nb(file)
            if to =='python':
                body = '\n'.join(to_python(''.join(getattr(x, 'source', []))) for x in nb.cells)
            else:
                body = to_markup(nb, exporter)
            if write:
                new = pathlib.Path(file).with_suffix(dict(python='.py', markdown='.md')[to])
                new.write_text(body)
                __import__('click').echo(F"{new} created.")
            else:
                __import__('click').echo(body)

https://stackoverflow.com/questions/34643620/how-can-i-split-my-click-commands-each-with-a-set-of-sub-commands-into-multipl