v10.7.0 (2026-09-22)

This release is published under the MIT License.

✨ Features

• cmd-stamp: Expand version stamp mechanism to support typed python variables (PR#1485, 947c57b)

• cmd-version: Add optional git --signoff to version commits (PR#1492, 3cecbeb)

📖 Documentation

• configuration: Added signoff_commit setting definition (PR#1492, 3cecbeb)

• configuration: Document Python type annotation support for version_variables (PR#1485, 947c57b)

⚙️ Build System

• deps: Correct click range specification for python3.10+ (PR#1486, e4b3bad)

• deps: Expand click dependency range to include v8.5.* (PR#1489, fa87c95)

💡 Additional Release Information

• cmd-version: With this release, we added a boolean flag, semantic_release.signoff_commit, as an available configuration option to toggle the addition of the Signed-off-by git trailer/footer message to release commits made by Python Semantic Release. Default is currently set to False but if you want to try this option, set this configuration setting to True. In a future major release, this setting will be set to True by default.

✅ Resolved Issues

• #1441: feat: add option to signoff commits made by python-semantic-release

• #1443: feat: extend version_variables to replace vars with python type annotations

Detailed Changes: v10.6.2...v10.7.0

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.6.2 (2026-08-28)

This release is published under the MIT License.

🪲 Bug Fixes

• cmd-changelog: Fix reading of TOML when file was created on Windows (9a56ace)

• config: Validate commit author in config internally (PR#1477, 10afa8e)

⚙️ Build System

• deps: Adjust importlib use to maintain 3.8 support (59fea4f)

• deps: Bump rich requirement from v14.0+ to v15.0+ (PR#1464, abd942d)

• deps: Bump tomlkit requirement to ~=0.15.0 (PR#1463, 429588d)

✅ Resolved Issues

• #1476: Bug: GitPython v3.1.60 removed Actor.name_email_regex, breaking every config load

Detailed Changes: v10.6.1...v10.6.2

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.6.1 (2026-07-06)

This release is published under the MIT License.

🪲 Bug Fixes

• changelog: Fix handling of whitespace commit bodies in changelog template filter (PR#1457, d95e46e)

• cmd-version: Fix non-styled error msg when strict & no new version (PR#1437, 5e8f94c)

• config: Eliminate .git/ in parent dir warnings for monorepos configured with .. (PR#1444, 7a1f822)

📖 Documentation

• CHANGELOG: Add v9.21.2 changelog details for website (a4115cf)

• configuration: Document repo_dir config option (PR#1444, 7a1f822)

⚙️ Build System

• deps: Expand python-gitlab dependency range to include v8.0.0+ (PR#1451, a4b9a43)

• deps: Expand tomlkit dependency range to include v0.14.0+ & v0.15.0+ (028d539)

• deps: Extend click dependency range to include v8.2+ (01707ea)

✅ Resolved Issues

• #1418: Extrenous "Found .git/ in higher parent directory" warning in monorepo setup

• #1423: Misformated error message

Detailed Changes: v10.6.0...v10.6.1

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.6.0 (2026-07-04)

This release is published under the MIT License.

✨ Features

• cmd-version: Add file replacement variant for version_variables (PR#1391, 95ce7ec)

• parser-emoji: Adds more non-release triggering emojis to the default emoji parser (PR#1410, 2833aa9)

🪲 Bug Fixes

• cmd-config-generate: Fix config output for Microsoft Windows UTF-8 encoding (PR#1400, 0343194)

• cmd-publish: Fix handling of asset uploading errors on publish (PR#1397, 81a0f98)

• github: Fix bubble up errors of asset uploads for GitHub (PR#1397, 81a0f98)

• hvcs: Mask git credential URL in very verbose debug logs (PR#1445, 811afb0)

📖 Documentation

• cmd-config-generate: Add Windows PowerShell specific generate-config usage example (PR#1400, 0343194)

• configuration: Modify version_variables definition to include new file replacement (PR#1391, 95ce7ec)

• examples: Update references to github actions for hash references (PR#1449, 873da58)

• package: Change package changelog link to doc website (PR#1434, 05f897f)

✅ Resolved Issues

• #702: semantic-release generate-config --pyproject produces unreadable toml on Windows

• #1375: Allow updates to version file containing only a version

• #1395: [bug] Silently ignores auth error on GitHub publish

• #1426: Git credentials are logged with very verbose (-vv) logging

Detailed Changes: v10.5.3...v10.6.0

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v9.21.2 (2026-07-04)

This release is published under the MIT License.

🪲 Bug Fixes

• hvcs: Mask credentials in git URL debug logs (PR#1450, da0cb2b)

📖 Documentation

• github-actions: Fix recommended upstream detection script's upstream name parsing (911f62a)

⚙️ Build System

• Mark for Python 3.14 compatibility (86c0439)

• deps: Bump tomlkit dependency from ~=0.11.0 to ~=0.13.0 (5395d06)

• deps: Prevent update to click@8.2.0 (128f06a)

✅ Resolved Issues

• #1426: GitHub credentials are logged with -vv verbose logging

Detailed Changes: v9.21.1...v9.21.2

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.5.3 (2025-12-14)

This release is published under the MIT License.

🪲 Bug Fixes

• cmd-version: Resolve unauthenticated git repo issues for upstream verification (PR#1388, e164f68)

• github-action: Fix failed signing issue when ssh was missing from action environment (PR#1389, 18b7eda)

• parser-conventional-monorepo: Fix parser opts validator for outside dir path matches (PR#1382, a51eadd)

✅ Resolved Issues

• #1373: verify_upstream_unchanged fails on github actions when git repo is unauthenticated

• #1376: ssh-agent & ssh-add is missing from python-semantic-release github action

• #1380: Monorepo path_filters fails to reference paths outside the current package subtree

Detailed Changes: v10.5.2...v10.5.3

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.5.2 (2025-11-10)

This release is published under the MIT License.

🪲 Bug Fixes

• cmd-version: Toggle verify upstream off when no version commit is made (PR#1370, e0b3b70)

Detailed Changes: v10.5.1...v10.5.2

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.5.1 (2025-11-10)

This release is published under the MIT License.

🪲 Bug Fixes

• cmd-version: Fix upstream change detection to succeed without branch tracking (PR#1369, 7086257)

Detailed Changes: v10.5.0...v10.5.1

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.5.0 (2025-11-09)

This release is published under the MIT License.

✨ Features

• cmd-version: Add automatic repository un-shallowing to version workflow (PR#1366, 90a1ffa)

• cmd-version: Add functionality to create & update partial version tags (PR#1115, a28f940)

• cmd-version: Adds c-macro style version definition support to version_variables (PR#1349, 4ce1fca)

• cmd-version: Adds upstream check into workflow to prevent commit push collisions (PR#1360, d77193e)

🪲 Bug Fixes

• cmd-version: Prevent regular expression errors on tag_format (PR#1367, e7d7aa7)

📖 Documentation

• commands: Add description of automated upstream version checking upon version creation (PR#1360, d77193e)

• configuration: Add description for add_partial_tags setting & usage examples (PR#1115, a28f940)

• configuration: Fix tag_format definition (PR#1367, e7d7aa7)

• configuration: Update version_variables examples with a c-macro style replacement (PR#1349, 4ce1fca)

• github-actions: Adds release job outputs definition to example (PR#1344, 0fb4875)

• github-actions: Removed verify upstream status step from example workflow (PR#1360, d77193e)

• github-actions: Update example to remove need to specify repo checkout's fetch depth (PR#1366, 90a1ffa)

• uv-integration: Remove verify upstream check from uv integration example (PR#1360, d77193e)

• uv-integration: Update example to remove need to specify repo checkout's fetch depth (PR#1366, 90a1ffa)

⚙️ Build System

• deps: Bump tomlkit dependency from ~=0.11.0 to ~=0.13.0 (PR#1355, 55c94ec)

• deps: Change github-actions container image to python:3.14-slim-trixie (PR#1346, 1a23712)

💡 Additional Release Information

• cmd-version: If you were previously handling the unshallowing of a repository clone in your CI/CD pipelines, you may now remove that step from your workflow. PSR will now detect a shallow repository and unshallow it before evaluating the commit history.

✅ Resolved Issues

• #1348: How can I update a C header file with the version?

Detailed Changes: v10.4.1...v10.5.0

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.4.1 (2025-09-13)

This release is published under the MIT License.

🪲 Bug Fixes

• cmd-version: Fix error where --no-tag is not respected (PR#1329, b090fa2)

📖 Documentation

• CHANGELOG: Update hyperlink in v10.4.0's additional info paragraph (PR#1323, 98ef722)

• getting-started-guide: Remove notice about lack of monorepo support (PR#1327, 3f21f3f)

• github-actions: Fix recommended upstream detection script's upstream name parsing (PR#1328, ccc91c0)

✅ Resolved Issues

• #1304: Bug: --no-tag is not working as expected with version command

• #1326: Monorepo support warning on Getting Started page no longer required

Detailed Changes: v10.4.0...v10.4.1

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets