change versioning mechanism

Author: z3rone

.github/workflows/release.yml

@@ -30,16 +30,18 @@ jobs:
       with:
         submodules: recursive
 
-    - name: Set version from tag
+    - name: Verify version matches tag
       if: startsWith(github.ref, 'refs/tags/v')
       shell: bash
       run: |
         TAG_VERSION="${GITHUB_REF#refs/tags/v}"
-        echo "Updating version in Cargo.toml to $TAG_VERSION"
-        if [[ "${{ runner.os }}" == "macOS" ]]; then
-          sed -i '' 's/^version = ".*"/version = "'$TAG_VERSION'"/' native_fisher_py/Cargo.toml
-        else
-          sed -i 's/^version = ".*"/version = "'$TAG_VERSION'"/' native_fisher_py/Cargo.toml
+        # Extract version from Cargo.toml
+        CARGO_VERSION=$(grep -m1 '^version =' native_fisher_py/Cargo.toml | cut -d '"' -f 2)
+        echo "Tag version: $TAG_VERSION"
+        echo "Cargo version: $CARGO_VERSION"
+        if [[ "$TAG_VERSION" != "$CARGO_VERSION" ]]; then
+          echo "Error: Tag version ($TAG_VERSION) does not match Cargo.toml version ($CARGO_VERSION)"
+          exit 1
         fi
 
     - name: Install NativeAOT Dependencies (Linux)

README.md

@@ -90,3 +90,22 @@ maturin develop
 This project is powered by the [**Thermo Fisher Scientific RawFileReader**](https://github.com/thermofisherlsms/RawFileReader) (copyright © 2016-2026 Thermo Fisher Scientific, Inc.). All rights reserved.
 
 The `native-fisher-py` package includes the official RawFileReader libraries, which remain the property of Thermo Fisher Scientific. By using this software, you agree to the terms specified in their [license](https://github.com/thermofisherlsms/RawFileReader/blob/main/License.doc).
+
+## Releasing a New Version
+Releases are fully automated via GitHub Actions (`release.yml`), but the workflow **requires** that the git tag strictly matches the version in `native_fisher_py/Cargo.toml`.
+
+To trigger a new release and publish to PyPI:
+
+1. Update the version in `native_fisher_py/Cargo.toml`.
+2. Commit the version bump.
+3. Create and push a matching git tag:
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+The GitHub Action will automatically:
+1. Verify that the git tag version matches the `Cargo.toml` version (failing otherwise).
+2. Build the native wheels across all platforms (macOS, Linux, Windows).
+3. Publish the final artifacts to PyPI.

native_fisher_py/python/native_fisher_py/__init__.py

@@ -19,6 +19,13 @@
 import os
 import sys
 import platform
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("native-fisher-py")
+except PackageNotFoundError:
+    # package is not installed
+    __version__ = "unknown"
 
 # Find and initialize the native library