blurb

library2.0.0pypypi✓ verified 80d ago

A command-line tool to manage CPython's Misc/NEWS.d entries. It helps CPython core developers and contributors create, list, merge, and render news blobs. The current version is 2.0.0, released in 2024. Release cadence is irregular, roughly once a year.

devops

pip install blurb

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · BLURB

blurb

devopspythonv2.0.0

Install

1.6s avg

Import

—

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 17.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.000s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Blurb

✓ import blurb

✗ from blurb import Blurb

Create a new CPython news entry using blurb

import os from blurb import Blurb # Create a new news entry b = Blurb() b.title = "My change" b.type = "feature" # or 'bugfix', 'doc', etc. b.body = "Description of the change." b.issue = "12345" # GitHub issue number (>=32426 for CPython) filepath = b.write() print(f"Created {filepath}")

blurb --version

Debug

Known issues

breakingIn v2.0.0, the `blurb test` subcommand was moved into the test suite; it is no longer available as a CLI command.

fix

Run tests via `python -m pytest` or `tox` instead of `blurb test`.

affects: >=2.0.0

deprecatedThe `gh-issue-NNNN:` prefix is deprecated; use `gh-NNNN:` (without the extra 'issue-') since v1.2.0.

fix

Use `gh-{number}:` format in blurb entries.

affects: >=1.2.0

gotchaGitHub issue numbers must be >= 32426 for CPython; lower numbers are rejected.

fix

Ensure the issue number is a well-known CPython issue. For own projects, this validation may not apply.

affects: >=1.2.0

Upgrade

Version history

2.0.0latest on PyPI · released Jan 15, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/python/blurb ↗

packagehttps://pypi.org/project/blurb/ ↗

changeloghttps://github.com/python/blurb/blob/main/CHANGELOG.md ↗