Skip to content

Release Notes

wj-publish 1.0.0 Beta 4 - 13 Sep 2026

Project URLs corrected following the move to GitHub; the documentation link now points at the versioned latest/ path.

wj-publish 1.0.0 Beta 3 - 25 May 2026

  • Initial release
  • Publishes WaterJuice build artifacts: platform wheels to PyPI and documentation to the git repository that Cloudflare Pages serves
  • Point it at the build directory (wj-publish output/); it finds the .whl files and the <project>-<version>-docs.zip
  • PyPI upload via twine, with token authentication and the token redacted from error output
  • Documentation publishing (git mode) maintains its own cached clone of the docs repository, extracts <project>-<version>-docs.zip into <project>/<version>/, optionally runs a configured index_command (the WaterJuice docs repo uses its own tools/gen_index.py), then commits and pushes
  • The cached clone is treated as disposable — cloned on first use, otherwise fetched and hard-reset to the remote
  • JSON profile configuration (~/.config/wj-publish/config.json) modelled on cal-publish-python, with WJ_PUBLISH_* environment variable overrides for env-only operation in CI
  • Profile selection via --profile/-p, $WJ_PUBLISH_PROFILE, or [tool.wj-publish] in pyproject.toml
  • Explicit docs.mode (currently only git) recorded in config so other methods can be added later without a breaking change; docs.index_command is optional
  • --pypi-only / --docs-only to limit what is published, --force to overwrite an existing docs version, and --example-config to print a starter config
  • Colourised help via the borrowed argbuilder parser
  • Pure-Python package distributed as a wheel (pip install wj-publish / uvx wj-publish); requires Python 3.12+ and git at runtime