2D Game Library
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
demo
docs
etc
logo
requirements
sappho
tests
.gitignore
.travis.yml
AUTHORS.md
CONTRIBUTING.md
LICENSE
README.md
distrib.sh
game-demo.gif
setup.cfg
setup.py

README.md

Sappho Logo (A Lyre)

GitHub license PyPI Version Code Climate Travis Coverage Status

Sappho is a 2D game engine written with Python (2 and 3) and pygame.

sappho in action

Lily Seabreeze is this project's mom and owner. Be sure to checkout the AUTHORS.md!

Design Philosophy

  1. Don't interfere with the way people build their pygame games
  2. We are not automating game logic
  3. Sappho modules may not import other Sappho modules
  4. Inherit from pygame objects when possible; use conventional pygame models/architecture.
  5. Consistency.
  6. Simplicity trumps all else.
  7. Well documented.
  8. Code is easy-to-test. We show that with our 100% test coverage.

For more check CONTRIBUTING.md.

Getting Started

Install pygame:

  • You can try pip install hg+http://bitbucket.org/pygame/pygame but it may not work...
  • Ubuntu, Python 2.7: sudo apt install python-pygame
  • FreeBSD, Python 2.7: sudo pkg install py27-game
  • OSX, Python 2.7: available in homebrew (note that there is a caveat in El Capitan [see: #63])
  • For any other operating system, or more details, see: http://www.pygame.org/download.shtml

Install sappho and run the demo:

  1. Install: pip install -r requirements/main.txt .
  2. cd demo/
  3. python demo.py

Be sure to checkout the contents of demo.py for a sample on how Sappho is used.

We also have some good docs: http://sappho.lillian.link/

If you wanna contribute, please read CONTRIBUTING.md!