pyrogram/docs/source/generator.py
2018-01-03 18:30:58 +01:00

103 lines
3.1 KiB
Python

# Pyrogram - Telegram MTProto API Client Library for Python
# Copyright (C) 2017-2018 Dan Tès <https://github.com/delivrance>
#
# This file is part of Pyrogram.
#
# Pyrogram is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published
# by the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Pyrogram is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with Pyrogram. If not, see <http://www.gnu.org/licenses/>.
import os
import shutil
functions_path = "../../pyrogram/api/functions"
functions_base = "functions"
types_path = "../../pyrogram/api/types"
types_base = "types"
shutil.rmtree(types_base, ignore_errors=True)
with open("_templates/page.txt") as f:
page_template = f.read()
with open("_templates/toctree.txt") as f:
toctree = f.read()
def generate(source_path, base):
all_entities = {}
def build(path, level=0):
last = path.split("/")[-1]
for i in os.listdir(path):
try:
if not i.startswith("__"):
build("/".join([path, i]), level=level + 1)
except NotADirectoryError:
name = "".join([str(j.title()) for j in os.path.splitext(i)[0].split("_")])
full_path = os.path.basename(path) + "/" + name + ".rst"
if level:
full_path = base + "/" + full_path
os.makedirs(os.path.dirname(full_path), exist_ok=True)
with open(full_path, "w") as f:
f.write(
page_template.format(
title=name,
title_markup="=" * len(name),
full_class_path="pyrogram.api.{}".format(
os.path.splitext(full_path)[0].replace("/", ".")
)
)
)
if last not in all_entities:
all_entities[last] = []
all_entities[last].append(name)
build(source_path)
for k, v in all_entities.items():
entities = []
for i in v:
entities.append(i)
if k != base:
inner_path = base + "/" + k + "/index" + ".rst"
else:
for i in list(all_entities)[::-1]:
if i != base:
entities.insert(0, "{0}/index".format(i))
inner_path = base + "/index" + ".rst"
with open(inner_path, "w") as f:
f.write(
toctree.format(
title=k.title(),
title_markup="=" * len(k),
entities="\n ".join(entities)
)
)
f.write("\n")
generate(types_path, types_base)
generate(functions_path, functions_base)