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

v10.4.0 (2025-09-08)

This release is published under the MIT License.

✨ Features

• config: Add conventional-monorepo as valid commit_parser type (PR#1143, e18f866)

• parser: Add new conventional-commits standard parser for monorepos (PR#1143, e18f866)

📖 Documentation

• Add configuration guide for monorepo use with PSR (PR#1143, e18f866)

• commit-parsers: Introduce conventional commit monorepo parser options & features (PR#1143, e18f866)

• configuration: Update commit_parser option with new conventional-monorepo value (PR#1143, e18f866)

💡 Additional Release Information

• config: This release introduces a new built-in parser type that can be utilized for monorepo projects. The type value is conventional-monorepo and when specified it will apply the conventional commit parser to a monorepo environment. This parser has specialized options to help handle monorepo projects as well. For more information, please refer to the Monorepo Docs.

✅ Resolved Issues

• #614: feat: Commit parser w/ path filter for monorepos

Detailed Changes: v10.3.2...v10.4.0

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.3.2 (2025-09-06)

This release is published under the MIT License.

🪲 Bug Fixes

• cmd-version: Prevent errors when PSR is executed in non-GitHub CI environments (PR#1322, 4df4be4)

⚡ Performance Improvements

• cmd-version: Re-order operations for faster parsing in version determination (PR#1310, 63e435b)

📖 Documentation

• uv-integration: Add --no-changelog to build step to increase job speed (PR#1316, e1aece1)

💡 Additional Release Information

• cmd-version: Unfortunately, PSR introduced a bug in 10.3.0 when attempting to provide more CI outputs for GitHub Actions. It required our GitHub client interface to be loaded and even if it was not using GitHub CI to be run. This caused errors in Gitea and likely GitLab/Bitbucket environments. This change prevents that from happening but if any users pipelines were intentionally presenting the environment variable "GITHUB_OUTPUT" to enable action output to enable passing along internal outputs of PSR then their hack will no longer work after this change.

✅ Resolved Issues

• #1315: Bug: "Insecure connections are currently disabled" error in self hosted Gitea

Detailed Changes: v10.3.1...v10.3.2

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.3.1 (2025-08-06)

This release is published under the MIT License.

🪲 Bug Fixes

• github-actions: Refactor the action output error checking for non-release executions (PR#1308, 5385724)

📖 Documentation

• github-actions: Adjust docs for direct links to action example workflows (PR#1309, 8efebe2)

✅ Resolved Issues

• #1303: Improve GitHub Actions Docs

• #1307: v10.3.0 doesn't support a stage-then-release approach in GitHub Actions

Detailed Changes: v10.3.0...v10.3.1

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.3.0 (2025-08-04)

This release is published under the MIT License.

✨ Features

• github-actions: Add commit_sha as a GitHub Actions output value (PR#1289, 39b647b)

• github-actions: Add previous_version as a GitHub Actions output value (PR#1302, c0197b7)

• github-actions: Add release_notes as a GitHub Actions output value (PR#1300, a3fd23c)

• github-actions: Add release link as a GitHub Actions output value (PR#1301, 888aea1)

🪲 Bug Fixes

• github-actions: Fix variable output newlines (PR#1300, a3fd23c)

• util: Fixes no-op log output when commit message contains square-brackets (PR#1287, f25883f)

📖 Documentation

• getting-started: Fixes changelog.exclude_commit_patterns example in startup guide (PR#1292, 2ce2e94)

• github-actions: Add description of commit_sha GitHub Action output in docs (PR#1289, 39b647b)

• github-actions: Add description of previous_release GitHub Action output (PR#1302, c0197b7)

• github-actions: Add description of release_notes GitHub Action output (PR#1300, a3fd23c)

• github-actions: Add description of release link GitHub Action output (PR#1301, 888aea1)

• README: Update broken links to match re-located destinations (PR#1285, f4ec792)

✅ Resolved Issues

• #512: Add some additional GitHub Actions outputs

• #717: Add commit hash output to GitHub Action

• #1251: Bug: No-op mode fails to log any bracket-encased text in commit_message

• #1291: Typo in Getting Started Guide's exclude_commit_patterns example

Detailed Changes: v10.2.0...v10.3.0

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.2.0 (2025-06-29)

This release is published under the MIT License.

✨ Features

• cmd-version: Adds PACKAGE_NAME value into build command environment (db9bc13)

📖 Documentation

• configuration: Update build command environment definition to include PACKAGE_NAME variable (4aa3805)

• uv-integration: Fix configuration guide for uv usage to ensure lock file update (5390145)

✅ Resolved Issues

• #1280: UV integration documentation examples do not work as intended

Detailed Changes: v10.1.0...v10.2.0

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets