Repository navigation
Allow user to manually specify the next version number #1192
Description
Feature Request
Description
It may be useful for some use-cases to allow the user to manually specify the next version number.
Use cases
One such use-case would be the "Epoch SemVer" idea, where the MAJOR version behaves slightly differently in the case of a "notorious" update, increasing by 100 instead of by 1, for example.
Another use-case would be when the repo is in a broken state, and PSR can't figure out what to do. Being able to override the next version entirely would allow the user to get out of these broken states more easily. This would have helped me in #1188, for example.
Possible implementation
semantic-release version --force 1.2.3 to force the next version to be v1.2.3.
This would then check if the provided version isn't lower than the current one, and if valid, bump straight to it.
Alternative solutions
There are flags to force bumps to MINOR, MAJOR, or PATCH, but these will only increase the specified portion by 1, which isn't suitable for all use-cases.
The user could also manually work with Git and such to try to craft a scenario where semantic-release version will have the desired result, but it'd be error-prone and tricky to do.
Another option would be to manually perform all the automated steps PSR would take, but this is once again error-prone and tricky.
Activity
github-actions commentedon Apr 19, 2025
It has been 60 days since the last update on this confirmed issue. @python-semantic-release/team can you provide an update on the status of this issue?
codejedi365 commentedon Apr 19, 2025
Still in backlog
github-actions commentedon Jun 19, 2025
It has been 60 days since the last update on this confirmed issue. @python-semantic-release/team can you provide an update on the status of this issue?
codejedi365 commentedon Jun 20, 2025
No update yet, still in backlog.
github-actions commentedon Sep 19, 2025
It has been 90 days since the last update on this confirmed issue. @python-semantic-release/team can you provide an update on the status of this issue?
codejedi365 commentedon Sep 23, 2025
Still in backlog
github-actions commentedon Dec 23, 2025
It has been 90 days since the last update on this confirmed issue. @python-semantic-release/team can you provide an update on the status of this issue?