Making a pyglet release

  1. Clone pyglet into a new directory

  2. Make sure it is up to date:

    git pull
    
  3. Update version string in the following files and commit:

    • pyglet/__init__.py
    • doc/conf.py
  4. Tag the current changelist with the version number:

    git tag -a v0.0.0 -m "release message"
    
  5. Push the changes to the central repo:

    git push
    git push --tags
    
  6. Build the wheels and documentation:

    ./make.py clean
    ./make.py dist
    
  7. Upload the wheels and zips to PyPI:

    twine upload dist/pyglet-x.y.z*
    
  8. Start a build of the documentation on https://readthedocs.org/projects/pyglet/builds/

  9. Draft a new release on Github, using the same version number https://github.com/pyglet/pyglet/releases

  10. Tell people!

Major version increase

When preparing for a major version you might also want to consider the following:

  • Create a maintenance branch for the major version
  • Add a readthedocs configuration for that maintenance branch
  • Point the url in setup.py to the maintenance branch documentation