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: Addconventional-monorepo as validcommit_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: Updatecommit_parser option with newconventional-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 isconventional-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 theMonorepo 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

2025-08-05 WARNING: GitHub Action broke if Action is run in a non-release mode (e.g.--no-commit, or--noop), see#1307 - Resolved in v10.3.1

v10.3.0 (2025-08-04)

This release is published under the MIT License.

✨ Features

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

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

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

• github-actions: Add releaselink 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: Fixeschangelog.exclude_commit_patterns example in startup guide (PR#1292,2ce2e94)

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

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

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

• github-actions: Add description of releaselink 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'sexclude_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: AddsPACKAGE_NAME value into build command environment (db9bc13)

📖 Documentation

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

• uv-integration: Fix configuration guide foruv 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

v10.1.0 (2025-06-12)

This release is published under the MIT License.

✨ Features

• cmd-version: Always stage version stamped files & changelog even with--no-commit (PR#1214,de62334)

📖 Documentation

• cmd-version: Improve command description & include common uses (PR#1214,de62334)

• configuration-guide: Add how-to guide foruv integration (PR#1214,de62334)

• github-actions: Clarify with examples of theroot_options v10 migration change (PR#1271,fbb63ec)

⚙️ Build System

• deps: Expandpython-gitlab dependency to includev6.0.0 (PR#1273,99fc9cc)

✅ Resolved Issues

• #1211:Version files left unstaged for commit in 2 stage PSR execution

Detailed Changes:v10.0.2...v10.1.0

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.0.2 (2025-05-26)

This release is published under the MIT License.

🪲 Bug Fixes

• github-actions: Add filesystem UID/GID fixer after action workspace modification (PR#1262,93e23c8)

Detailed Changes:v10.0.1...v10.0.2

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.0.1 (2025-05-25)

This release is published under the MIT License.

🪲 Bug Fixes

• github-actions: Bump the github-actions dependency tov10.0.0 (PR#1255,2803676)

✅ Resolved Issues

• #1257:bug: github action v10.0.0 is still running PSR v9.21.1

Detailed Changes:v10.0.0...v10.0.1

Installable artifacts are available from:

• PyPi Registry

• GitHub Release Assets

v10.0.0 (2025-05-25)

This release is published under the MIT License.

✨ Features

• cmd-version: Enableversion_variables version stamp of vars with double-equals (PR#1244,080e4bc)

• parser-conventional: Set parser to evaluate all squashed commits by default (6fcdc99)

• parser-conventional: Set parser to ignore merge commits by default (59bf084)

• parser-emoji: Set parser to evaluate all squashed commits by default (514a922)

• parser-emoji: Set parser to ignore merge commits by default (8a51525)

• parser-scipy: Set parser to evaluate all squashed commits by default (634fffe)

• parser-scipy: Set parser to ignore merge commits by default (d4f128e)

🪲 Bug Fixes

• changelog-md: Change to 1-line descriptions in markdown template (e7ac155)

• changelog-rst: Change to 1-line descriptions in the default ReStructuredText template (731466f)

• cli: Adjust verbosity parameter to enable silly-level logging (bd3e7bf)

• github-action: Resolve command injection vulnerability in action script (fb3da27)

• parser-conventional: Remove breaking change footer messages from commit descriptions (b271cbb)

• parser-conventional: Remove issue footer messages from commit descriptions (b1bb0e5)

• parser-conventional: Remove PR/MR references from commit subject line (eed63fa)

• parser-conventional: Remove release notice footer messages from commit descriptions (7e8dc13)

• parser-emoji: Remove issue footer messages from commit descriptions (b757603)

• parser-emoji: Remove PR/MR references from commit subject line (16465f1)

• parser-emoji: Remove release notice footer messages from commit descriptions (b6307cb)

• parser-scipy: Remove issue footer messages from commit descriptions (3cfee76)

• parser-scipy: Remove PR/MR references from commit subject line (da4140f)

• parser-scipy: Remove release notice footer messages from commit descriptions (58308e3)

📖 Documentation

• Refactor documentation page navigation (4e52f4b)

• algorithm: Remove out-of-date algorithm description (6cd0fbe)

• commit-parsing: Define limitation of revert commits with the scipy parser (5310d0c)

• configuration: Change default value forallow_zero_version in the description (203d29d)

• configuration: Change the default for the base changelog'smask_initial_release value (5fb02ab)

• configuration: Change the default value forchangelog.mode in the setting description (0bed906)

• configuration: Updateversion_variables section to include double-equals operand support (PR#1244,080e4bc)

• contributing: Refactor contributing & contributors layout (8bed5bc)

• github-actions: Add reference to manual release workflow example (6aad7f1)

• github-actions: Change recommended workflow to separate release from deploy (67b2ae0)

• github-actions: Updatepython-semantic-release/publish-action parameter notes (c4d45ec)

• github-actions: Update PSR action parameter documentation (a082896)

• upgrading: Re-locate version upgrade guides intoUpgrading PSR (a5f5e04)

• upgrading-v10: Added migration guide for v9 to v10 (4ea92ec)

⚙️ Build System

• deps: Prevent update toclick@8.2.0 (PR#1245,4aa6a6e)

♻️ Refactoring

• config: Changeallow_zero_version default tofalse (c6b6eab)

• config: Changechangelog.default_templates.mask_initial_release default totrue (0e114c3)

• config: Changechangelog.mode default toupdate (7d39e76)

💥 Breaking Changes

For a summarized walkthrough, check out ourv10 migration guide as well.

• changelog-md: The default Markdown changelog template and release notes template will no longer print out the entire commit message contents, instead, it will only print the commit subject line. This comes to meet the high demand of better formatted changelogs and requests for subject line only. Originally, it was a decision to not hide commit subjects that were included in the commit body via thegit merge --squash command and PSR did not have another alternative. At this point, all the built-in parsers have the ability to parse squashed commits and separate them out into their own entry on the changelog. Therefore, the default template no longer needs to write out the full commit body. See the commit parser options if you want to enable/disable parsing squash commits.

• changelog-rst: The default ReStructured changelog template will no longer print out the entire commit message contents, instead, it will only print the commit subject line. This comes to meet the high demand of better formatted changelogs and requests for subject line only. Originally, it was a decision to not hide commit subjects that were included in the commit body via thegit merge --squash command and PSR did not have another alternati...