Metadata-Version: 2.1
Name: xoinvader
Version: 0.1.2
Summary: (not so) small python curses space game
Home-page: https://github.com/pkulev/xoinvader
License: MIT
Keywords: curses,space,game
Author: Pavel Kulyov
Author-email: kulyov.pavel@gmail.com
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console :: Curses
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Games/Entertainment :: Arcade
Classifier: Topic :: Software Development :: Libraries :: pygame
Requires-Dist: pygame
Requires-Dist: tornado (>=4,<5)
Project-URL: Documentation, http://mmap.me/
Project-URL: Repository, https://github.com/pkulev/xoinvader
Description-Content-Type: text/x-rst

|Build Status| |codecov.io|

=========
XOInvader
=========

Attempt to create small but serious game using **python** and
**ncurses**.

Requirements
============

General
-------

* Python3
* Tornado 4.x
* ncurses >=5.9

Optional requirements (for graphics)
------------------------------------

* Pygame >=1.9.0 (pygame.Mixer)
* SDL with devel (for compiling pygame from sources)
* gcc with devel (for compiling pygame from sources)
* python devel files (for compiling pygame from sources)


Development
===========

Installation
------------

.. code-block:: console

   # install virtualenv
   $ make devel
   $ source .venv/bin/activate
   $ pip install -e .

   $ xoigame  # ASCII with sound (Pygame.Mixer required)
   $ xoigame -ns  # ASCII without sound (pygame not required)
   $ xoigame -vd pygame-sdl  # Pygame-based version

Testing
-------

.. code-block:: console

   $ make test  # for all tests
   $ make view_cov  # run all tests and view coverage
   $ # pass additional arguments to pytest via PYTEST_ARGS env variable
   $ # you can pass args such way to test and view_cov make targets
   $ make test PYTEST_ARGS='-m "not slow"'  # don't run slow tests
   $ py.test --markers  # show all markers
   $ py.test xoinvader/path/to/test_file.py  # run separate file


Documentation
-------------

* Autogenerated from sources `here <http://www.g-v.im/>`__.
* Development `wiki <https://github.com/pkulev/xoinvader/wiki/>`_.
* Build documentation from sources:

  .. code-block:: console

     $ make docs
     $ make view_docs  # build and open in firefox


.. |Build Status| image:: https://travis-ci.org/pkulev/xoinvader.svg?branch=master
   :target: https://travis-ci.org/pkulev/xoinvader
.. |codecov.io| image:: http://codecov.io/github/pkulev/xoinvader/coverage.svg?branch=master
   :target: http://codecov.io/github/pkulev/xoinvader?branch=master

