PyDocTeur

PyDocTeur is a bot used in python-docs-fr automation

Configuration

PyDocTeur will use the following environment (and .env file) variables:

• GH_TOKEN (required): Github access token
• REPOSITORY_NAME (required): Github repository name on which the bot should work
• GH_USERNAME (required): Bot username on Github.
• LOGGING (optional): logging dict-config as a yaml file, see below.

Github WebHook Configuration

You'll need to setup a github webhook using the application/json content type, sending:

• Check suites
• Pull request review comments
• Pull request reviews
• Pull requests
• Pushes
• Issue comments (which in fact also contains pull request comments)

Logging

PyDocTeur use the pydocteur logger, and used libs use the following loggers: requests, urllib3, and github.

You can personalize how each logger is handled by using a yaml file given in the LOGGING environment variable. Here's the default configuration, so you can bootstrap from it:

---
version: 1disable_existing_loggers: falsehandlers:
stderr:
class: logging.StreamHandlerstream: ext://sys.stderrlevel: DEBUGloggers:
pydocteur:
level: DEBUGhandlers: [stderr]urllib3:
level: INFOhandlers: [stderr]reqests:
level: INFOhandlers: [stderr]github:
level: INFOhandlers: [stderr]

Disclaimer

This bot is heavily inspired by miss-iligton made by Mariatta for Cpython

TODO: mypy