Releasing clj-physics

This library uses a single source of truth for versions (version.txt) and keeps pom.xml/JARs in sync via make + tools.build.

Prerequisites

• Clojure CLI installed.
• Python 3 available (used in Makefile).
• Clojars credentials configured in ~/.m2/settings.xml (server id clojars) or exported as CLOJARS_USERNAME/CLOJARS_PASSWORD.

Release steps

1. Set the version

   • Edit version.txt with the new version (e.g., 0.1.2).

2. Build

   • Run make jar.
   • This will:
     • Sync pom.xml to version.txt.
     • Run tools.build to produce target/physics-<version>.jar.

3. Test

   • Run clojure -M:test (or make test) and ensure tests pass.

4. Deploy

   • Set credentials if not in settings.xml:
     • export CLOJARS_USERNAME=...
     • export CLOJARS_PASSWORD=...
   • Run make deploy.
   • If the version was already published, you’ll see a 403; bump version.txt and retry.

5. Tag and push

   • Commit changes (version.txt, pom.xml, jar artifacts ignored).
   • Tag: git tag v<version> (e.g., git tag v0.1.2).
   • Push tags: git push --tags (after pushing commits).

Notes

• Version is only edited in version.txt.
• make jar always refreshes pom.xml from version.txt.
• Avoid re-deploying a released version; Clojars rejects redeploys for non-snapshots.