python-semantic-release 10.4.1__tar.gz → 10.5.0__tar.gz

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: python-semantic-release
-Version: 10.4.1
+Version: 10.5.0
 Summary: Automatic Semantic Versioning for Python projects
-Author-email: Rolf Erik Lekang <me@rolflekang.com>
+Author-email: Rolf Erik Lekang <me@rolflekang.com>, codejedi365 <codejedi365@gmail.com>
 License: MIT
 Project-URL: changelog, https://github.com/python-semantic-release/python-semantic-release/blob/master/CHANGELOG.md
 Project-URL: documentation, https://python-semantic-release.readthedocs.io
@@ -17,6 +17,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: ~=3.8
 Description-Content-Type: text/x-rst
 License-File: LICENSE
@@ -26,7 +27,7 @@ Requires-Dist: gitpython~=3.0
 Requires-Dist: requests~=2.25
 Requires-Dist: jinja2~=3.1
 Requires-Dist: python-gitlab<7.0.0,>=4.0.0
-Requires-Dist: tomlkit~=0.11
+Requires-Dist: tomlkit~=0.13.0
 Requires-Dist: dotty-dict~=1.3
 Requires-Dist: importlib-resources~=6.0
 Requires-Dist: pydantic~=2.0
@@ -35,11 +36,12 @@ Requires-Dist: shellingham~=1.5
 Requires-Dist: Deprecated~=1.2
 Provides-Extra: build
 Requires-Dist: build~=1.2; extra == "build"
+Requires-Dist: tomlkit~=0.13.0; extra == "build"
 Provides-Extra: docs
-Requires-Dist: Sphinx~=6.0; extra == "docs"
-Requires-Dist: sphinxcontrib-apidoc==0.5.0; extra == "docs"
+Requires-Dist: Sphinx~=7.4; extra == "docs"
+Requires-Dist: sphinxcontrib-apidoc==0.6.0; extra == "docs"
 Requires-Dist: sphinx-autobuild==2024.2.4; extra == "docs"
-Requires-Dist: furo~=2024.1; extra == "docs"
+Requires-Dist: furo~=2025.9; extra == "docs"
 Provides-Extra: test
 Requires-Dist: coverage[toml]~=7.0; extra == "test"
 Requires-Dist: filelock~=3.15; extra == "test"
@@ -48,9 +50,9 @@ Requires-Dist: freezegun~=1.5; extra == "test"
 Requires-Dist: pyyaml~=6.0; extra == "test"
 Requires-Dist: pytest~=8.3; extra == "test"
 Requires-Dist: pytest-clarity~=1.0; extra == "test"
-Requires-Dist: pytest-cov<7.0.0,>=5.0.0; extra == "test"
+Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == "test"
 Requires-Dist: pytest-env~=1.0; extra == "test"
-Requires-Dist: pytest-lazy-fixtures~=1.1.1; extra == "test"
+Requires-Dist: pytest-lazy-fixtures~=1.4; extra == "test"
 Requires-Dist: pytest-mock~=3.0; extra == "test"
 Requires-Dist: pytest-order~=1.3; extra == "test"
 Requires-Dist: pytest-pretty~=1.2; extra == "test"
@@ -58,7 +60,7 @@ Requires-Dist: pytest-xdist~=3.0; extra == "test"
 Requires-Dist: responses~=0.25.0; extra == "test"
 Requires-Dist: requests-mock~=1.10; extra == "test"
 Provides-Extra: dev
-Requires-Dist: pre-commit~=3.5; extra == "dev"
+Requires-Dist: pre-commit~=4.3; extra == "dev"
 Requires-Dist: tox~=4.11; extra == "dev"
 Requires-Dist: ruff==0.6.1; extra == "dev"
 Provides-Extra: mypy

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/docs/api/commands.rst

@@ -118,6 +118,18 @@ By default (in order):
 
   #.  Create a release in the remote VCS for this tag (if supported)
 
+.. note::
+
+  Before pushing changes to the remote (step 6), Python Semantic Release automatically
+  verifies that the upstream branch has not changed since the commit that triggered
+  the release. This prevents push conflicts when another commit was made to the
+  upstream branch while the release was being prepared. If the upstream branch has
+  changed, the command will exit with an error, and you will need to pull the latest
+  changes and run the command again.
+
+  This verification only occurs when committing changes (``--commit``). If you are
+  running with ``--no-commit``, the verification will not be performed.
+
 All of these steps can be toggled on or off using the command line options
 described below. Some of the steps rely on others, so some options may implicitly
 disable others.

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/docs/configuration/automatic-releases/github-actions.rst

@@ -875,72 +875,32 @@ to the GitHub Release Assets as well.
           contents: write
 
         steps:
-          # Note: We checkout the repository at the branch that triggered the workflow
-          # with the entire history to ensure to match PSR's release branch detection
-          # and history evaluation.
-          # However, we forcefully reset the branch to the workflow sha because it is
-          # possible that the branch was updated while the workflow was running. This
-          # prevents accidentally releasing un-evaluated changes.
+          # Note: We checkout the repository at the branch that triggered the workflow.
+          # Python Semantic Release will automatically convert shallow clones to full clones
+          # if needed to ensure proper history evaluation. However, we forcefully reset the
+          # branch to the workflow sha because it is possible that the branch was updated
+          # while the workflow was running, which prevents accidentally releasing un-evaluated
+          # changes.
           - name: Setup | Checkout Repository on Release Branch
             uses: actions/checkout@v4
             with:
               ref: ${{ github.ref_name }}
-              fetch-depth: 0
 
           - name: Setup | Force release branch to be at workflow sha
             run: |
               git reset --hard ${{ github.sha }}
 
-          - name: Evaluate | Verify upstream has NOT changed
-            # Last chance to abort before causing an error as another PR/push was applied to
-            # the upstream branch while this workflow was running. This is important
-            # because we are committing a version change (--commit). You may omit this step
-            # if you have 'commit: false' in your configuration.
-            #
-            # You may consider moving this to a repo script and call it from this step instead
-            # of writing it in-line.
-            shell: bash
-            run: |
-              set +o pipefail
-
-              UPSTREAM_BRANCH_NAME="$(git status -sb | head -n 1 | awk -F '\\.\\.\\.' '{print $2}' | cut -d ' ' -f1)"
-              printf '%s\n' "Upstream branch name: $UPSTREAM_BRANCH_NAME"
-
-              set -o pipefail
-
-              if [ -z "$UPSTREAM_BRANCH_NAME" ]; then
-                  printf >&2 '%s\n' "::error::Unable to determine upstream branch name!"
-                  exit 1
-              fi
-
-              git fetch "${UPSTREAM_BRANCH_NAME%%/*}"
-
-              if ! UPSTREAM_SHA="$(git rev-parse "$UPSTREAM_BRANCH_NAME")"; then
-                  printf >&2 '%s\n' "::error::Unable to determine upstream branch sha!"
-                  exit 1
-              fi
-
-              HEAD_SHA="$(git rev-parse HEAD)"
-
-              if [ "$HEAD_SHA" != "$UPSTREAM_SHA" ]; then
-                  printf >&2 '%s\n' "[HEAD SHA] $HEAD_SHA != $UPSTREAM_SHA [UPSTREAM SHA]"
-                  printf >&2 '%s\n' "::error::Upstream has changed, aborting release..."
-                  exit 1
-              fi
-
-              printf '%s\n' "Verified upstream branch has not changed, continuing with release..."
-
           - name: Action | Semantic Version Release
             id: release
             # Adjust tag with desired version if applicable.
-            uses: python-semantic-release/python-semantic-release@v10.4.1
+            uses: python-semantic-release/python-semantic-release@v10.5.0
             with:
               github_token: ${{ secrets.GITHUB_TOKEN }}
               git_committer_name: "github-actions"
               git_committer_email: "actions@users.noreply.github.com"
 
           - name: Publish | Upload to GitHub Release Assets
-            uses: python-semantic-release/publish-action@v10.4.1
+            uses: python-semantic-release/publish-action@v10.5.0
             if: steps.release.outputs.released == 'true'
             with:
               github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -953,6 +913,9 @@ to the GitHub Release Assets as well.
               path: dist
               if-no-files-found: error
 
+        outputs:
+          released: ${{ steps.release.outputs.released || 'false' }}
+
       deploy:
         # 1. Separate out the deploy step from the publish step to run each step at
         #    the least amount of token privilege
@@ -995,16 +958,6 @@ to the GitHub Release Assets as well.
   one release job in the case if there are multiple pushes to ``main`` in a short period
   of time.
 
-  Secondly the *Evaluate | Verify upstream has NOT changed* step is used to ensure that the
-  upstream branch has not changed while the workflow was running. This is important because
-  we are committing a version change (``commit: true``) and there might be a push collision
-  that would cause undesired behavior. Review Issue `#1201`_ for more detailed information.
-
-.. warning::
-  You must set ``fetch-depth`` to 0 when using ``actions/checkout@v4``, since
-  Python Semantic Release needs access to the full history to build a changelog
-  and at least the latest tags to determine the next version.
-
 .. warning::
   The ``GITHUB_TOKEN`` secret is automatically configured by GitHub, with the
   same permissions role as the user who triggered the workflow run. This causes
@@ -1015,6 +968,19 @@ to the GitHub Release Assets as well.
   case, you will also need to pass the new token to ``actions/checkout`` (as
   the ``token`` input) in order to gain push access.
 
+.. note::
+  As of $NEW_RELEASE_TAG, Python Semantic Release automatically detects and converts
+  shallow clones to full clones when needed. While you can still use ``fetch-depth: 0``
+  with ``actions/checkout@v4`` to fetch the full history upfront, it is no longer
+  required. If you use the default shallow clone, Python Semantic Release will
+  automatically fetch the full history before evaluating commits. If you are using
+  an older version of PSR, you will need to unshallow the repository prior to use.
+
+.. note::
+  As of $NEW_RELEASE_TAG, the verify upstream step is no longer required as it has been
+  integrated into PSR directly. If you are using an older version of PSR, you will need
+  to review the older documentation for that step. See Issue `#1201`_ for more details.
+
 .. _#1201: https://github.com/python-semantic-release/python-semantic-release/issues/1201
 .. _concurrency: https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idconcurrency
 
@@ -1039,7 +1005,7 @@ The equivalent GitHub Action configuration would be:
 
   - name: Action | Semantic Version Release
     # Adjust tag with desired version if applicable.
-    uses: python-semantic-release/python-semantic-release@v10.4.1
+    uses: python-semantic-release/python-semantic-release@v10.5.0
     with:
       github_token: ${{ secrets.GITHUB_TOKEN }}
       force: patch
@@ -1098,14 +1064,14 @@ Publish Action.
 
         - name: Release submodule 1
           id: release-submod-1
-          uses: python-semantic-release/python-semantic-release@v10.4.1
+          uses: python-semantic-release/python-semantic-release@v10.5.0
           with:
             directory: ${{ env.SUBMODULE_1_DIR }}
             github_token: ${{ secrets.GITHUB_TOKEN }}
 
         - name: Release submodule 2
           id: release-submod-2
-          uses: python-semantic-release/python-semantic-release@v10.4.1
+          uses: python-semantic-release/python-semantic-release@v10.5.0
           with:
             directory: ${{ env.SUBMODULE_2_DIR }}
             github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -1117,7 +1083,7 @@ Publish Action.
         # ------------------------------------------------------------------- #
 
         - name: Publish | Upload package 1 to GitHub Release Assets
-          uses: python-semantic-release/publish-action@v10.4.1
+          uses: python-semantic-release/publish-action@v10.5.0
           if: steps.release-submod-1.outputs.released == 'true'
           with:
             directory: ${{ env.SUBMODULE_1_DIR }}
@@ -1125,7 +1091,7 @@ Publish Action.
             tag: ${{ steps.release-submod-1.outputs.tag }}
 
         - name: Publish | Upload package 2 to GitHub Release Assets
-          uses: python-semantic-release/publish-action@v10.4.1
+          uses: python-semantic-release/publish-action@v10.5.0
           if: steps.release-submod-2.outputs.released == 'true'
           with:
             directory: ${{ env.SUBMODULE_2_DIR }}

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/docs/configuration/configuration-guides/uv_integration.rst

@@ -161,7 +161,6 @@ look like this:
           uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
           with:
             ref: ${{ github.sha }}
-            fetch-depth: 0
 
         - name: Setup | Force correct release branch on workflow sha
           run: git checkout -B ${{ github.ref_name }}
@@ -259,7 +258,6 @@ look like this:
           uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
           with:
             ref: ${{ github.ref_name }}
-            fetch-depth: 0
 
         - name: Setup | Force release branch to be at workflow sha
           run: git reset --hard ${{ github.sha }}
@@ -291,7 +289,6 @@ look like this:
           env:
             GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           run: |
-            bash .github/workflows/verify_upstream.sh
             uv run semantic-release -v --strict version --skip-build
             uv run semantic-release publish
 

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/docs/configuration/configuration.rst

@@ -1162,6 +1162,52 @@ from the :ref:`remote.name <config-remote-name>` location of your git repository
 
 ----
 
+.. _config-add_partial_tags:
+
+``add_partial_tags``
+""""""""""""""""""""
+
+**Type:** ``bool``
+
+Specify if partial version tags should be handled when creating a new version. If set to
+``true``, a ``major`` and a ``major.minor`` tag will be created or updated, using the format
+specified in :ref:`tag_format`. If version has build metadata, a ``major.minor.patch`` tag
+will also be created or updated.
+
+Partial version tags are **disabled** for pre-release versions.
+
+**Example**
+
+.. code-block:: toml
+
+    [semantic_release]
+    tag_format = "v{version}"
+    add_partial_tags = true
+
+This configuration with the next version of ``1.2.3`` will result in:
+
+.. code-block:: bash
+
+    git log --decorate --oneline --graph --all
+    # * 4d4cb0a (tag: v1.2.3, tag: v1.2, tag: v1, origin/main, main) 1.2.3
+    # * 3a2b1c0 fix: some bug
+    # * 2b1c0a9 (tag: v1.2.2) 1.2.2
+    # ...
+
+If build-metadata is used, the next version of ``1.2.3+20251109`` will result in:
+
+.. code-block:: bash
+
+    git log --decorate --oneline --graph --all
+    # * 4d4cb0a (tag: v1.2.3+20251109, tag: v1.2.3, tag: v1.2, tag: v1, origin/main, main) 1.2.3+20251109
+    # * 3a2b1c0 chore: add partial tags to PSR configuration
+    # * 2b1c0a9 (tag: v1.2.3+20251031) 1.2.3+20251031
+    # ...
+
+**Default:** ``false``
+
+----
+
 .. _config-tag_format:
 
 ``tag_format``
@@ -1170,17 +1216,8 @@ from the :ref:`remote.name <config-remote-name>` location of your git repository
 **Type:** ``str``
 
 Specify the format to be used for the Git tag that will be added to the repo during
-a release invoked via :ref:`cmd-version`. The format string is a regular expression,
-which also must include the format keys below, otherwise an exception will be thrown.
-It *may* include any of the optional format keys, in which case the contents
-described will be formatted into the specified location in the Git tag that is created.
-
-For example, ``"(dev|stg|prod)-v{version}"`` is a valid ``tag_format`` matching tags such
-as:
-
-- ``dev-v1.2.3``
-- ``stg-v0.1.0-rc.1``
-- ``prod-v2.0.0+20230701``
+a release invoked via :ref:`cmd-version`. The string is used as a template for the tag
+name, and must include the ``{version}`` format key.
 
 This format will also be used for parsing tags already present in the repository into
 semantic versions; therefore if the tag format changes at some point in the
@@ -1196,6 +1233,13 @@ Format Key       Mandatory  Contents
 
 Tags which do not match this format will not be considered as versions of your project.
 
+This is critical for Monorepo projects where the tag format defines which package the
+version tag belongs to. Generally, the tag format for each package of the monorepo will
+include the package name as the prefix of the tag format. For example, if the package
+is named ``pkg1``, the tag format would be ``pkg1-v{version}`` and in the other package
+``pkg2``, the tag format would be ``pkg2-v{version}``. This allows PSR to determine
+which tags to use to determine the version for each package.
+
 **Default:** ``"v{version}"``
 
 ----
@@ -1354,7 +1398,8 @@ The regular expression generated from the ``version_variables`` definition will:
 2. The variable name defined by ``variable`` and the version must be separated by
    an operand symbol (``=``, ``:``, ``:=``, or ``@``). Whitespace is optional around
    the symbol. As of v10.0.0, a double-equals (``==``) operator is also supported
-   as a valid operand symbol.
+   as a valid operand symbol. As of $NEW_RELEASE_TAG, PSR can omit all operands as long
+   as there is at least one whitespace character between the variable name and the version.
 
 3. The value of the variable must match a `SemVer`_ regular expression and can be
    enclosed by single (``'``) or double (``"``) quotation marks but they must match. However,
@@ -1410,6 +1455,9 @@ will be matched and replaced by the new version:
     # requirements.txt
     my-package == 1.2.3
 
+    # C-Macro style (no operand only whitespace required)
+    #define VERSION "1.2.3"
+
 .. important::
     The Regular Expression expects a version value to exist in the file to be replaced.
     It cannot be an empty string or a non-semver compliant string. If this is the very

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-semantic-release"
-version = "10.4.1"
+version = "10.5.0"
 description = "Automatic Semantic Versioning for Python projects"
 requires-python = "~= 3.8"
 license = { text = "MIT" }
@@ -19,9 +19,13 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
 ]
 readme = "README.rst"
-authors = [{ name = "Rolf Erik Lekang", email = "me@rolflekang.com" }]
+authors = [
+  { name = "Rolf Erik Lekang", email = "me@rolflekang.com" },
+  { name = "codejedi365", email = "codejedi365@gmail.com" },
+]
 dependencies = [
   "click ~= 8.1.0",
   "click-option-group ~= 0.5",
@@ -29,7 +33,7 @@ dependencies = [
   "requests ~= 2.25",
   "jinja2 ~= 3.1",
   "python-gitlab >= 4.0.0, < 7.0.0",
-  "tomlkit ~= 0.11",
+  "tomlkit ~= 0.13.0",
   "dotty-dict ~= 1.3",
   "importlib-resources ~= 6.0",
   "pydantic ~= 2.0",
@@ -52,13 +56,14 @@ repository = "http://github.com/python-semantic-release/python-semantic-release.
 
 [project.optional-dependencies]
 build = [
-  "build ~= 1.2"
+  "build ~= 1.2",
+  "tomlkit ~= 0.13.0",
 ]
 docs = [
-  "Sphinx ~= 6.0",
-  "sphinxcontrib-apidoc == 0.5.0",
+  "Sphinx ~= 7.4",
+  "sphinxcontrib-apidoc == 0.6.0",
   "sphinx-autobuild == 2024.2.4",
-  "furo ~= 2024.1",
+  "furo ~= 2025.9",
 ]
 test = [
   "coverage[toml] ~= 7.0",
@@ -68,9 +73,9 @@ test = [
   "pyyaml ~= 6.0",
   "pytest ~= 8.3",
   "pytest-clarity ~= 1.0",
-  "pytest-cov >= 5.0.0, < 7.0.0",
+  "pytest-cov >= 5.0.0, < 8.0.0",
   "pytest-env ~= 1.0",
-  "pytest-lazy-fixtures ~= 1.1.1",
+  "pytest-lazy-fixtures ~= 1.4",
   "pytest-mock ~= 3.0",
   "pytest-order ~= 1.3",
   "pytest-pretty ~= 1.2",
@@ -79,7 +84,7 @@ test = [
   "requests-mock ~= 1.10",
 ]
 dev = [
-  "pre-commit ~= 3.5",
+  "pre-commit ~= 4.3",
   "tox ~= 4.11",
   "ruff == 0.6.1"
 ]
@@ -407,6 +412,11 @@ ignore_names = ["change_to_ex_proj_dir", "init_example_project"]
 logging_use_named_masks = true
 commit_parser = "conventional"
 commit_parser_options = { parse_squash_commits = true, ignore_merge_commits = true }
+commit_message = """\
+chore: release v{version}
+
+Automatically generated by python-semantic-release
+"""
 build_command = """
     python -m pip install -e .[build]
     python -m build .

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/src/python_semantic_release.egg-info/SOURCES.txt

@@ -135,10 +135,13 @@ tests/e2e/cmd_version/test_version_bump.py
 tests/e2e/cmd_version/test_version_changelog.py
 tests/e2e/cmd_version/test_version_changelog_custom_commit_msg.py
 tests/e2e/cmd_version/test_version_github_actions.py
+tests/e2e/cmd_version/test_version_partial_tag.py
 tests/e2e/cmd_version/test_version_print.py
 tests/e2e/cmd_version/test_version_release_notes.py
+tests/e2e/cmd_version/test_version_shallow.py
 tests/e2e/cmd_version/test_version_stamp.py
 tests/e2e/cmd_version/test_version_strict.py
+tests/e2e/cmd_version/test_version_upstream_check.py
 tests/e2e/cmd_version/bump_version/__init__.py
 tests/e2e/cmd_version/bump_version/conftest.py
 tests/e2e/cmd_version/bump_version/git_flow/__init__.py
@@ -193,6 +196,7 @@ tests/fixtures/repos/trunk_based_dev/repo_w_tags.py
 tests/unit/__init__.py
 tests/unit/conftest.py
 tests/unit/semantic_release/__init__.py
+tests/unit/semantic_release/test_gitproject.py
 tests/unit/semantic_release/test_helpers.py
 tests/unit/semantic_release/changelog/__init__.py
 tests/unit/semantic_release/changelog/conftest.py

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/src/semantic_release/changelog/context.py

@@ -119,7 +119,7 @@ def read_file(filepath: str) -> str:
             return rfd.read()
 
     except FileNotFoundError as err:
-        logging.warning(err)
+        logging.warning(str(err))
         return ""
 
 

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/src/semantic_release/cli/commands/version.py

@@ -10,7 +10,7 @@ from typing import TYPE_CHECKING
 import click
 import shellingham  # type: ignore[import]
 from click_option_group import MutuallyExclusiveOptionGroup, optgroup
-from git import Repo
+from git import GitCommandError, Repo
 from requests import HTTPError
 
 from semantic_release.changelog.release_history import ReleaseHistory
@@ -27,9 +27,14 @@ from semantic_release.const import DEFAULT_SHELL, DEFAULT_VERSION
 from semantic_release.enums import LevelBump
 from semantic_release.errors import (
     BuildDistributionsError,
+    DetachedHeadGitError,
     GitCommitEmptyIndexError,
+    GitFetchError,
     InternalError,
+    LocalGitError,
     UnexpectedResponse,
+    UnknownUpstreamBranchError,
+    UpstreamBranchChangedError,
 )
 from semantic_release.gitproject import GitProject
 from semantic_release.globals import logger
@@ -75,10 +80,13 @@ def is_forced_prerelease(
     )
 
 
-def last_released(repo_dir: Path, tag_format: str) -> tuple[Tag, Version] | None:
+def last_released(
+    repo_dir: Path, tag_format: str, add_partial_tags: bool = False
+) -> tuple[Tag, Version] | None:
     with Repo(str(repo_dir)) as git_repo:
         ts_and_vs = tags_and_versions(
-            git_repo.tags, VersionTranslator(tag_format=tag_format)
+            git_repo.tags,
+            VersionTranslator(tag_format=tag_format, add_partial_tags=add_partial_tags),
         )
 
     return ts_and_vs[0] if ts_and_vs else None
@@ -449,7 +457,11 @@ def version(  # noqa: C901
     if print_last_released or print_last_released_tag:
         # TODO: get tag format a better way
         if not (
-            last_release := last_released(config.repo_dir, tag_format=config.tag_format)
+            last_release := last_released(
+                config.repo_dir,
+                tag_format=config.tag_format,
+                add_partial_tags=config.add_partial_tags,
+            )
         ):
             logger.warning("No release tags found.")
             return
@@ -470,6 +482,7 @@ def version(  # noqa: C901
     major_on_zero = runtime.major_on_zero
     no_verify = runtime.no_git_verify
     opts = runtime.global_cli_options
+    add_partial_tags = config.add_partial_tags
     gha_output = VersionGitHubActionsOutput(
         gh_client=hvcs_client if isinstance(hvcs_client, Github) else None,
         mode=(
@@ -491,6 +504,17 @@ def version(  # noqa: C901
         logger.info("Forcing use of %s as the prerelease token", prerelease_token)
         translator.prerelease_token = prerelease_token
 
+    # Check if the repository is shallow and unshallow it if necessary
+    # This ensures we have the full history for commit analysis
+    project = GitProject(
+        directory=runtime.repo_dir,
+        commit_author=runtime.commit_author,
+        credential_masker=runtime.masker,
+    )
+    if project.is_shallow_clone():
+        logger.info("Repository is a shallow clone, converting to full clone...")
+        project.git_unshallow(noop=opts.noop)
+
     # Only push if we're committing changes
     if push_changes and not commit_changes and not create_tag:
         logger.info("changes will not be pushed because --no-commit disables pushing")
@@ -683,12 +707,6 @@ def version(  # noqa: C901
         license_name="" if not isinstance(license_cfg, str) else license_cfg,
     )
 
-    project = GitProject(
-        directory=runtime.repo_dir,
-        commit_author=runtime.commit_author,
-        credential_masker=runtime.masker,
-    )
-
     # Preparing for committing changes; we always stage files even if we're not committing them in order to support a two-stage commit
     project.git_add(paths=all_paths_to_add, noop=opts.noop)
     if commit_changes:
@@ -727,6 +745,29 @@ def version(  # noqa: C901
         )
 
         if commit_changes:
+            # Verify that the upstream branch has not changed before pushing
+            # This prevents conflicts if another commit was pushed while we were preparing the release
+            # We check HEAD~1 because we just made a release commit
+            try:
+                project.verify_upstream_unchanged(local_ref="HEAD~1", noop=opts.noop)
+            except UpstreamBranchChangedError as exc:
+                click.echo(str(exc), err=True)
+                click.echo(
+                    "Upstream branch has changed. Please pull the latest changes and try again.",
+                    err=True,
+                )
+                ctx.exit(1)
+            except (
+                DetachedHeadGitError,
+                GitCommandError,
+                UnknownUpstreamBranchError,
+                GitFetchError,
+                LocalGitError,
+            ) as exc:
+                click.echo(str(exc), err=True)
+                click.echo("Unable to verify upstream due to error!", err=True)
+                ctx.exit(1)
+
             # TODO: integrate into push branch
             with Repo(str(runtime.repo_dir)) as git_repo:
                 active_branch = git_repo.active_branch.name
@@ -744,6 +785,27 @@ def version(  # noqa: C901
                 tag=new_version.as_tag(),
                 noop=opts.noop,
             )
+            # Create or update partial tags for releases
+            if add_partial_tags and not prerelease:
+                partial_tags = [new_version.as_major_tag(), new_version.as_minor_tag()]
+                # If build metadata is set, also retag the version without the metadata
+                if build_metadata:
+                    partial_tags.append(new_version.as_patch_tag())
+
+                for partial_tag in partial_tags:
+                    project.git_tag(
+                        tag_name=partial_tag,
+                        message=f"{partial_tag} => {new_version.as_tag()}",
+                        isotimestamp=commit_date.isoformat(),
+                        noop=opts.noop,
+                        force=True,
+                    )
+                    project.git_push_tag(
+                        remote_url=remote_url,
+                        tag=partial_tag,
+                        noop=opts.noop,
+                        force=True,
+                    )
 
     # Update GitHub Actions output value now that release has occurred
     gha_output.released = True

{python_semantic_release-10.4.1 → python_semantic_release-10.5.0}/src/semantic_release/cli/config.py

@@ -366,6 +366,7 @@ class RawConfig(BaseModel):
     remote: RemoteConfig = RemoteConfig()
     no_git_verify: bool = False
     tag_format: str = "v{version}"
+    add_partial_tags: bool = False
     publish: PublishConfig = PublishConfig()
     version_toml: Optional[Tuple[str, ...]] = None
     version_variables: Optional[Tuple[str, ...]] = None
@@ -827,7 +828,9 @@ class RuntimeContext:
 
         # version_translator
         version_translator = VersionTranslator(
-            tag_format=raw.tag_format, prerelease_token=branch_config.prerelease_token
+            tag_format=raw.tag_format,
+            prerelease_token=branch_config.prerelease_token,
+            add_partial_tags=raw.add_partial_tags,
         )
 
         build_cmd_env = {}