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:
https://github.com/livewires/python
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.
Homepage: https://codeberg.org/GASP/GASP_Code
There is an excellent coursebook http://openbookproject.net/pybiblio/gasp/ which goes over learning to use GASP in your own applications.
INSTALLATION
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]
USAGE
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()
TESTS
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/test_graphics.py
LICENSE
This software is licensed under the GPL License found in this distribution.
REQUIREMENTS
GASP using Tkinter is designed to not require any further installations, so nothing beyond the Python Standard Library (https://docs.python.org/3/library/index.html) is needed. However, GASP using Pygame requires the installation of Pygame. Please see the documentation for guidance on how to do that.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.