Sphinx - PEP 0 generation

[AA-Turner]

See #2, #1385 for context. Superseeds #1567.

This is the PEP 0 generation part, building on PR #1930. It contains the logic for parsing all PEPs and building the PEP index:

• PEP 0 parser - Parses PEP and Author data
• PEP 0 writer - Writes actual PEP-0000.rst file
• PEP 0 generator Orchestrates process, entry point & docutils integration
• AUTHORS.csv - explicit author overrides

Note that this PR also contains elements from PR #1386.

[pablogsal]

This also needs rebasing

[AA-Turner]

Rebased

[pablogsal]

Moar rebasing 😉

[AA-Turner]

yup, one sec

[AA-Turner]

rebased take 2

[pablogsal]

Can you give me some context on why we need the authors override file? I have a guess but I would like to know the extent of the problem and why is needed now and not before.

[AA-Turner]

Can you give me some context on why we need the authors override file? I have a guess but I would like to know the extent of the problem and why is needed now and not before.

as authors names were parsed wrong / duplicates missed (currently on /dev/python/)

prev discussion:
#2 (comment)
#1386 (comment)
#1386 (comment)

why not before - no idea, but I like to leave things better than I found them

[pablogsal]

prev discussion:

I assume https://github.com/python/peps/pull/1386/files is included here no?

[AA-Turner]

prev discussion:

I assume #1386 (files) is included here no?

yes

[pablogsal]

Will make another pass tomorrow :)

[AA-Turner]

@pablogsal done, and fixed that I accidentally left out the hook into the Sphinx build process!

Apart from that some refactoring for ease of reading / future maintenence - the PEP 0 generation was the area I hadn't touched much as slightly scared to break it!

[pablogsal]

Left one comment, otherwise looks good to me