communication

Pyglet communication occurs mostly in our mailing list.

Additionally, we have two other announcement mailing lists:

issue tracker

You can use the issue tracker to report any bug or compatibility issue. You need a Google account for that.

We prefer the tracker to address discussions on specific bugs, and address broader topics of Pyglet in the mailing list.

getting the trunk version

The repository can be found here; it hosts the source trunk, documentation, examples, and development tools. You can get the latest version of the code using:

hg clone https://code.google.com/p/pyglet/ pyglet

contributing to the source

If you want to contribute to Pyglet, we suggest the following:

  1. Create your own clone in the official repository.
  2. Get a local copy of your clone using

    hg clone https://code.google.com/r/<username>-<rep_name>/source/checkout

  3. Commit your modifications and push them to your clone.
  4. Open an ticket in the issue tracker describing your change and link the clone/commit. A project member will review your commit providing feedback and eventually it will be merged into the official repository.

Alternatively you can also create a patch of your changes and attach it to the ticket.

contributing to the documentation

When asking to include your code in the trunk, check that you have addressed its respective documentation, both within the code and the API documentation. It is very important to all of us that the documentation matches the latest code and vice-versa.

Consequently, an error in the documentation, either because it is hard to understand or because it doesn't match the code, is a bug that deserves to be reported on a ticket.

A good way to start contributing to a component of pyglet is by its documentation. When studying the code you are going to work with, also read the associated docs. If you don't understand the code with the help of the docs, it is a sign that the docs should be improved.

contact

pyglet is developed by many individual volunteers, and there is no central point of contact. If you have a question about developing with pyglet, or you wish to contribute, please join the mailing list.

For legal issues, please contact Alex Holkner. You can reach him via email at Alex.Holkner@gmail.com.