python · AA-Turner · Aug 13, 2025 · Aug 13, 2025
diff --git a/.ruff.toml b/.ruff.toml
@@ -0,0 +1,15 @@
+target-version = "py39"
+
+[format]
+preview = true
+quote-style = "single"
+docstring-code-format = true
+
+[lint]
+preview = true
+select = [
+    "I",     # isort
+]
+ignore = [
+    "E501",  # Ignore line length errors (we use auto-formatting)
+]
diff --git a/src/blurb/__main__.py b/src/blurb/__main__.py
@@ -1,6 +1,6 @@
 """Run blurb using ``python3 -m blurb``."""
-from blurb._cli import main
 
+from blurb._cli import main
 
 if __name__ == '__main__':
     main()
diff --git a/src/blurb/_add.py b/src/blurb/_add.py
@@ -9,7 +9,7 @@
 import tempfile
 
 from blurb._blurb_file import BlurbError, Blurbs
-from blurb._cli import subcommand,error,prompt
+from blurb._cli import error, prompt, subcommand
 from blurb._git import flush_git_add_files, git_add_files
 from blurb._template import sections, template
 
@@ -43,11 +43,11 @@ def add(*, issue: str | None = None, section: str | None = None):
     spaces in names can be substituted for underscores:
 
 {sections}
-    """
+    """  # fmt: skip
 
     handle, tmp_path = tempfile.mkstemp('.rst')
     os.close(handle)
-    atexit.register(lambda : os.unlink(tmp_path))
+    atexit.register(lambda: os.unlink(tmp_path))
 
     text = _blurb_template_text(issue=issue, section=section)
     with open(tmp_path, 'w', encoding='utf-8') as file:
@@ -72,6 +72,8 @@ def add(*, issue: str | None = None, section: str | None = None):
     git_add_files.append(path)
     flush_git_add_files()
     print('Ready for commit.')
+
+
 add.__doc__ = add.__doc__.format(sections='\n'.join(f'* {s}' for s in sections))
 
 
@@ -178,13 +180,13 @@ def _extract_section_name(section: str | None, /) -> str | None:
 
     if not matches:
         section_list = '\n'.join(f'* {s}' for s in sections)
-        raise SystemExit(f'Invalid section name: {section!r}\n\n'
-                         f'Valid names are:\n\n{section_list}')
+        raise SystemExit(
+            f'Invalid section name: {section!r}\n\nValid names are:\n\n{section_list}'
+        )
 
     if len(matches) > 1:
         multiple_matches = ', '.join(f'* {m}' for m in sorted(matches))
-        raise SystemExit(f'More than one match for {section!r}:\n\n'
-                         f'{multiple_matches}')
+        raise SystemExit(f'More than one match for {section!r}:\n\n{multiple_matches}')
 
     return matches[0]
 

diff --git a/src/blurb/_blurb_file.py b/src/blurb/_blurb_file.py
@@ -95,8 +95,13 @@ class BlurbError(RuntimeError):
 
 
 class Blurbs(list):
-    def parse(self, text: str, *, metadata: dict[str, str] | None = None,
-              filename: str = 'input') -> None:
+    def parse(
+        self,
+        text: str,
+        *,
+        metadata: dict[str, str] | None = None,
+        filename: str = 'input',
+    ) -> None:
         """Parses a string.
 
         Appends a list of blurb ENTRIES to self, as tuples: (metadata, body)
@@ -147,13 +152,17 @@ def finish_entry() -> None:
                         throw(f'Invalid {issue_keys[key]} number: {value!r}')
 
                 if key == 'gh-issue' and int(value) < lowest_possible_gh_issue_number:
-                    throw(f'Invalid gh-issue number: {value!r} (must be >= {lowest_possible_gh_issue_number})')
+                    throw(
+                        f'Invalid gh-issue number: {value!r} (must be >= {lowest_possible_gh_issue_number})'
+                    )
 
                 if key == 'section':
                     if no_changes:
                         continue
                     if value not in sections:
-                        throw(f'Invalid section {value!r}!  You must use one of the predefined sections.')
+                        throw(
+                            f'Invalid section {value!r}!  You must use one of the predefined sections.'
+                        )
 
             if 'gh-issue' not in metadata and 'bpo' not in metadata:
                 throw("'gh-issue:' or 'bpo:' must be specified in the metadata!")
@@ -232,7 +241,9 @@ def _parse_next_filename(filename: str) -> dict[str, str]:
         assert section in sections, f'Unknown section {section}'
 
         fields = [x.strip() for x in filename.split('.')]
-        assert len(fields) >= 4, f"Can't parse 'next' filename! filename {filename!r} fields {fields}"
+        assert len(fields) >= 4, (
+            f"Can't parse 'next' filename! filename {filename!r} fields {fields}"
+        )
         assert fields[-1] == 'rst'
 
         metadata = {'date': fields[0], 'nonce': fields[-2], 'section': section}
@@ -263,7 +274,7 @@ def ensure_metadata(self) -> None:
             ('bpo', '0'),
             ('date', sortable_datetime()),
             ('nonce', generate_nonce(body)),
-            ):
+        ):
             if name not in metadata:
                 metadata[name] = default
 
@@ -274,10 +285,14 @@ def _extract_next_filename(self) -> str:
         metadata['section'] = sanitize_section(metadata['section'])
         metadata['root'] = root
         if int(metadata['gh-issue']) > 0:
-            path = '{root}/Misc/NEWS.d/next/{section}/{date}.gh-issue-{gh-issue}.{nonce}.rst'.format_map(metadata)
+            path = '{root}/Misc/NEWS.d/next/{section}/{date}.gh-issue-{gh-issue}.{nonce}.rst'.format_map(
+                metadata
+            )
         elif int(metadata['bpo']) > 0:
             # assume it's a GH issue number
-            path = '{root}/Misc/NEWS.d/next/{section}/{date}.bpo-{bpo}.{nonce}.rst'.format_map(metadata)
+            path = '{root}/Misc/NEWS.d/next/{section}/{date}.bpo-{bpo}.{nonce}.rst'.format_map(
+                metadata
+            )
         for name in ('root', 'section', 'date', 'gh-issue', 'bpo', 'nonce'):
             del metadata[name]
         return path
@@ -294,4 +309,4 @@ def save_next(self) -> str:
 
 
 def sortable_datetime() -> str:
-    return time.strftime("%Y-%m-%d-%H-%M-%S", time.localtime())
+    return time.strftime('%Y-%m-%d-%H-%M-%S', time.localtime())
diff --git a/src/blurb/_cli.py b/src/blurb/_cli.py
@@ -28,7 +28,7 @@ def prompt(prompt: str, /) -> str:
 
 
 def require_ok(prompt: str, /) -> str:
-    prompt = f"[{prompt}> "
+    prompt = f'[{prompt}> '
     while True:
         s = input(prompt).strip()
         if s == 'ok':
@@ -88,7 +88,7 @@ def help(subcommand: str | None = None) -> None:
                 options.append(f' [-{short_option}|--{name} {metavar}]')
         elif p.kind == inspect.Parameter.POSITIONAL_OR_KEYWORD:
             positionals.append(' ')
-            has_default = (p.default != inspect._empty)
+            has_default = p.default != inspect._empty
             if has_default:
                 positionals.append('[')
                 nesting += 1
@@ -146,7 +146,6 @@ def _blurb_help() -> None:
 
 
 def main() -> None:
-
     args = sys.argv[1:]
 
     if not args:
@@ -165,6 +164,7 @@ def main() -> None:
         raise SystemExit(fn(*args))
 
     import blurb._merge
+
     blurb._merge.original_dir = os.getcwd()
     try:
         chdir_to_repo_root()
@@ -177,8 +177,7 @@ def main() -> None:
         kwargs = {}
         for name, p in inspect.signature(fn).parameters.items():
             if p.kind == inspect.Parameter.KEYWORD_ONLY:
-                if (p.default is not None
-                        and not isinstance(p.default, (bool, str))):
+                if p.default is not None and not isinstance(p.default, (bool, str)):
                     raise SystemExit(
                         'blurb command-line processing cannot handle '
                         f'options of type {type(p.default).__qualname__}'
@@ -262,7 +261,9 @@ def handle_option(s, dict):
             if total != 1:
                 middle += 's'
 
-        print(f'Error: Wrong number of arguments!\n\nblurb {subcommand} {middle},\nand you specified {how_many}.')
+        print(
+            f'Error: Wrong number of arguments!\n\nblurb {subcommand} {middle},\nand you specified {how_many}.'
+        )
         print()
         print('usage: ', end='')
         help(subcommand)
@@ -293,11 +294,13 @@ def test_first_line(filename, test):
                     return False
             return True
 
-        if not (test_first_line('README', readme_re)
-            or test_first_line('README.rst', readme_re)):
+        if not (
+            test_first_line('README', readme_re)
+            or test_first_line('README.rst', readme_re)
+        ):
             continue
 
-        if not test_first_line('LICENSE',  'A. HISTORY OF THE SOFTWARE'.__eq__):
+        if not test_first_line('LICENSE', 'A. HISTORY OF THE SOFTWARE'.__eq__):
             continue
         if not os.path.exists('Include/Python.h'):
             continue
@@ -307,5 +310,6 @@ def test_first_line(filename, test):
         break
 
     import blurb._blurb_file
+
     blurb._blurb_file.root = path
     return path
diff --git a/src/blurb/_merge.py b/src/blurb/_merge.py
@@ -43,12 +43,14 @@ def write_news(output: str, *, versions: list[str]) -> None:
     def prnt(msg: str = '', /):
         buff.append(msg)
 
-    prnt("""
+    prnt(
+        """
 +++++++++++
 Python News
 +++++++++++
 
-""".strip())
+""".strip()
+    )
 
     for version in versions:
         filenames = glob_blurbs(version)

diff --git a/src/blurb/_populate.py b/src/blurb/_populate.py
@@ -1,7 +1,7 @@
 import os
 
 from blurb._cli import subcommand
-from blurb._git import git_add_files, flush_git_add_files
+from blurb._git import flush_git_add_files, git_add_files
 from blurb._template import sanitize_section, sections
 
 
@@ -17,7 +17,9 @@ def populate() -> None:
         os.makedirs(dir_path, exist_ok=True)
         readme_path = f'NEWS.d/next/{dir_name}/README.rst'
         with open(readme_path, 'w', encoding='utf-8') as readme:
-            readme.write(f'Put news entry ``blurb`` files for the *{section}* section in this directory.\n')
+            readme.write(
+                f'Put news entry ``blurb`` files for the *{section}* section in this directory.\n'
+            )
         git_add_files.append(dir_path)
         git_add_files.append(readme_path)
     flush_git_add_files()
diff --git a/src/blurb/_release.py b/src/blurb/_release.py
@@ -6,8 +6,12 @@
 import blurb._blurb_file
 from blurb._blurb_file import Blurbs
 from blurb._cli import error, subcommand
-from blurb._git import (flush_git_add_files, flush_git_rm_files,
-                        git_rm_files, git_add_files)
+from blurb._git import (
+    flush_git_add_files,
+    flush_git_rm_files,
+    git_add_files,
+    git_rm_files,
+)
 from blurb._utils.globs import glob_blurbs
 from blurb._utils.text import generate_nonce
 
@@ -25,7 +29,9 @@ def release(version: str) -> None:
 
     existing_filenames = glob_blurbs(version)
     if existing_filenames:
-        error("Sorry, can't handle appending 'next' files to an existing version (yet).")
+        error(
+            "Sorry, can't handle appending 'next' files to an existing version (yet)."
+        )
 
     output = f'Misc/NEWS.d/{version}.rst'
     filenames = glob_blurbs('next')
@@ -35,7 +41,13 @@ def release(version: str) -> None:
     if not filenames:
         print(f'No blurbs found.  Setting {version} as having no changes.')
         body = f'There were no new changes in version {version}.\n'
-        metadata = {'no changes': 'True', 'gh-issue': '0', 'section': 'Library', 'date': date, 'nonce': generate_nonce(body)}
+        metadata = {
+            'no changes': 'True',
+            'gh-issue': '0',
+            'section': 'Library',
+            'date': date,
+            'nonce': generate_nonce(body),
+        }
         blurbs.append((metadata, body))
     else:
         count = len(filenames)

diff --git a/src/blurb/_template.py b/src/blurb/_template.py
@@ -52,7 +52,7 @@
     'C_API': 'C API',
     'Core_and_Builtins': 'Core and Builtins',
     'Tools-Demos': 'Tools/Demos',
-    }
+}
 
 
 def sanitize_section(section: str, /) -> str:

diff --git a/src/blurb/_utils/globs.py b/src/blurb/_utils/globs.py
@@ -2,8 +2,10 @@
 import os
 
 from blurb._template import (
-    next_filename_unsanitize_sections, sanitize_section,
-    sanitize_section_legacy, sections,
+    next_filename_unsanitize_sections,
+    sanitize_section,
+    sanitize_section_legacy,
+    sections,
 )
 
 

diff --git a/src/blurb/_utils/text.py b/src/blurb/_utils/text.py
@@ -48,7 +48,7 @@ def textwrap_body(body: str | Iterable[str], *, subsequent_indent: str = '') ->
                 indents = itertools.chain(
                     itertools.repeat(initial, 1),
                     itertools.repeat(subsequent),
-                    )
+                )
                 lines = [indent + line for indent, line in zip(indents, lines)]
                 paragraph = '\n'.join(lines)
             paragraphs2.append(paragraph)
@@ -88,8 +88,12 @@ def textwrap_body(body: str | Iterable[str], *, subsequent_indent: str = '') ->
             # twice, so it's stable, and this means occasionally it'll
             # convert two spaces to one space, no big deal.
 
-            paragraph = '\n'.join(textwrap.wrap(paragraph.strip(), width=76, **kwargs)).rstrip()
-            paragraph = '\n'.join(textwrap.wrap(paragraph.strip(), width=76, **kwargs)).rstrip()
+            paragraph = '\n'.join(
+                textwrap.wrap(paragraph.strip(), width=76, **kwargs)
+            ).rstrip()
+            paragraph = '\n'.join(
+                textwrap.wrap(paragraph.strip(), width=76, **kwargs)
+            ).rstrip()
             paragraphs2.append(paragraph)
         # don't reflow literal code blocks (I hope)
         dont_reflow = paragraph.endswith('::')

diff --git a/src/blurb/blurb.py b/src/blurb/blurb.py
@@ -43,8 +43,8 @@
 
 
 def error(*a):
-    s = " ".join(str(x) for x in a)
-    sys.exit("Error: " + s)
+    s = ' '.join(str(x) for x in a)
+    sys.exit('Error: ' + s)
 
 
 if __name__ == '__main__':