Allow the GH issue + Section as --flags and take news via stdin

.gitignore

@@ -93,3 +93,9 @@ ENV/
 
 # hatch-vcs
 src/*/_version.py
+
+*.bak
+*.swp
+
+CLAUDE.local.md
+.claude/*

.pre-commit-config.yaml

@@ -1,6 +1,12 @@
 repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.3
+    hooks:
+      - id: ruff-check
+        args: [--exit-non-zero-on-fix]
+
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-added-large-files
       - id: check-case-conflict

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.1.0 (unreleased)
+
+* Add automation support to `blurb add` command:
+  * New `--issue` option to specify GitHub issue number (supports URLs and various formats)
+  * New `--section` option to specify NEWS section (with smart case-insensitive matching)
+  * New `--rst-on-stdin` option to read entry content from stdin
+  * Useful for CI systems and automated tools
+* Uses `cyclopts` for command-line parsing instead of rolling our own to reduce our code size, this changes the help format and brings in a dependency.
+
 ## 2.0.0
 
 * Move 'blurb test' subcommand into test suite by @hugovk in https://github.com/python/blurb/pull/37

README.md

@@ -77,6 +77,30 @@ It opens a text editor on a template; you edit the
 file, save, and exit.  **blurb** then stores the file
 in the correct place, and stages it in Git for you.
 
+#### Automation support
+
+For automated tools and CI systems, `blurb add` supports non-interactive operation:
+
+```bash
+# Add a blurb entry from stdin
+echo 'Added beans to the :mod:`spam` module.' | blurb add \
+    --issue 123456 \
+    --section Library \
+    --rst-on-stdin
+```
+
+When using `--rst-on-stdin`, both `--issue` and `--section` are required.
+
+The `--issue` parameter accepts various formats:
+- Issue number: `--issue 12345`
+- With gh- prefix: `--issue gh-12345`
+- GitHub URL: `--issue https://github.com/python/cpython/issues/12345`
+
+The `--section` parameter supports smart matching:
+- Case insensitive: `--section library` or `--section LIBRARY`
+- Partial matching: `--section lib` (matches "Library")
+- Common aliases: `--section api` (matches "C API"), `--section builtin` (matches "Core and Builtins")
+
 The template for the `blurb add` message looks like this:
 
     #

pyproject.toml

@@ -30,6 +30,9 @@ classifiers = [
 dynamic = [
   "version",
 ]
+dependencies = [
+  "cyclopts>=3",
+]
 optional-dependencies.tests = [
   "pyfakefs",
   "pytest",

src/blurb/__init__.py

@@ -1 +1 @@
-from ._version import __version__
+from ._version import __version__ as __version__