Metadata-Version: 2.1
Name: snakeng
Version: 0.0.1
Summary: Easy-to-use snake game engine. Quickly implement snake for anything!
Home-page: http://github.com/eriknyquist/snakeng
Author: Erik Nyquist
Author-email: eknyquist@gmail.com
License: Apache 2.0
Project-URL: Documentation, https://eriknyquist.github.io/snakeng
Project-URL: Issues, https://github.com/eriknyquist/snakeng/issues
Project-URL: Contributions, https://eriknyquist.github.io/snakeng/#contributions
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.7
License-File: LICENSE
Requires-Dist: keyboard

snakeng
-------

``snakeng`` is an implementation of the back-end of the classic "snake" game. It provides
an interface to inject directional inputs (up/down/right/left), and produces a data structure
representing the game state, for each frame of gameplay. This allows snake to be quickly
implemented and played on various platforms.

Features:

* Configurable game area width/height
* Configurable wall behaviour (teleport/wrap or death)
* Serializable game state object (if you want to e.g. save/load game states to .json files)
* Configurable snake speed options (fixed speed, or automatically increase speed as snake grows)

Install
-------

Install via pip:

::

    pip install snakeng

Sample implementation
---------------------

Additionally, a sample terminal-based implementation of a snake game is provided,
which can be accessed by running ``snakeng`` as a module:

::

    python -m snakeng

.. image:: https://github.com/eriknyquist/snakeng/raw/master/images/terminal_example.gif

The terminal-based implementation accepts several arguments, detailed here:

::

	usage: snakeng [-h] [-x WIDTH] [-y HEIGHT] [-s {slow,medium,fast,faster}]
				   [-f FPS]

	Simple terminal-based snake game showing how to use snakeng to implement a
	game

	options:
	  -h, --help            show this help message and exit
	  -x WIDTH, --width WIDTH
							Game area width in characters (default: 40)
	  -y HEIGHT, --height HEIGHT
							Game area height in characters (default: 30)
	  -s {slow,medium,fast,faster}, --fixed-speed {slow,medium,fast,faster}
							Sets the snake speed for the whole game. If unset, the
							snake speed will automatically increase as the snake
							size increases. (default: None)
	  -f FPS, --fps FPS     Framerate in frames per second (default: 24)

NOTE: the sample implementation uses an ANSI escape sequence to clear the terminal screen,
so it won't work in terminals that don't support ANSI escape sequences.

Contributions
-------------

Contributions are welcome, please open a pull request at `<https://github.com/eriknyquist/snakeng>`_.

If you have any questions about / need help with contributions, please contact Erik at eknyquist@gmail.com.
