ponghat 1.0.1

|Cisco Logo| PongHAT
====================

|License| |Version|

PongHAT is a Pong game running on a Raspberry Pi 3 using functionalities
from the Sense HAT.

.. raw:: html

<p align="center">

.. raw:: html

</p>

This game offers two modes:

- A first one, available during the first two levels where the player
plays against a wall.

- A second, from the third level, allowing artificial intelligence (AI)
to appear in the game, increasing the similarities with the
traditional pong game.

**NOTE:** the speed of the game gradually increases with each game.
Similarly, it increases as you move to the next level.

--------------

Installation
~~~~~~~~~~~~

It’s as simple as that:

::

pip install ponghat

--------------

Usage
~~~~~

After being connected to the Raspberry using the Sense HAT and installed
``ponghat``, execute the following command to start a game:

::

ponghat

Alternatively you can run this tool using Docker:

.. code:: bash

# Build the image
docker build -t ponghat .

# Run the image
docker run -v $(pwd):/app ponghat python ponghat.py

**NOTE:** if you don’t have any Sense HAT, you can use a `Sense HAT
emulator <https://trinket.io/sense-hat>`__.

--------------

Contributions
~~~~~~~~~~~~~

There are many ways to contribute. For example, by submitting a bug by
opening an issue in the issue tracker, or by making a pull request.
Ideas that can be implemented is adding particles, refactoring code,
etc.

--------------

License
~~~~~~~

Code is under the `MIT
License <https://github.com/rememberYou/pypong/blob/master/LICENSE>`__.

.. |Cisco Logo| image:: assets/logo.png
.. |License| image:: https://img.shields.io/badge/License-MIT-green.svg
.. |Version| image:: https://img.shields.io/badge/version-1.0.1-blue.svg