Skip to content

Release 0.14.0 — the distribution is named admina - #84

Merged
stefanoferi merged 4 commits into
mainfrom
docs/admina-package-rename
Oct 7, 2026
Merged

stefanoferi merged 4 commits into
mainfrom
docs/admina-package-rename

Conversation

@stefanoferi

@stefanoferi stefanoferi commented Oct 7, 2026 •

Copy link
Copy Markdown
Member

Minor release with a declared breaking change: Admina is published on PyPI as admina. The module (import admina), the admina command, the extras, admina-core and the container images do not change. The [0.14.0] section of CHANGELOG.md lists every change.

Packaging

  • pyproject.toml: name admina, version 0.14.0; [rust] requires admina-core>=0.14.0,<0.15; uv.lock regenerated (only admina/admina-framework/admina-core entries change).
  • admina-framework ends with 0.14.0: packaging/admina-framework/setup.py stops the installation with the commands to switch; scripts/build-admina-framework-sdist.py builds the sdist. release.yml publishes admina and, on v0.14.0 only, that sdist. The 0.13.2 alias package is removed.

Text

  • Install hints (admina[...]) in error messages, warnings, the plugin template (admina>=<version>), README, docs, MODEL_CARD, CONTRIBUTING, core-rust/README.md, .env.example.
  • New guide docs/guides/package-name.md (linked from the README install section and the docs nav).
  • ROADMAP: 0.14.0 lists the package name; the later sections are removed. SECURITY: 0.14.x supported.

Checks (local)

  • pytest -m "not benchmark": 4554 passed; ruff clean; check-versions.py aligned at 0.14.0; uv lock --check and cargo metadata --locked clean; twine check --strict passes for the admina wheel and sdist and the admina-framework sdist.
  • Clean venvs, pip and uv, 0.14.0 artefacts built as in release.yml:
    • pip install "admina[proxy]": 0.14.0, admina --version, proxy import;
    • admina-framework 0.13.2 from PyPI, then pip install -U admina-framework (and with uv): the message is shown and 0.13.2 stays installed and importable;
    • the commands of the message (uninstall admina admina-framework, install admina), pip and uv: 0.14.0 only;
    • the 0.13.2 alias from PyPI, then pip install -U admina: 0.14.0;
    • a plugin from admina plugin create (admina>=0.14.0) installs;
    • the proxy serves /health with version 0.14.0, blocks an injection on /api/v1/validate, and /api/compliance/report?format=markdown ends with the forensic section.

Merge as a merge commit; tag v0.14.0 on the merge commit after CI on main passes.

docs/guides/package-name.md describes the change of 0.14.0: Admina is
published as admina, and admina-framework ends with a 0.14.0 that stops
the installation with the commands to switch. The guide gives the
releases and package names, the upgrade with pip, uv and dependency
lists, the plugin pyproject line, and the --force-reinstall that restores
the module when admina-framework is uninstalled after admina was
installed over it.

The README install section, the mkdocs navigation, the [Unreleased]
notes and the 0.14.0 roadmap entry point to the guide.
The 0.14.0 entry lists the change of the PyPI package name to admina.
The sections after it (not yet scheduled, 1.0.0, 1.1.0, 2.0.0) are
removed; the roadmap lists the released milestones and the next release.
The README licence row reads Apache 2.0. The init wizard docstring, the
GDPR and NIS2 module docstrings and the MODEL_CARD compliance limits
describe what the code does. The README and CONTRIBUTING links to the
roadmap describe its new content.
The PyPI distribution of the framework is admina (pyproject name, the
full, adapters and all extras, uv.lock). The module, the admina command,
the extras and admina-core keep their names; the [rust] extra requires
admina-core>=0.14.0,<0.15.

admina-framework ends with 0.14.0: packaging/admina-framework holds a
setup.py that stops the installation with the commands to switch, and
scripts/build-admina-framework-sdist.py builds it as a source
distribution (Metadata-Version 2.4) with the version of pyproject.toml.
release.yml publishes admina, and on the v0.14.0 tag the admina-framework
sdist; the alias package of 0.13.2 is removed. tests/test_admina_framework_sdist.py
checks the archive, its metadata and the message.

Install hints in error messages, warnings, the plugin template
(admina>=<version>), the README, the docs, MODEL_CARD, CONTRIBUTING,
core-rust/README.md and .env.example name admina. scripts/check-versions.py
reads the admina entry of uv.lock. The Markdown compliance report of the
proxy ends with the forensic section.

Version 0.14.0 in the eight manifests; CHANGELOG [0.14.0], ROADMAP and
SECURITY (0.14.x supported) updated.
@stefanoferi stefanoferi changed the title docs: announce the admina package name of 0.14.0 Release 0.14.0 — the distribution is named admina Oct 7, 2026
@stefanoferi
stefanoferi merged commit 0b2d332 into main Oct 7, 2026
20 checks passed
@stefanoferi
stefanoferi deleted the docs/admina-package-rename branch October 8, 2026 06:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant