1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
|
"""Creates a version of traceback_fr.rst to insert in the documentation.
"""
# When creating a new translation, you need to:
# 1. Make a copy of this file
# 2. Change the value of LANG as well as 'intro_text' so that they reflect the
# appropriate language
# 3. Change the first line of this file so that the name of the rst file
# is correct!
import os
import sys
import platform
this_dir = os.path.dirname(__file__)
sys.path.append(os.path.join(this_dir, ".."))
import friendly_traceback
# Make it possible to find docs and tests source
docs_root_dir = os.path.abspath(
os.path.join(this_dir, "..", "..", "friendly-docs")
)
assert os.path.isdir(docs_root_dir), "Separate docs repo need to exist"
sys.path.append(os.path.join(this_dir, ".."))
# sys.path.insert(0, root_dir)
LANG = "fr"
friendly_traceback.install()
friendly_traceback.set_lang(LANG)
friendly_traceback.set_formatter("docs")
sys.path.insert(0, this_dir)
import trb_common
target = os.path.normpath(
os.path.join(docs_root_dir, f"source/tracebacks_{LANG}.rst")
)
intro_text = """
|france| Friendly tracebacks - en Français
===========================================
Le but principal de friendly est de fournir des rétroactions plus
conviviales que les fameux **tracebacks** de Python lorsqu'une exception survient.
.. note::
Le contenu de cette page a été généré par l'exécution de
`{name}` situé dans le répertoire ``tests/``.
Ceci a besoin d'être fait de manière explicite lorsqu'on veut
faire des corrections ou des ajouts, avant de faire la mise
à jour du reste de la documentation avec Sphinx.
Friendly-traceback version: {friendly}
Python version: {python}
""".format(
friendly=friendly_traceback.__version__,
python=platform.python_version(),
name=sys.argv[0],
)
print(f"Python version: {platform.python_version()}; French")
trb_common.create_tracebacks(target, intro_text)
|