Releases¶
The steps of a public release, version 1.0 first. They are the author’s: the files they
use are ready in the repository (CITATION.cff, paper/, packaging/conda-forge/,
.readthedocs.yaml), but nothing is published before these steps.
Before the first public release¶
Rights. In France the economic rights to software written by employees in the course of their duties belong to the employer (Code de la propriété intellectuelle, art. L113-9, extended to people with research missions), so that the holder of the rights and the licence had to be confirmed with the institution. Done on 2026-11-17: the author holds the rights, and the institution confirmed it (decision D1 of the specification). Done on 2026-11-18: the copyright lines (
README.md,docs/conf.py) name the holder, Justin Dirrenberger, as doCITATION.cffand the authors ofpyproject.toml.Identifiers. The ORCID of each author in
CITATION.cff(orcid:) and inpaper/paper.md, and if wished the ROR identifier of the affiliation. Done on 2026-11-18: 0000-0002-3964-305X (Justin Dirrenberger); no ROR identifier.Branch. The development branch merged into
main. Done on 2026-11-01: pull request #2 merged the development line, up to91d8987, intomain(merge commit9a6b660, morphoGen 0.6).Repository. Made public, with its issue tracker open: JOSS asks that anyone can read the code and file issues without registering for anything else. Done on 2026-11-18.
Each release¶
Version.
src/morphogen/_version.py; the section ofCHANGELOG.md(## X.Y.Z — date);versionanddate-releasedinCITATION.cff. For 1.0, the classifierDevelopment Status :: 5 - Production/Stableinpyproject.toml, and the classifierPrivate :: Do Not Uploadremoved (PyPI refuses any upload while it is there).Checks.
tools/ci_local.shand the GitHub workflow pass;python -m buildwrites the source archive and the wheel, whichpython -m twine check dist/*accepts.Tag.
git tag -a vX.Y.Z -m "morphoGen X.Y.Z",git push origin vX.Y.Z, and a GitHub release of the tag with the section of the change log.DOI. Zenodo’s GitHub integration, switched on for the repository before the release (zenodo.org, GitHub, the repository), archives each GitHub release with the metadata of
CITATION.cffand gives it a DOI. The DOI of all versions (the concept DOI) then goes inCITATION.cff(doi:), in the README and in Citing morphoGen. For 1.0.0 (2026-11-18): 10.5281/zenodo.24340316, all the versions 10.5281/zenodo.24340315.PyPI. The workflow
.github/workflows/release.ymlbuilds the archives of each published GitHub release, checks them and uploads them by trusted publishing: a publisher declared once on pypi.org for the projectmorphogen(ownerjdirr, repositorymorphoGen, workflowrelease.yml), no token in the repository. By hand otherwise:python -m twine upload dist/*with an API token of the project.conda-forge. For the first release, a pull request to
conda-forge/staged-recipesthat addsrecipes/morphogen/recipe.yaml, copied frompackaging/conda-forge/recipe.yamlwith the version and the sha256 of the source archive on PyPI; the bot of the feedstock then follows the next releases on PyPI.Documentation site. GitHub Pages publishes the site of
mainat each push (.github/workflows/docs.yml, https://jdirr.github.io/morphoGen/), since 2026-11-18. Read the Docs would builddocs/with.readthedocs.yamlfor each version as well, once the repository is imported there.
Paper for JOSS¶
paper/paper.md and paper/paper.bib are a draft for the
Journal of Open Source Software, in the form its guidelines ask
(750 to 1750 words; Summary, Statement of need, State of the field, Software design,
Research impact statement, AI usage disclosure). JOSS reviews software whose repository
has been public for more than six months, with active development over that period,
that is used for research, ideally by others, and, with a single author, that shows its
open practice (public history, releases and change log, tests and continuous
integration, documentation, contribution guide, stated support). The submission
therefore comes six months after the repository is made public at the earliest; the
research impact statement grows meanwhile with the papers that use morphoGen. The AI
usage disclosure names the tools and their versions, where and how they were used, and
states that the human authors reviewed and validated what they produced and made the
design decisions; a disclosure found incomplete may lead to a rejection. JOSS’s Docker
image (openjournals/inara) checks that the paper compiles, and the accepted paper
needs the DOI of the reviewed version (step 4 above).