Python-semantic-release

Bug Fixes

- **changelog**: Ensures user rendered files are trimmed to end with a single newline
([1118](https://github.com/python-semantic-release/python-semantic-release/pull/1118),
[`6dfbbb0`](https://github.com/python-semantic-release/python-semantic-release/commit/6dfbbb0371aef6b125cbcbf89b80dc343ed97360))

- **cli**: Add error message of how to gather full error output
([1116](https://github.com/python-semantic-release/python-semantic-release/pull/1116),
[`ba85532`](https://github.com/python-semantic-release/python-semantic-release/commit/ba85532ddd6fcf1a2205f7ce0b88ea5be76cb621))

- **cmd-version**: Enable maintenance prereleases
([864](https://github.com/python-semantic-release/python-semantic-release/pull/864),
[`b88108e`](https://github.com/python-semantic-release/python-semantic-release/commit/b88108e189e1894e36ae4fdf8ad8a382b5c8c90a))

* test(fixtures): improve changelog generator to filter by max version

* test(fixtures): add repo fixture of a trunk only repo w/ dual version support

* test(fixtures): add repo fixture of a trunk only repo w/ dual version support & prereleases

* test(cmd-version): add rebuild repo tests for new dual version support repos

* test(version-determination): adjust unit tests of increment_version logic

This clarifies repeated function calls and pytest parameter names included the unclear assert diff.
Adds additional tests to check bad states for failures and refactored to match new function
signature.

* fix(version-bump): increment based on current commit's history only

Refactor duplicate logging messages and flow to process out odd cases in a fail fast methodology.
This removes the reliance on any last full release that is not within the history of the current
branch.

Resolves: 861

- **cmd-version**: Fix handling of multiple prerelease token variants & git flow merges
([1120](https://github.com/python-semantic-release/python-semantic-release/pull/1120),
[`8784b9a`](https://github.com/python-semantic-release/python-semantic-release/commit/8784b9ad4bc59384f855b5af8f1b8fb294397595))

* refactor: define a custom logging level of silly

* fix(version): remove some excessive log msgs from debug to silly level

* test(fixtures): refactor builder functions for version file updates

* test(fixtures): adjust build command to handle versions w/ build metadata

* test(fixtures): fix gitflow repo that included an invalid build metadata string

* test(fixtures): fix major_on_zero setting in repos to match expected behavior

* test(cmd-version): add test cases to run an example repo rebuild w/ psr

* test(cmd-version): enable git flow repo rebuild w/ psr test cases

* fix(cmd-version): handle multiple prerelease token variants properly

In the case where there are alpha and beta releases, we must only consider the previous beta release
even if alpha releases exist due to merging into beta release only branches which have no changes
considerable changes from alphas but must be marked otherwise.

Resolves: 789

* fix(cmd-version): fix version determination algorithm to capture commits across merged branches

* perf(cmd-version): refactor version determination algorithm for accuracy & speed

* test(algorithm): refactor test to match new function signature

* style(algorithm): drop unused functions & imports

* test(algorithm): adapt test case for new DFS commit traversal implementation

- **cmd-version**: Forces tag timestamp to be same time as release commit
([1117](https://github.com/python-semantic-release/python-semantic-release/pull/1117),
[`7898b11`](https://github.com/python-semantic-release/python-semantic-release/commit/7898b1185fc1ad10e96bf3f5e48d9473b45d2b51))

- **config**: Ensure default config loads on network mounted windows environments
([1124](https://github.com/python-semantic-release/python-semantic-release/pull/1124),
[`a64cbc9`](https://github.com/python-semantic-release/python-semantic-release/commit/a64cbc96c110e32f1ec5d1a7b61e950472491b87))

Resolves: 1123

* test(cmd-generate-config): added noop version execution to validate config at runtime

ref: 1123

Bug Fixes

- **changelog-md**: Fix commit sort of breaking descriptions section
([`75b342e`](https://github.com/python-semantic-release/python-semantic-release/commit/75b342e6259412cb82d8b7663e5ee4536d14f407))

- **parser-angular**: Ensure issues are sorted by numeric value rather than text sorted
([`3858add`](https://github.com/python-semantic-release/python-semantic-release/commit/3858add582fe758dc2ae967d0cd051d43418ecd0))

- **parser-emoji**: Ensure issues are sorted by numeric value rather than text sorted
([`7b8d2d9`](https://github.com/python-semantic-release/python-semantic-release/commit/7b8d2d92e135ab46d1be477073ccccc8c576f121))

Bug Fixes

- **cmd-version**: Ensure release utilizes a timezone aware datetime
([`ca817ed`](https://github.com/python-semantic-release/python-semantic-release/commit/ca817ed9024cf84b306a047675534cc36dc116b2))

- **default-changelog**: Alphabetically sort commit descriptions in version type sections
([`bdaaf5a`](https://github.com/python-semantic-release/python-semantic-release/commit/bdaaf5a460ca77edc40070ee799430122132dc45))

Features

- **commit-parser**: Enable parsers to flag commit to be ignored for changelog
([1108](https://github.com/python-semantic-release/python-semantic-release/pull/1108),
[`0cc668c`](https://github.com/python-semantic-release/python-semantic-release/commit/0cc668c36490401dff26bb2c3141f6120a2c47d0))

This adds an attribute to the ParsedCommit object that allows custom parsers to set to false if it
is desired to ignore the commit completely from entry into the changelog.

Resolves: 778

* test(parser-custom): add test w/ parser that toggles if a parsed commit is included in changelog

- **default-changelog**: Add a separate formatted breaking changes section
([1110](https://github.com/python-semantic-release/python-semantic-release/pull/1110),
[`4fde30e`](https://github.com/python-semantic-release/python-semantic-release/commit/4fde30e0936ecd186e448f1caf18d9ba377c55ad))

Resolves: 244

* test(fixtures): update repo changelog generator to add breaking descriptions

* test(default-changelog): add unit tests to demonstrate breaking change descriptions

* test(release-notes): add unit tests to demonstrate breaking change descriptions

* feat(changelog-md): add a breaking changes section to default Markdown template

* feat(changelog-rst): add a breaking changes section to default reStructuredText template

* feat(changelog-md): alphabetize breaking change descriptions in markdown changelog template

* feat(changelog-rst): alphabetize breaking change descriptions in ReStructuredText template

- **default-changelog**: Alphabetize commit summaries & scopes in change sections
([1111](https://github.com/python-semantic-release/python-semantic-release/pull/1111),
[`8327068`](https://github.com/python-semantic-release/python-semantic-release/commit/83270683fd02b626ed32179d94fa1e3c7175d113))

* test(fixtures): force non-alphabetical release history to validate template sorting

* test(default-changelog): update unit test to enforce sorting of commit desc in version sections

* test(release-notes): update unit test to enforce sorting of commit desc in version sections

* feat(changelog-md): alphabetize commit summaries & scopes in markdown changelog template

* feat(changelog-rst): alphabetize commit summaries & scopes in ReStructuredText template

- **parsers**: Enable parsers to identify linked issues on a commit
([1109](https://github.com/python-semantic-release/python-semantic-release/pull/1109),
[`f90b8dc`](https://github.com/python-semantic-release/python-semantic-release/commit/f90b8dc6ce9f112ef2c98539d155f9de24398301))

* refactor(parsers): add parser option validation to commit parsing

* docs(api-parsers): add option documentation to parser options

* feat(parsers): add `other_allowed_tags` option for commit parser options

* feat(parser-custom): enable custom parsers to identify linked issues on a commit

* test(parser-angular): add unit tests to verify parsing of issue numbers

* test(parser-emoji): add unit tests to verify parsing of issue numbers

* test(parser-scipy): add unit tests to verify parsing of issue numbers

* fix(util): prevent git footers from being collapsed during parse

* feat(parser-angular): automatically parse angular issue footers from commit messages

* feat(parser-emoji): parse issue reference footers from commit messages

* docs(commit-parsing): improve & expand commit parsing w/ parser descriptions

* docs(changelog-templates): update examples using new `commit.linked_issues` attribute

* chore(docs): update documentation configuration for team publishing

- **release-notes**: Add tag comparison link to release notes when supported
([1107](https://github.com/python-semantic-release/python-semantic-release/pull/1107),
[`9073344`](https://github.com/python-semantic-release/python-semantic-release/commit/9073344164294360843ef5522e7e4c529985984d))

* test(release-notes): adjust test case to include a version compare link

* test(cmd-changelog): add test to ensure multiple variants of release notes are published

Bug Fixes

- **release-notes**: Override default wordwrap to non-wrap for in default template
([`99ab99b`](https://github.com/python-semantic-release/python-semantic-release/commit/99ab99bb0ba350ca1913a2bde9696f4242278972))

Documentation

- **changelog-templates**: Document new `mask_initial_release` changelog context variable
([`f294957`](https://github.com/python-semantic-release/python-semantic-release/commit/f2949577dfb2dbf9c2ac952c1bbcc4ab84da080b))

- **configuration**: Document new `mask_initial_release` option usage & effect
([`3cabcdc`](https://github.com/python-semantic-release/python-semantic-release/commit/3cabcdcd9473e008604e74cc2d304595317e921d))

- **homepage**: Fix reference to new ci workflow for test status badge
([`6760069`](https://github.com/python-semantic-release/python-semantic-release/commit/6760069e7489f50635beb5aedbbeb2cb82b7c584))

Features

- **changelog**: Add md to rst conversion for markdown inline links
([`cb2af1f`](https://github.com/python-semantic-release/python-semantic-release/commit/cb2af1f17cf6c8ae037c6cd8bb8b4d9c019bb47e))

- **changelog**: Define first release w/o change descriptions for default MD template
([`fa89dec`](https://github.com/python-semantic-release/python-semantic-release/commit/fa89dec239efbae7544b187f624a998fa9ecc309))

- **changelog**: Define first release w/o change descriptions for default RST template
([`e30c94b`](https://github.com/python-semantic-release/python-semantic-release/commit/e30c94bffe62b42e8dc6ed4fed6260e57b4d532b))

- **changelog-md**: Add markdown inline link format macro
([`c6d8211`](https://github.com/python-semantic-release/python-semantic-release/commit/c6d8211c859442df17cb41d2ff19fdb7a81cdb76))

- **changelogs**: Prefix scopes on commit descriptions in default template
([1093](https://github.com/python-semantic-release/python-semantic-release/pull/1093),
[`560fd2c`](https://github.com/python-semantic-release/python-semantic-release/commit/560fd2c0d58c97318377cb83af899a336d24cfcc))

* test(changelog): update default changelog unit tests to handle commit scope

* test(release-notes): update default release notes unit tests to handle commit scope

* test(fixtures): update changelog generator fixture to handle scope additions

* test(cmd-version): update implementation for test resiliency

* feat(changelog-md): prefix scopes on commit descriptions in Markdown changelog template

* feat(changelog-rst): prefix scopes on commit descriptions in ReStructuredText template

- **configuration**: Add `changelog.default_templates.mask_initial_release` option
([`595a70b`](https://github.com/python-semantic-release/python-semantic-release/commit/595a70bcbc8fea1f8ccf6c5069c41c35ec4efb8d))

- **context**: Add `mask_initial_release` setting to changelog context
([`6f2ee39`](https://github.com/python-semantic-release/python-semantic-release/commit/6f2ee39414b3cf75c0b67dee4db0146bbc1041bb))

- **release-notes**: Define first release w/o change descriptions in default template
([`83167a3`](https://github.com/python-semantic-release/python-semantic-release/commit/83167a3dcceb7db16b790e1b0efd5fc75fee8942))

Bug Fixes

- **changelog-rst**: Ignore unknown parsed commit types in default RST changelog
([`77609b1`](https://github.com/python-semantic-release/python-semantic-release/commit/77609b1917a00b106ce254e6f6d5edcd1feebba7))

- **parser-angular**: Drop the `breaking` category but still maintain a major level bump
([`f1ffa54`](https://github.com/python-semantic-release/python-semantic-release/commit/f1ffa5411892de34cdc842fd55c460a24b6685c6))

- **parsers**: Improve reliability of text unwordwrap of descriptions
([`436374b`](https://github.com/python-semantic-release/python-semantic-release/commit/436374b04128d1550467ae97ba90253f1d1b3878))

Documentation

- **changelog-templates**: Add `linked_merge_request` field to examples
([`d4376bc`](https://github.com/python-semantic-release/python-semantic-release/commit/d4376bc2ae4d3708d501d91211ec3ee3a923e9b5))

- **changelog-templates**: Fix api class reference links
([`7a5bdf2`](https://github.com/python-semantic-release/python-semantic-release/commit/7a5bdf29b3df0f9a1346ea5301d2a7fee953667b))

- **commit-parsing**: Add `linked_merge_request` field to Parsed Commit definition
([`ca61889`](https://github.com/python-semantic-release/python-semantic-release/commit/ca61889d4ac73e9864fbf637fb87ab2d5bc053ea))

Features

- **changelog**: Add PR/MR url linking to default Markdown changelog
([`cd8d131`](https://github.com/python-semantic-release/python-semantic-release/commit/cd8d1310a4000cc79b529fbbdc58933f4c6373c6))

Resolves: 924, 953

- **changelog**: Add PR/MR url linking to default reStructuredText template
([`5f018d6`](https://github.com/python-semantic-release/python-semantic-release/commit/5f018d630b4c625bdf6d329b27fd966eba75b017))

Resolves: 924, 953

- **parsed-commit**: Add linked merge requests list to the `ParsedCommit` object
([`9a91062`](https://github.com/python-semantic-release/python-semantic-release/commit/9a9106212d6c240e9d3358e139b4c4694eaf9c4b))

- **parser-angular**: Automatically parse PR/MR numbers from subject lines in commits
([`2ac798f`](https://github.com/python-semantic-release/python-semantic-release/commit/2ac798f92e0c13c1db668747f7e35a65b99ae7ce))

- **parser-emoji**: Automatically parse PR/MR numbers from subject lines in commits
([`bca9909`](https://github.com/python-semantic-release/python-semantic-release/commit/bca9909c1b61fdb1f9ccf823fceb6951cd059820))

- **parser-scipy**: Automatically parse PR/MR numbers from subject lines in commits
([`2b3f738`](https://github.com/python-semantic-release/python-semantic-release/commit/2b3f73801f5760bac29acd93db3ffb2bc790cda0))

Performance Improvements

- **parser-angular**: Simplify commit parsing type pre-calculation
([`a86a28c`](https://github.com/python-semantic-release/python-semantic-release/commit/a86a28c5e26ed766cda71d26b9382c392e377c61))

- **parser-emoji**: Increase speed of commit parsing
([`2c9c468`](https://github.com/python-semantic-release/python-semantic-release/commit/2c9c4685a66feb35cd78571cf05f76344dd6d66a))

- **parser-scipy**: Increase speed & decrease complexity of commit parsing
([`2b661ed`](https://github.com/python-semantic-release/python-semantic-release/commit/2b661ed122a6f0357a6b92233ac1351c54c7794e))

Bug Fixes

- **cli**: Gracefully capture all exceptions unless in very verbose debug mode
([1088](https://github.com/python-semantic-release/python-semantic-release/pull/1088),
[`13ca44f`](https://github.com/python-semantic-release/python-semantic-release/commit/13ca44f4434098331f70e6937684679cf1b4106a))

* refactor(cli): consolidate entrypoints into the module execute file

- **hvcs-***: Add flexibility to issue & MR/PR url jinja filters
([1089](https://github.com/python-semantic-release/python-semantic-release/pull/1089),
[`275ec88`](https://github.com/python-semantic-release/python-semantic-release/commit/275ec88e6d1637c47065bb752a60017ceba9876c))

* fix(github): fix `issue_url` filter to ignore an issue prefix gracefully

* fix(github): fix `pull_request_url` filter to ignore an PR prefix gracefully

* fix(gitlab): fix `issue_url` filter to ignore an issue prefix gracefully

* fix(gitlab): fix `merge_request_url` filter to ignore an PR prefix gracefully

* fix(gitea): fix `issue_url` filter to ignore an issue prefix gracefully

* fix(gitea): fix `pull_request_url` filter to ignore an PR prefix gracefully

* fix(bitbucket): fix `pull_request_url` filter to ignore an PR prefix gracefully

* test(bitbucket): add test case for prefixed PR numbers

* test(gitea): add test case for prefixed PR & issue numbers

* test(gitlab): add test case for prefixed PR & issue numbers

* test(github): add test case for prefixed PR & issue numbers

* style(hvcs): fix logical lint errors

* docs(changelog-templates): update descriptions of issue & MR/PR url jinja filters