Skip to content
pythonPublic

About

`blurb add` over the internet

Resources

Code of conduct

Security policy

Stars

33 stars

Watchers

29 watching

Forks

Repository files navigation

blurb_it

https://github.com/python/blurb_it/actions/workflows/ci.yml/badge.svg?event=push

blurb add over the internet.

About

📜🤖 blurb-it allows you to add a misc/news file to your own CPython pull request.

A Misc/NEWS.d file is needed for almost all non-trivial changes to CPython.

To use blurb-it, you must be logged in to GitHub.

Install blurb-it GitHub App to your account, and then grant the write access to your fork of the CPython repository.

Since blurb-it will have write access to the granted repo, you should only install it on your own CPython repository.

Install blurb-it .

Uninstall blurb-it

  1. Go to https://github.com/settings/installations.
  2. Click blurb-it's "Configure" button.
  3. Scroll down and click the "Uninstall" button.

Deploy

blurb-it is deployed to cabotage, the container platform managed by the PSF. cabotage builds the image from the Dockerfile and runs the web process from the Procfile. The web process listens on the unix socket /var/run/cabotage/cabotage.sock when that directory exists, and on PORT otherwise. GET /health is the health check path.

Configuration variables, set in the cabotage UI:

  • GH_CLIENT_ID, GH_CLIENT_SECRET: the GitHub OAuth App credentials.
  • GH_APP_ID, GH_PRIVATE_KEY: the GitHub App ID and private key.
  • APP_URL: the public hostname, without scheme. Must match the OAuth App callback URL.
  • SENTRY_DSN: where errors are reported.

Requirements and dependencies

  • Python 3.14+
  • aiohttp
  • aiohttp-jinja2
  • gidgethub >= 5.0.0
  • pyjwt >= 2.0.0
  • cryptography

Running tests

  1. Create a Python virtual environment with $ python3 -m venv venv
  2. Activate the virtual environment with $ . venv/bin/activate
  3. Install dev requirements with (venv)$ pip install -r dev-requirements.txt
  4. Run all tests with (venv)$ pytest tests

About

`blurb add` over the internet

Resources

Code of conduct

Security policy

Stars

33 stars

Watchers

29 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages