8000 Record the 0.6.0 publication, add the Zenodo DOI, open 0.6.1.dev0 by rafatahmed · Pull Request #157 · rafatahmed/Flahax · GitHub
[go: up one dir, main page]

Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ each release, with numbers, sources and decisions, are in

## [Unreleased]

### Added

- The Zenodo DOI in `CITATION.cff` and the README: concept DOI 10.5281/zenodo.23605678, version 0.6.0 10.5281/zenodo.23605679.

## [0.6.0] - 2026-10-24

The grower release: FlahaX becomes a tool a grower or agronomist can run without code
Expand Down
9 changes: 9 additions & 0 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,14 @@ contact:
affiliation: Flaha Agri Tech
version: 0.6.0
date-released: "2026-10-24"
doi: 10.5281/zenodo.23605678
identifiers:
- type: doi
value: 10.5281/zenodo.23605678
description: Concept DOI, all versions (Zenodo)
- type: doi
value: 10.5281/zenodo.23605679
description: Version 0.6.0 (Zenodo)
url: https://flahax.readthedocs.io/
repository-code: https://github.com/rafatahmed/Flahax
repository-artifact: https://pypi.org/project/flahax/
Expand Down Expand Up @@ -59,6 +67,7 @@ preferred-citation:
orcid: https://orcid.org/0009-0009-4692-4552
year: 2026
version: 0.6.0
doi: 10.5281/zenodo.23605679
url: https://pypi.org/project/flahax/
repository-code: https://github.com/rafatahmed/Flahax
license: Apache-2.0
Expand Down
9 changes: 6 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ equilibrium chemistry and auditable delivery planning.**
[![Tests](https://github.com/rafatahmed/Flahax/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/rafatahmed/Flahax/actions/workflows/test.yml)
[![Documentation](https://readthedocs.org/projects/flahax/badge/?version=latest)](https://flahax.readthedocs.io/en/latest/)
[![codecov](https://codecov.io/gh/rafatahmed/Flahax/branch/main/graph/badge.svg)](https://codecov.io/gh/rafatahmed/Flahax)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.23605678.svg)](https://doi.org/10.5281/zenodo.23605678)
[![PyPI Downloads](https://static.pepy.tech/personalized-badge/flahax?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/flahax)

FlahaX turns a crop's nutrient formula and the grower's actual water into a fertilizer recipe,
Expand Down Expand Up @@ -216,21 +217,23 @@ Live PHREEQC replay and distribution verification are described in

## Citation

Al Khashan, R. A. (2026). *FlahaX* (Version 0.6.0) [Computer software].
https://pypi.org/project/flahax/
Al Khashan, R. A. (2026). *FlahaX* (Version 0.6.0) [Computer software]. Zenodo.
https://doi.org/10.5281/zenodo.23605679

```bibtex
@software{alkhashan2026flahax,
author = {Al Khashan, Rafat A.},
title = {FlahaX: plant-nutrient chemistry engine for fertilizer formulation and delivery planning},
year = {2026},
version = {0.6.0},
doi = {10.5281/zenodo.23605679},
url = {https://pypi.org/project/flahax/},
license = {Apache-2.0}
}
```

GitHub's "Cite this repository" button reads
To cite whichever version you used, the concept DOI [10.5281/zenodo.23605678](https://doi.org/10.5281/zenodo.23605678) always
resolves to the latest release. GitHub's "Cite this repository" button reads
[`CITATION.cff`](https://github.com/rafatahmed/Flahax/blob/main/CITATION.cff).

## Author and credits
Expand Down
16 changes: 10 additions & 6 deletions docs/publishing.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,12 +104,12 @@ Dashboard settings, recorded here because they live outside the repository:
- [x] Pass local tests with live PHREEQC and isolated wheel/sdist verification.
- [x] Observe successful hosted checks on the merged revision (Linux 3.11-3.14, Windows and macOS 3.13).
- [x] Date the changelog, the manual's version line and `CITATION.cff` (2026-10-24), and merge, before tagging (#71).
- [ ] Obtain explicit publication authorization.
- [ ] Publish the `v0.6.0` GitHub Release; review the run; approve the deployment.
- [ ] Verify PyPI metadata and a fresh installed-package check; record the date, run and hashes.
- [ ] Confirm the Read the Docs `stable` version builds `v0.6.0`.
- [ ] Zenodo: confirm the archived version and its DOI; add the concept DOI to `CITATION.cff` and the README.
- [ ] Open 0.6.1.dev0 on `main` (step 7; closes #134 with the README reinstall note).
- [x] Obtain explicit publication authorization.
- [x] Publish the `v0.6.0` GitHub Release; review the run; approve the deployment.
- [x] Verify PyPI metadata and a fresh installed-package check; record the date, run and hashes.
- [x] Confirm the Read the Docs `stable` version builds `v0.6.0`.
- [x] Zenodo: confirm the archived version and its DOI; add the concept DOI to `CITATION.cff` and the README.
- [x] Open 0.6.1.dev0 on `main` (step 7; closes #134 with the README reinstall note).

## Checklist (0.5.0)

Expand Down Expand Up @@ -163,6 +163,10 @@ package was uploaded.

## Release history

- **0.6.0**, 2026-10-24: published through the hardened workflow (run `40032809873`) from
`03e03ef`, after the finalize step (#156); the deployment was approved by the owner, verified by
a fresh installation from PyPI, and archived on Zenodo (10.5281/zenodo.23605679). See the
[0.6.0 publication evidence](site/evidence/release-evidence.md).
- **0.5.0**, 2026-10-20: published through the hardened workflow (run
`39517327774`) from `692108b`; the deployment was approved at the owner's
instruction after artifact review, and verified by a fresh installation from
Expand Down
23 changes: 23 additions & 0 deletions docs/site/evidence/release-evidence 8000 .md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,29 @@ They are kept here because the records cite them.
| 0.3.1 | 2026-10-17 | Published | [Publication](#031-publication-2026-10-17), [release audit](#031-release-audit-2026-10-17), [documentation audit](#031-documentation-audit-2026-10-02), [preparation](#031-preparation-2026-10-01) |
| 0.3.0 | 2026-09-27 | Yanked 2026-10-17 | [Publication exception](#030-authorized-publication-exception-2026-09-27), [automated evidence](#030-automated-evidence), [P2/P3 acceptance](#p2p3-end-to-end-numerical-acceptance), [continuation](#package-and-delivery-continuation-2026-09-27), [cleanup](#030-release-readiness-cleanup), [preparation](#030-preparation) |

## 0.6.0 publication (2026-10-24)

0.6.0 was published to PyPI on **2026-10-24** (22:24 UTC on 2026-10-23) by the hardened release
workflow ([run 40032809873](https://github.com/rafatahmed/Flahax/actions/runs/40032809873)), triggered by the GitHub Release for tag `v0.6.0` on `main` at
`03e03ef` (merge of #156, the finalize step). Hosted CI on that commit had passed on Linux
(Python 3.11-3.14), Windows and macOS (3.13), with the docs build and the live PHREEQC replay.

| Check | Result |
|---|---|
| Release guard | Tag `v0.6.0` matched `pyproject.toml`; 0.6.0 was new on PyPI |
| Workflow tests | Python 3.11, 3.12, 3.13 and 3.14 and the live PHREEQC replay passed on the tagged commit |
| Approval | The owner approved the `pypi` deployment after the gates passed |
| PyPI upload | Wheel 22:24:31 UTC (288,855 bytes); sdist 22:24:33 UTC (5,437,125 bytes). PyPI reports 0.6.0 with licence `Apache-2.0`, `Requires-Python >=3.11`, Development Status 4 - Beta, no runtime dependency, not yanked |
| Fresh install from PyPI | New Python 3.14 virtual environment outside the checkout, `pip install flahax==0.6.0`: `flahax --version` prints FlahaX 0.6.0; 135 public names; the README example meets every target within 1 %; the packaged manual is the 0.6.0 manual; `flahax batch` writes the sheet, report and summary; `flahax mix --help` lists `--plain` |
| Documentation | Read the Docs `stable` serves the restructured site (#155); old addresses such as `growers.html` redirect |
| Archive | Zenodo version DOI [10.5281/zenodo.23605679](https://doi.org/10.5281/zenodo.23605679); concept DOI [10.5281/zenodo.23605678](https://doi.org/10.5281/zenodo.23605678) |
| Wording | The packaged changelog and manual are dated 2026-10-24 (finalize step, #71) |

| File | SHA-256 |
|---|---|
| `flahax-0.6.0-py3-none-any.whl` | `06954424329c5a128acc713cdbdea7e2e6f8cab7d9447706a74ffd507c1cfa70` |
| `flahax-0.6.0.tar.gz` | `8453b7004844ba6295b57357e3eacc2185e9e8284ce7de2d6971782d052b82a2` |

## 0.5.0 publication (2026-10-20)

0.5.0 was published to PyPI on **2026-10-20** (23:51 UTC) by the hardened release
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"

[project]
name = "flahax"
version = "0.6.0"
version = "0.6.1.dev0"
description = "Fertilizer recipe, pH and acid plan and A/B stock tanks from a water analysis and a crop formula: an interactive command for growers and agronomists on a pure-Python nutrient-chemistry engine checked against PHREEQC."
readme = "README.md"
requires-python = ">=3.11"
Expand Down
2 changes: 1 addition & 1 deletion src/flahax/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@
"load_identities",
"identity_for_product",
]
__version__ = "0.6.0"
__version__ = "0.6.1.dev0"

from .composition import InputError
from .competition import (
Expand Down
2 changes: 1 addition & 1 deletion src/flahax/data/API_REFERENCE.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion src/flahax/data/USER_GUIDE.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# FlahaX 0.6.0 — User Manual
# FlahaX 0.6.1.dev0 — User Manual

Fertilizer formulation • bounded chemistry • reviewed delivery planning

Expand Down
Loading
0