version-cutting.md

(For maintainers) How to cut a new version

This is a checklist (mostly for me) on how to cut a new version of MistQL.

1. Cut a new branch from main named X.Y.Z
2. Update the CHANGELOG
3. Update the version in py/mistql/__init__.py
4. Update the version in py/pyproject.toml
5. Update the version in js/package.json
6. Update the version in meta.json
7. Build the python via talc build py to update the version in the wheel.
8. One final test via talc test all
9. Commit the changes (You should have 6 files changed)
10. Publish the npm and pypi packages via talc publish js and talc publish py
11. Update the doc version of MistQL
12. Version the docs via npm run docusaurus docs:version X.Y.Z
13. Commit the changes
14. Push the branch
15. Create a PR and merge it

Notes:

• Beta versions are formatted as X.Y.Z-beta.N for JS and X.Y.ZbN for Python, starting with N=1.