python-semantic-release 10.5.2__tar.gz → 10.6.0__tar.gz

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: python-semantic-release
-Version: 10.5.2
+Version: 10.6.0
 Summary: Automatic Semantic Versioning for Python projects
 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: changelog, https://python-semantic-release.readthedocs.io/en/stable/misc/psr_changelog.html
 Project-URL: documentation, https://python-semantic-release.readthedocs.io
 Project-URL: homepage, https://python-semantic-release.readthedocs.io
 Project-URL: issues, https://github.com/python-semantic-release/python-semantic-release/issues

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/docs/api/commands.rst

@@ -473,16 +473,36 @@ Release corresponding to this version.
 
 Generate default configuration for semantic-release, to help you get started
 quickly. You can inspect the defaults, write to a file and then edit according to
-your needs.
-For example, to append the default configuration to your pyproject.toml
-file, you can use the following command::
+your needs. For example, to append the default configuration to your ``pyproject.toml``
+file, you can use the following command (in POSIX-Compliant shells):
 
-    $ semantic-release generate-config -f toml --pyproject >> pyproject.toml
+.. code-block:: bash
+
+    semantic-release generate-config --pyproject >> pyproject.toml
+
+On Windows PowerShell, the redirection operators (`>`/`>>`) default to UTF-16LE,
+which can introduce NUL characters. Prefer one of the following to keep UTF-8:
+
+.. code-block:: console
+
+    # 2 File output Piping Options in PowerShell (Out-File or Set-Content)
+
+    # Example for writing to pyproject.toml using Out-File:
+    semantic-release generate-config --pyproject | Out-File -Encoding utf8 pyproject.toml
+
+    # Example for writing to a releaserc.toml file using Set-Content:
+    semantic-release generate-config -f toml | Set-Content -Encoding utf8 releaserc.toml
 
 If your project doesn't already leverage TOML files for configuration, it might better
-suit your project to use JSON instead::
+suit your project to use JSON instead:
+
+.. code-block:: bash
+
+    # POSIX-Compliant shell example
+    semantic-release generate-config -f json | tee releaserc.json
 
-    $ semantic-release generate-config -f json
+    # Windows PowerShell example
+    semantic-release generate-config -f json | Out-File -Encoding utf8 releaserc.json
 
 If you would like to add JSON configuration to a shared file, e.g. ``package.json``, you
 can then simply add the output from this command as a **top-level** key to the file.

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/docs/configuration/automatic-releases/github-actions.rst

@@ -882,7 +882,7 @@ to the GitHub Release Assets as well.
           # while the workflow was running, which prevents accidentally releasing un-evaluated
           # changes.
           - name: Setup | Checkout Repository on Release Branch
-            uses: actions/checkout@v4
+            uses: actions/checkout@COMMIT_HASH  # v6
             with:
               ref: ${{ github.ref_name }}
 
@@ -893,21 +893,21 @@ to the GitHub Release Assets as well.
           - name: Action | Semantic Version Release
             id: release
             # Adjust tag with desired version if applicable.
-            uses: python-semantic-release/python-semantic-release@v10.5.2
+            uses: python-semantic-release/python-semantic-release@COMMIT_HASH  # v10.6.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.5.2
+            uses: python-semantic-release/publish-action@COMMIT_HASH  # v10.6.0
             if: steps.release.outputs.released == 'true'
             with:
               github_token: ${{ secrets.GITHUB_TOKEN }}
               tag: ${{ steps.release.outputs.tag }}
 
           - name: Upload | Distribution Artifacts
-            uses: actions/upload-artifact@v4
+            uses: actions/upload-artifact@COMMIT_HASH  # v4.X.X
             with:
               name: distribution-artifacts
               path: dist
@@ -931,7 +931,7 @@ to the GitHub Release Assets as well.
 
         steps:
           - name: Setup | Download Build Artifacts
-            uses: actions/download-artifact@v4
+            uses: actions/download-artifact@COMMIT_HASH  # v4.X.X
             id: artifact-download
             with:
               name: distribution-artifacts
@@ -947,7 +947,7 @@ to the GitHub Release Assets as well.
 
           # see https://docs.pypi.org/trusted-publishers/
           - name: Publish package distributions to PyPI
-            uses: pypa/gh-action-pypi-publish@@SHA1_HASH  # vX.X.X
+            uses: pypa/gh-action-pypi-publish@COMMIT_HASH  # vX.X.X
             with:
               packages-dir: dist
               print-hash: true
@@ -971,7 +971,7 @@ to the GitHub Release Assets as well.
 .. note::
   As of v10.5.0, 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
+  with ``actions/checkout`` 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.
@@ -1005,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.5.2
+    uses: python-semantic-release/python-semantic-release@v10.5.3
     with:
       github_token: ${{ secrets.GITHUB_TOKEN }}
       force: patch
@@ -1064,14 +1064,14 @@ Publish Action.
 
         - name: Release submodule 1
           id: release-submod-1
-          uses: python-semantic-release/python-semantic-release@v10.5.2
+          uses: python-semantic-release/python-semantic-release@v10.5.3
           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.5.2
+          uses: python-semantic-release/python-semantic-release@v10.5.3
           with:
             directory: ${{ env.SUBMODULE_2_DIR }}
             github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -1083,7 +1083,7 @@ Publish Action.
         # ------------------------------------------------------------------- #
 
         - name: Publish | Upload package 1 to GitHub Release Assets
-          uses: python-semantic-release/publish-action@v10.5.2
+          uses: python-semantic-release/publish-action@v10.5.3
           if: steps.release-submod-1.outputs.released == 'true'
           with:
             directory: ${{ env.SUBMODULE_1_DIR }}
@@ -1091,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.5.2
+          uses: python-semantic-release/publish-action@v10.5.3
           if: steps.release-submod-2.outputs.released == 'true'
           with:
             directory: ${{ env.SUBMODULE_2_DIR }}
@@ -1107,13 +1107,13 @@ Publish Action.
         # ------------------------------------------------------------------- #
 
         - name: Publish | Upload package 1 to PyPI
-          uses: pypa/gh-action-pypi-publish@SHA1_HASH  # vX.X.X
+          uses: pypa/gh-action-pypi-publish@COMMIT_HASH  # vX.X.X
           if: steps.release-submod-1.outputs.released == 'true'
           with:
             packages-dir: ${{ format('{}/dist', env.SUBMODULE_1_DIR) }}
 
         - name: Publish | Upload package 2 to PyPI
-          uses: pypa/gh-action-pypi-publish@SHA1_HASH  # vX.X.X
+          uses: pypa/gh-action-pypi-publish@COMMIT_HASH  # vX.X.X
           if: steps.release-submod-2.outputs.released == 'true'
           with:
             packages-dir: ${{ format('{}/dist', env.SUBMODULE_2_DIR) }}

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/docs/configuration/configuration-guides/uv_integration.rst

@@ -158,7 +158,7 @@ look like this:
         lock_file_artifact: uv.lock
       steps:
         - name: Setup | Checkout Repository at workflow sha
-          uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
+          uses: actions/checkout@COMMIT_HASH  # vX.X.X
           with:
             ref: ${{ github.sha }}
 
@@ -166,7 +166,7 @@ look like this:
           run: git checkout -B ${{ github.ref_name }}
 
         - name: Setup | Install uv
-          uses: asdf-vm/actions/install@1902764435ca0dd2f3388eea723a4f92a4eb8302  # v4.0.2
+          uses: asdf-vm/actions/install@COMMIT_HASH  # v4.X.X
 
         - name: Setup | Install Python & Project dependencies
           run: uv sync --extra build
@@ -179,7 +179,7 @@ look like this:
 
         - name: Upload | Distribution Artifacts
           if: ${{ steps.version.outputs.released == 'true' }}
-          uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+          uses: actions/upload-artifact@COMMIT_HASH  # v4.X.X
           with:
             name: ${{ env.dist_artifacts_name }}
             path: ${{ format('{0}/**', env.dist_artifacts_dir) }}
@@ -188,7 +188,7 @@ look like this:
 
         - name: Upload | Lock File Artifact
           if: ${{ steps.version.outputs.released == 'true' }}
-          uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4.6.2
+          uses: actions/upload-artifact@COMMIT_HASH  # v4.X.X
           with:
             name: ${{ env.lock_file_artifact }}
             path: ${{ env.lock_file_artifact }}
@@ -209,13 +209,13 @@ look like this:
       runs-on: ubuntu-latest
       steps:
         - name: Setup | Checkout Repository
-          uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
+          uses: actions/checkout@COMMIT_HASH  # vX.X.X
           with:
             ref: ${{ github.sha }}
             fetch-depth: 1
 
         - name: Setup | Download Distribution Artifacts
-          uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+          uses: actions/download-artifact@COMMIT_HASH  # v4.X.X
           if: ${{ needs.build.outputs.new-release-detected == 'true' }}
           id: artifact-download
           with:
@@ -223,7 +223,7 @@ look like this:
             path: ./dist
 
         - name: Setup | Install uv
-          uses: asdf-vm/actions/install@1902764435ca0dd2f3388eea723a4f92a4eb8302  # v4.0.2
+          uses: asdf-vm/actions/install@COMMIT_HASH  # v4.X.X
 
         - name: Setup | Install Python & Project dependencies
           run: uv sync --extra test
@@ -255,7 +255,7 @@ look like this:
 
       steps:
         - name: Setup | Checkout Repository on Release Branch
-          uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
+          uses: actions/checkout@COMMIT_HASH  # vX.X.X
           with:
             ref: ${{ github.ref_name }}
 
@@ -263,20 +263,20 @@ look like this:
           run: git reset --hard ${{ github.sha }}
 
         - name: Setup | Install uv
-          uses: asdf-vm/actions/install@1902764435ca0dd2f3388eea723a4f92a4eb8302  # v4.0.2
+          uses: asdf-vm/actions/install@COMMIT_HASH  # v4.X.X
 
         - name: Setup | Install Python & Project dependencies
           run: uv sync --extra build
 
         - name: Setup | Download Build Artifacts
-          uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+          uses: actions/download-artifact@COMMIT_HASH  # v4.X.X
           id: artifact-download
           with:
             name: ${{ needs.build.outputs.distribution-artifacts }}
             path: dist
 
         - name: Setup | Download Lock File Artifact
-          uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+          uses: actions/download-artifact@COMMIT_HASH  # v4.X.X
           with:
             name: ${{ needs.build.outputs.lock-file-artifact }}
 
@@ -315,14 +315,14 @@ look like this:
 
       steps:
         - name: Setup | Download Build Artifacts
-          uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4.3.0
+          uses: actions/download-artifact@COMMIT_HASH  # v4.X.X
           id: artifact-download
           with:
             name: ${{ needs.build.outputs.distribution-artifacts }}
             path: dist
 
         - name: Publish package distributions to PyPI
-          uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc  # v1.12.4
+          uses: pypa/gh-action-pypi-publish@COMMIT_HASH  # v1.X.X
           with:
             packages-dir: dist
             print-hash: true

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/docs/configuration/configuration.rst

@@ -1326,6 +1326,10 @@ colon-separated definition with either 2 or 3 parts. The 2-part definition inclu
 the file path and the variable name. Newly with v9.20.0, it also accepts
 an optional 3rd part to allow configuration of the format type.
 
+As of ${NEW_RELEASE_TAG}, the ``version_variables`` option also supports entire file
+replacement by using an asterisk (``*``) as the pattern/variable name. This is useful
+for files that contain only a version number, such as ``VERSION`` files.
+
 **Available Format Types**
 
 - ``nf``: Number format (ex. ``1.2.3``)
@@ -1348,6 +1352,9 @@ version numbers.
         "src/semantic_release/__init__.py:__version__",  # Implied Default: Number format
         "docs/conf.py:version:nf",                       # Number format for sphinx docs
         "kustomization.yml:newTag:tf",                   # Tag format
+        # File replacement (entire file content is replaced with version)
+        "VERSION:*:nf",                                  # Replace entire file with number format
+        "RELEASE:*:tf",                                  # Replace entire file with tag format
     ]
 
 First, the ``__version__`` variable in ``src/semantic_release/__init__.py`` will be updated
@@ -1370,7 +1377,7 @@ with the next version using the `SemVer`_ number format because of the explicit
     - version = "0.1.0"
     + version = "0.2.0"
 
-Lastly, the ``newTag`` variable in ``kustomization.yml`` will be updated with the next version
+Then, the ``newTag`` variable in ``kustomization.yml`` will be updated with the next version
 with the next version using the configured :ref:`config-tag_format` because the definition
 included ``tf``.
 
@@ -1383,10 +1390,34 @@ included ``tf``.
     -     newTag: v0.1.0
     +     newTag: v0.2.0
 
+Next, the entire content of the ``VERSION`` file will be replaced with the next version
+using the `SemVer`_ number format (because of the ``*`` pattern and ``nf`` format type).
+
+.. code-block:: diff
+
+    diff a/VERSION b/VERSION
+
+    - 0.1.0
+    + 0.2.0
+
+Finally, the entire content of the ``RELEASE`` file will be replaced with the next version
+using the configured :ref:`config-tag_format` (because of the ``*`` pattern and ``tf`` format type).
+
+.. code-block:: diff
+
+    diff a/RELEASE b/RELEASE
+
+    - v0.1.0
+    + v0.2.0
+
 **How It works**
 
-Each version variable will be transformed into a Regular Expression that will be used
-to substitute the version number in the file. The replacement algorithm is **ONLY** a
+Each version variable will be transformed into either a Regular Expression (for pattern-based
+replacement) or a file replacement operation (when using the ``*`` pattern).
+
+**Pattern-Based Replacement**
+
+When a variable name is specified (not ``*``), the replacement algorithm is **ONLY** a
 pattern match and replace. It will **NOT** evaluate the code nor will PSR understand
 any internal object structures (ie. ``file:object.version`` will not work).
 
@@ -1420,6 +1451,24 @@ regardless of file extension because it looks for a matching pattern string.
     TOML files as it actually will interpret the TOML file and replace the version
     number before writing the file back to disk.
 
+**File Replacement**
+
+When the pattern/variable name is specified as an asterisk (``*``), the entire file content
+will be replaced with the version string. This is useful for files that contain only a
+version number, such as ``VERSION`` files or similar single-line version storage files.
+
+The file replacement operation:
+
+1. Reads the current file content if it exists (any whitespace is stripped)
+2. Sets or replaces the entire file content with the new version string
+3. Writes the new version back to the file (with only a single trailing newline)
+
+The format type (``nf`` or ``tf``) determines whether the version is written as a
+plain number (e.g., ``1.2.3``) or with the :ref:`config-tag_format` prefix/suffix
+(e.g., ``v1.2.3``).
+
+**Examples of Pattern-Based Replacement**
+
 This is a comprehensive list (but not all variations) of examples where the following versions
 will be matched and replaced by the new version:
 

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/docs/upgrading/08-upgrade.rst

@@ -50,13 +50,13 @@ This workflow is written to use Python Semantic Release v7.33.5:
        concurrency: release
 
        steps:
-       - uses: actions/checkout@v3
+       - uses: actions/checkout@COMMIT_HASH  # v3.0.0
          with:
            fetch-depth: 0
 
        # This action uses Python Semantic Release v7
        - name: Python Semantic Release
-         uses: python-semantic-release/python-semantic-release@v7.33.5
+         uses: python-semantic-release/python-semantic-release@323ebf700ac0878aedfa899bcb0492f6d579986c  # v7.33.5
          with:
            github_token: ${{ secrets.GITHUB_TOKEN }}
            repository_username: __token__
@@ -84,25 +84,25 @@ GitHub Action:
          id-token: write
 
        steps:
-       - uses: actions/checkout@v3
+       - uses: actions/checkout@COMMIT_HASH  # v3.0.0
          with:
            fetch-depth: 0
 
        # This action uses Python Semantic Release v8
        - name: Python Semantic Release
          id: release
-         uses: python-semantic-release/python-semantic-release@v8.7.0
+         uses: python-semantic-release/python-semantic-release@COMMIT_HASH  # v8.0.0
          with:
            github_token: ${{ secrets.GITHUB_TOKEN }}
 
        - name: Publish package distributions to PyPI
-         uses: pypa/gh-action-pypi-publish@v1
+         uses: pypa/gh-action-pypi-publish@COMMIT_HASH  # v1.0.0
          # NOTE: DO NOT wrap the conditional in ${{ }} as it will always evaluate to true.
          # See https://github.com/actions/runner/issues/1173
          if: steps.release.outputs.released == 'true'
 
        - name: Publish package distributions to GitHub Releases
-         uses: python-semantic-release/upload-to-gh-release@v8.7.0
+         uses: python-semantic-release/upload-to-gh-release@COMMIT_HASH  # v8.0.0
          if: steps.release.outputs.released == 'true'
          with:
            github_token: ${{ secrets.GITHUB_TOKEN }}

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-semantic-release"
-version = "10.5.2"
+version = "10.6.0"
 description = "Automatic Semantic Versioning for Python projects"
 requires-python = "~= 3.8"
 license = { text = "MIT" }
@@ -48,7 +48,7 @@ semantic-release = "semantic_release.__main__:main"
 psr = "semantic_release.__main__:main"
 
 [project.urls]
-changelog = "https://github.com/python-semantic-release/python-semantic-release/blob/master/CHANGELOG.md"
+changelog = "https://python-semantic-release.readthedocs.io/en/stable/misc/psr_changelog.html"
 documentation = "https://python-semantic-release.readthedocs.io"
 homepage = "https://python-semantic-release.readthedocs.io"
 issues = "https://github.com/python-semantic-release/python-semantic-release/issues"
@@ -409,6 +409,7 @@ sections = { "tests" = ["tests"] }
 ignore_names = ["change_to_ex_proj_dir", "init_example_project"]
 
 [tool.semantic_release]
+add_partial_tags = true
 logging_use_named_masks = true
 commit_parser = "conventional"
 commit_parser_options = { parse_squash_commits = true, ignore_merge_commits = true }
@@ -424,8 +425,8 @@ build_command = """
 major_on_zero = true
 version_variables = [
   "src/gh_action/requirements.txt:python-semantic-release:nf",
-  "docs/configuration/automatic-releases/github-actions.rst:python-semantic-release/python-semantic-release:tf",
-  "docs/configuration/automatic-releases/github-actions.rst:python-semantic-release/publish-action:tf",
+  "docs/configuration/automatic-releases/github-actions.rst:python-semantic-release/python-semantic-release@COMMIT_HASH  #:tf",
+  "docs/configuration/automatic-releases/github-actions.rst:python-semantic-release/publish-action@COMMIT_HASH  #:tf",
 ]
 version_toml = ["pyproject.toml:project.version"]
 

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/src/python_semantic_release.egg-info/SOURCES.txt

@@ -108,6 +108,7 @@ src/semantic_release/version/translator.py
 src/semantic_release/version/version.py
 src/semantic_release/version/declarations/__init__.py
 src/semantic_release/version/declarations/enum.py
+src/semantic_release/version/declarations/file.py
 src/semantic_release/version/declarations/i_version_replacer.py
 src/semantic_release/version/declarations/pattern.py
 src/semantic_release/version/declarations/toml.py
@@ -231,5 +232,6 @@ tests/unit/semantic_release/version/test_algorithm.py
 tests/unit/semantic_release/version/test_translator.py
 tests/unit/semantic_release/version/test_version.py
 tests/unit/semantic_release/version/declarations/__init__.py
+tests/unit/semantic_release/version/declarations/test_file_declaration.py
 tests/unit/semantic_release/version/declarations/test_pattern_declaration.py
 tests/unit/semantic_release/version/declarations/test_toml_declaration.py

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/src/semantic_release/cli/commands/generate_config.py

@@ -1,6 +1,8 @@
 from __future__ import annotations
 
 import json
+import sys
+from typing import Literal
 
 import click
 import tomlkit
@@ -31,7 +33,9 @@ from semantic_release.cli.config import RawConfig
         "'semantic_release'"
     ),
 )
-def generate_config(fmt: str = "toml", is_pyproject_toml: bool = False) -> None:
+def generate_config(
+    fmt: Literal["toml", "json"], is_pyproject_toml: bool = False
+) -> None:
     """
     Generate default configuration for semantic-release, to help you get started
     quickly. You can inspect the defaults, write to a file and then edit according to
@@ -42,14 +46,29 @@ def generate_config(fmt: str = "toml", is_pyproject_toml: bool = False) -> None:
     """
     # due to possible IntEnum values (which are not supported by tomlkit.dumps, see sdispater/tomlkit#237),
     # we must ensure the transformation of the model to a dict uses json serializable values
-    config = RawConfig().model_dump(mode="json", exclude_none=True)
+    config_dct = {
+        "semantic_release": RawConfig().model_dump(mode="json", exclude_none=True)
+    }
 
-    config_dct = {"semantic_release": config}
-    if is_pyproject_toml and fmt == "toml":
-        config_dct = {"tool": config_dct}
+    if is_pyproject_toml:
+        output = tomlkit.dumps({"tool": config_dct})
 
-    if fmt == "toml":
-        click.echo(tomlkit.dumps(config_dct))
+    elif fmt == "toml":
+        output = tomlkit.dumps(config_dct)
 
     elif fmt == "json":
-        click.echo(json.dumps(config_dct, indent=4))
+        output = json.dumps(config_dct, indent=4)
+
+    else:
+        raise ValueError(f"Unsupported format: {fmt}")
+
+    # Write output directly to stdout buffer as UTF-8 bytes
+    # This ensures consistent UTF-8 output on all platforms, especially Windows where
+    # shell redirection (>, >>) defaults to the system encoding (e.g., UTF-16LE or cp1252)
+    # By writing to sys.stdout.buffer, we bypass the encoding layer and guarantee UTF-8.
+    try:
+        sys.stdout.buffer.write(f"{output.strip()}\n".encode("utf-8"))  # noqa: UP012; allow explicit encoding declaration
+        sys.stdout.buffer.flush()
+    except (AttributeError, TypeError):
+        # Fallback for environments without buffer (shouldn't happen in standard Python)
+        click.echo(output)

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/src/semantic_release/cli/commands/publish.py

@@ -6,6 +6,7 @@ import click
 from git import Repo
 
 from semantic_release.cli.util import noop_report
+from semantic_release.errors import AssetUploadError
 from semantic_release.globals import logger
 from semantic_release.hvcs.remote_hvcs_base import RemoteHvcsBase
 from semantic_release.version.algorithm import tags_and_versions
@@ -90,9 +91,13 @@ def publish(cli_ctx: CliContextObj, tag: str) -> None:
         )
         return
 
-    publish_distributions(
-        tag=tag,
-        hvcs_client=hvcs_client,
-        dist_glob_patterns=dist_glob_patterns,
-        noop=runtime.global_cli_options.noop,
-    )
+    try:
+        publish_distributions(
+            tag=tag,
+            hvcs_client=hvcs_client,
+            dist_glob_patterns=dist_glob_patterns,
+            noop=runtime.global_cli_options.noop,
+        )
+    except AssetUploadError as err:
+        click.echo(err, err=True)
+        ctx.exit(1)

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/src/semantic_release/cli/commands/version.py

@@ -753,6 +753,7 @@ def version(  # noqa: C901
                 project.verify_upstream_unchanged(
                     local_ref="HEAD~1",
                     upstream_ref=config.remote.name,
+                    remote_url=remote_url,
                     noop=opts.noop,
                 )
             except UpstreamBranchChangedError as exc:

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/src/semantic_release/cli/config.py

@@ -57,6 +57,7 @@ from semantic_release.errors import (
 )
 from semantic_release.globals import logger
 from semantic_release.helpers import dynamic_import
+from semantic_release.version.declarations.file import FileVersionDeclaration
 from semantic_release.version.declarations.i_version_replacer import IVersionReplacer
 from semantic_release.version.declarations.pattern import PatternVersionDeclaration
 from semantic_release.version.declarations.toml import TomlVersionDeclaration
@@ -757,12 +758,22 @@ class RuntimeContext:
             ) from err
 
         try:
-            version_declarations.extend(
-                PatternVersionDeclaration.from_string_definition(
-                    definition, raw.tag_format
+            for definition in iter(raw.version_variables or ()):
+                # Check if this is a file replacement definition (pattern is "*")
+                parts = definition.split(":", maxsplit=2)
+                if len(parts) >= 2 and parts[1] == "*":
+                    # Use FileVersionDeclaration for entire file replacement
+                    version_declarations.append(
+                        FileVersionDeclaration.from_string_definition(definition)
+                    )
+                    continue
+
+                # Use PatternVersionDeclaration for pattern-based replacement
+                version_declarations.append(
+                    PatternVersionDeclaration.from_string_definition(
+                        definition, raw.tag_format
+                    )
                 )
-                for definition in iter(raw.version_variables or ())
-            )
         except ValueError as err:
             raise InvalidConfiguration(
                 str.join(

{python_semantic_release-10.5.2 → python_semantic_release-10.6.0}/src/semantic_release/cli/util.py

@@ -75,7 +75,7 @@ def load_raw_config_file(config_file: Path | str) -> dict[Any, Any]:
     while trying to read the specified configuration file
     """
     logger.info("Loading configuration from %s", config_file)
-    raw_text = (Path() / config_file).resolve().read_text(encoding="utf-8")
+    raw_text = (Path() / config_file).resolve().read_text(encoding="utf-8-sig")
     try:
         logger.debug("Trying to parse configuration %s in TOML format", config_file)
         return parse_toml(raw_text)