evennia/docs/pylib/api_rst2md.py

#!/usr/bin/python
"""
Remap autodoc API rst files to md files and wrap their contents.

"""

from glob import glob
from os import rename
from os.path import abspath, dirname
from os.path import join as pathjoin


def _rst2md(filename_rst):

    with open(filename_rst, "r") as fil:
        # read rst file, reformat and save
        txt = fil.read()
    with open(filename_rst, "w") as fil:
        txt = "```{eval-rst}\n" + txt + "\n```"
        fil.write(txt)

    # rename .rst file to .md file
    filename, _ = filename_rst.rsplit(".", 1)
    filename_md = filename + ".md"
    rename(filename_rst, filename_md)


if __name__ == "__main__":
    apidir = pathjoin(dirname(dirname(abspath(__file__))), "source", "api")
    for filename_rst in glob(pathjoin(apidir, "*.rst")):
        _rst2md(filename_rst)
    print(" Converted {apidir}/*.rst files to .md files".format(apidir=apidir))