Skip to content

Release instructions

Kodi Arfer edited this page Dec 9, 2020 · 21 revisions

Short and dirty list of things to do when new version is released.

  1. Check NEWS file and update it if needed. Often this means going through the commits since the previous release
  2. Build and test PyPi package on your local machine (https://packaging.python.org/distributing/ for complete instructions)
    • setup.py hopefully is up to date, but it doesn't hurt to have a look. Especially package_data for hy code
    • git clean -dfx
    • Make sure the new release is tagged (git tag x.y.z -m 'Version x.y.z') and that version.py is up to date (run python3 get_version.py) before making the final distribution packages
    • python3 setup.py sdist to create the source distribution
    • python3 setup.py bdist_wheel --universal to create the wheel
    • Create a new virtualenv and install the created package there for testing
      • virtualenv tenv -p python3 && cd tenv && source ./bin/activate && pip install fastentrypoints && pip install [source distribution file] && deactivate && source ./bin/activate && echo `type hy` && echo '(+ 1 1)' | hy
      • virtualenv tenv -p python3 && cd tenv && source ./bin/activate && pip install fastentrypoints && pip install [wheel distribution file] && deactivate && source ./bin/activate && echo `type hy` && echo '(+ 1 1)' | hy
  3. Tag release in GitHub
  4. Let @paultag and @Kodiologist know that things are ready, either of them can build and upload official package into PyPi
    • twine upload dist/*
  5. Use the new release of Hy for the web console.
  6. Let somebody (@paultag or @tianon for example) know that Debian and Docker releases should be done
  7. Enjoy the new version of Hy and write some cool stuff with it
  8. Don't forget to notify the world that new cool version is available:
Clone this wiki locally