Welcome to pygtails’s documentation!

Contents:

• Library Reference
  • Game
  • GameObject
  • Circle
  • Rectangle
• Hello Pygtails
• Pygame Constants
  • Pygame Keycodes
  • Pygame Key Mod Flags
  • Pygame Display Mode Flags
• Flags and Bitwise Operations Tutorial
  • A Quick Primer on Flags
  • Bitwise Operations
  • Using Bitwise Operations with Flags

About

Pygtails is a simple little extension of the pygame library.

Pygame is a cool game development library made for python, and it has a great community. It has tons of active users contributing to it’s project showcase. A new game is posted there sometimes several times a week, and the majority of the submissions to pyweek seem to be working with pygame.

Despite all of this, it would be a lie to say that the engine has no shortcomings. In my own opinion, the pygame docs are poorly organized and the library itself isn’t as intuitive as it can be. A quick google search will also bring up criticisms of Pygame being slower than other options. In a direct quote from their about page: “It’s not the best game library. It’s not even the second best. But we think it’s sort of ok.”

The Pygtails library attempts to make Pygame a slightly better game library by providing more detailed, organized, and (hopefully) intuitive documentation, as well as by providing some basic front-end functionality present in many popular game engines that Pygame for some reason lacks. One thing that Pygtails does not attempt to do is address the criticisms of Pygame’s slowness.