release: cut v1.0.0

Prepare the first public 1.0.0 release and finish the remaining CI hardening work.

Highlights:
- align Python, Rust, WASM, Conda, API, MCP, and docs version metadata to 1.0.0
- promote package metadata to Production/Stable and update stability/versioning docs for the stable series
- move the accumulated Unreleased notes into a dated 1.0.0 changelog section and keep a fresh top-level Unreleased block
- strengthen the changelog checker so it validates a single top-level Unreleased section
- fix the CI/package support mismatch by declaring Python >=3.10 consistently and gating pandas-ta extras to Python 3.12+
- restore Sphinx autodoc compatibility for documented ferro_ta.<module> imports by registering module aliases
- make the TA-Lib benchmark guardrail less flaky by checking median and tail-percentile speedups instead of failing on a single mild outlier
- switch PyPI publishing to OIDC-only trusted publishing and wire the changelog check into the required CI gate
- apply the Ruff-driven cleanup across the Python and test tree and refresh uv/cargo lockfiles

Validated locally:
- python3 scripts/check_changelog.py
- uv run --with ruff ruff check python tests
- uv run --with ruff ruff format --check python tests
- uv lock --check
- sphinx-build -b html docs docs/_build -W --keep-going
- build/install the ferro_ta 1.0.0 wheel successfully
This commit is contained in:
Pratik Bhadane
2026-03-23 23:57:30 +05:30
parent 7a5a220dfe
commit 307beeca02
47 changed files with 1822 additions and 573 deletions
+13 -14
View File
@@ -22,13 +22,13 @@ Currently supported: **3.10, 3.11, 3.12, 3.13** (see `pyproject.toml`).
## Release playbook
1. **Bump the version** in `Cargo.toml` and `pyproject.toml` to the new version
(e.g. `0.2.0`).
(e.g. `1.0.1`).
2. **Update `CHANGELOG.md`**: move the `[Unreleased]` block to a new dated section
`[0.2.0] — YYYY-MM-DD` and open a fresh `[Unreleased]` block.
`[1.0.1] — YYYY-MM-DD` and open a fresh `[Unreleased]` block.
3. **Commit** the version bump and changelog update with message
`chore: release v0.2.0`.
4. **Create a tag**: `git tag v0.2.0 && git push origin v0.2.0`.
5. **Create a GitHub Release** for tag `v0.2.0` — the CI `build-wheels` and
`chore: release v1.0.1`.
4. **Create a tag**: `git tag v1.0.1 && git push origin v1.0.1`.
5. **Create a GitHub Release** for tag `v1.0.1` — the CI `build-wheels` and
`publish` jobs trigger automatically on `release: published`.
## Breaking-change policy
@@ -47,10 +47,10 @@ touch `src/`, `python/`, or `wasm/`.
---
## API Stability Guarantees (v1.0 preparation)
## API Stability Guarantees
The following modules are considered **stable API** as of the v0.1.x series and
will not have breaking changes in minor releases:
The following modules are considered **stable API** as of `1.0.0` and will not
have breaking changes in minor releases:
| Module | Stability |
|---|---|
@@ -90,13 +90,12 @@ will not have breaking changes in minor releases:
- [x] Configuration defaults API
- [x] Jupyter notebook examples
### Path to v1.0
### Post-1.0 notes
When the v1.0 release is cut:
1. Remove any `Beta` classifiers from `pyproject.toml`.
2. Update `CHANGELOG.md` with the `[1.0.0]` release section.
3. Update this file to reflect stable status.
4. Consider adding `Stable :: Stable` PyPI classifier.
With `1.0.0` released:
1. The package now uses the `Development Status :: 5 - Production/Stable` classifier.
2. `CHANGELOG.md` now contains the `[1.0.0]` release section.
3. This file now reflects the stable-series SemVer contract.
### Compatibility matrix