vstinner / python-security

Python Security documentation: http://python-security.readthedocs.io/

Input files:

• vulnerabilities.yml: Python vulnerabilities 2007-2017, see the commented template at the end to add a new entry
• python_releases.txt: Python release dates 2.5.0-3.6.0

Cache files:

• commit_dates.txt
• commit_tags.txt

Build the doc:

make

After a release, get new commit tags using:

make update

Update needs a configuration file config.ini, see config.ini.template:

[config]
bpo_username = LOGIN
bpo_password = PASSWORD
# Git checkout of https://github.com/python/cpython/
python_srcdir = /path/to/python

For a X.Y.0 release, add X.Y to MAINTAINED_BRANCHES of render_doc.py.

Build without Makefile:

./venv.sh
./venv/bin/python render_doc.py
sphinx-build -M html . build

For ReadTheDocs.org, other files are used:

• requirements.txt
• setup.py: run render_doc.py