chore: exposing version and preparing 0.3.2 release

Author: shano

.gitignore

@@ -8,3 +8,4 @@ __pycache__/
 .idea/
 .vscode/
 tests/__pycache__/
+dist/

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.3.2](https://github.com/syntasso/kratix-python/compare/v0.3.1...v0.3.2) (2025-11-23)
+
+
+### Chores
+
+* setting python 3.10 as minimum required version
+
+## [0.3.1](https://github.com/syntasso/kratix-python/compare/v0.3.0...v0.3.1) (2025-11-23)
+
+
+### Chores
+
+* configuring application for release
+* exposing version in the package
+
+
 ## [0.3.0](https://github.com/syntasso/kratix-python/compare/v0.2.0...v0.3.0) (2025-10-29)
 
 

RELEASING.md

@@ -2,27 +2,37 @@
 
 This document captures the steps for cutting a new version of the SDK and publishing it to PyPI.
 
-1. **Prep the repo**
+1. **Set up Poetry credentials (one-time per machine)**
+   ```bash
+   poetry config repositories.testpypi https://test.pypi.org/legacy/
+   # Use a TestPyPI API token copied from https://test.pypi.org/manage/account/token/
+   poetry config pypi-token.testpypi <TESTPYPI_API_TOKEN>
+   # For the main PyPI token (if not already configured)
+   poetry config pypi-token.pypi <PYPI_API_TOKEN>
+   ```
+   Alternatively export `POETRY_HTTP_BASIC_TESTPYPI_USERNAME="__token__"` and `POETRY_HTTP_BASIC_TESTPYPI_PASSWORD="<token>"` before publishing.
+
+2. **Prep the repo**
    - Update `pyproject.toml` with the new version under `[tool.poetry]`.
    - Add an entry to `CHANGELOG.md` summarising the release and changes.
    - Commit your work before building artifacts.
 
-2. **Run quality checks**
+3. **Run quality checks**
    ```bash
    make install          # installs dependencies
    make fmt && make lint # optional but recommended
    make test             # run pytest
    ```
 
-3. **Build distributions**
+4. **Build distributions**
    ```bash
    poetry build
    ls dist/              # verify the wheel and sdist exist
    tar tf dist/kratix-sdk-<version>.tar.gz | head
    ```
    Inspect the contents to ensure only expected files are included.
 
-4. **Publish to TestPyPI (recommended)**
+5. **Publish to TestPyPI (recommended)**
    ```bash
    poetry publish --repository testpypi --build
    python -m venv /tmp/kratix-sdk-test
@@ -31,15 +41,14 @@ This document captures the steps for cutting a new version of the SDK and publis
    ```
    Run a quick smoke test (`python -c "import kratix_sdk; print(kratix_sdk.__version__)"`) to ensure the build works.
 
-5. **Publish to PyPI**
+6. **Publish to PyPI**
    ```bash
    poetry publish --build
    git tag v<version>
    git push origin main --tags
    ```
    PyPI credentials/API token must be configured in `~/.pypirc` beforehand.
 
-6. **Communicate the release**
+7. **Communicate the release**
    - Share release notes on the relevant channels.
    - Update downstream sample projects if they pin versions.
-

Readme.md

@@ -1,6 +1,6 @@
 # kratix-python
 
-You can read library document [here](https://syntasso.github.io/kratix-python).
+Library documentation can be found [here](https://syntasso.github.io/kratix-python).
 
 ## Installation
 

kratix_sdk/__init__.py

@@ -1,3 +1,5 @@
+from importlib import metadata as importlib_metadata
+
 from .status import Status
 from .resource import Resource
 from .kratix_sdk import (
@@ -12,6 +14,11 @@
 from .promise import Promise
 from .types import GroupVersionKind, DestinationSelector
 
+try:
+    __version__ = importlib_metadata.version("kratix-sdk")
+except importlib_metadata.PackageNotFoundError:  # pragma: no cover - source tree fallback
+    __version__ = "0.0.0"
+
 __all__ = [
     "Status",
     "Resource",
@@ -25,4 +32,5 @@
     "get_output_dir",
     "get_metadata_dir",
     "set_metadata_dir",
+    "__version__",
 ]

poetry.lock

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "kratix-sdk"
-version = "0.3.0"
+version = "0.3.2"
 description = "Kratix SDK for writing Promises workflows"
 readme = "Readme.md"
 authors = ["Syntasso <[email protected]>"]
@@ -20,7 +20,6 @@ classifiers = [
     "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -35,7 +34,7 @@ classifiers = [
 "Changelog" = "https://github.com/syntasso/kratix-python/blob/main/CHANGELOG.md"
 
 [tool.poetry.dependencies]
-python = ">=3.9"
+python = ">=3.10"
 kubernetes = ">=33.0.0,<35"
 PyYAML = ">=6.0.0,<7"