Skip to main content

GASP (Graphics API for Students of Python)

Project description

GASP (Graphics API for Students of Python)

GASP is built on Tkinter and Pygame graphics. It was not written from scratch but was instead derived directly from the Livewires library, and is thus released under the same free software license covering the original source:

GASP has been ported to Python 3.

GASP is designed to enable absolute beginners to write 1980's style arcade games as an introduction to python.


There is an excellent coursebook which goes over learning to use GASP in your own applications.

Code style: black


GASP should be available in PyPI. To install it:

$ python3 -m pip install gasp

To also obtain the GASP games extension:

$ python3 -m pip install gasp[games]


GASP for beginners is built on Tkinter and is meant to be imported using:

from gasp import *

GASP games is built on Pygame and is meant to be imported using:

from gasp import games

Because of this, to reference anything in beginners GASP, you can simply reference that object e.g. begin_graphics(). However, to reference an object in GASP games, you must preface it with games. e.g. games.Screen()


The tests directory contains tests for GASP. For API level functional tests, from inside the same directory where this README file is located, run:

GASP API test:

$ python3 -m doctest tests/test_gasp_api.rst

GASP games API test:

$ python3 -m doctest tests/test_games_api.rst

If your terminal is empty after running these commands, rest easy knowing GASP is perfect.

To visually inspect the graphics rendering, run:

$ python3 tests/


This software is licensed under the GPL License found in this distribution.


GASP using Tkinter is designed to not require any further installations, so nothing beyond the Python Standard Library ( is needed. However, GASP using Pygame requires the installation of Pygame. Please see the documentation for guidance on how to do that.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gasp-0.6.2.tar.gz (43.5 kB view hashes)

Uploaded source

Built Distribution

gasp-0.6.2-py3-none-any.whl (45.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page