Metadata-Version: 2.1
Name: tetris
Version: 1.0.0a0
Summary: Simple and modular tetris library
Home-page: https://github.com/dzshn/python-tetris
License: MIT
Keywords: tetris,stacker
Author: Sofia N. Lima
Author-email: me@dzshn.xyz
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Provides-Extra: docs
Requires-Dist: Sphinx (>=4.4,<6.0) ; extra == "docs"
Requires-Dist: furo (>=2022.3.4,<2023.0.0) ; extra == "docs"
Requires-Dist: numpydoc (>=1.2,<2.0) ; extra == "docs"
Project-URL: Documentation, https://python-tetris.readthedocs.io/
Project-URL: Repository, https://github.com/dzshn/python-tetris
Description-Content-Type: text/markdown

# python-tetris: a simple and modular tetris library

[![pypi](https://img.shields.io/pypi/v/tetris?logo=pypi&logoColor=f0f0f0&style=for-the-badge)](https://pypi.org/project/tetris/)
[![python-versions](https://img.shields.io/pypi/pyversions/tetris?logo=python&logoColor=f0f0f0&style=for-the-badge)](https://pypi.org/project/tetris/)
[![downloads](https://img.shields.io/pypi/dm/tetris?style=for-the-badge)](https://pypi.org/project/tetris/)
[![build](https://img.shields.io/github/workflow/status/g3ner1c/python-tetris/Test%20library?logo=github&logoColor=f0f0f0&style=for-the-badge)](https://github.com/g3ner1c/python-tetris/actions/workflows/test.yml)
[![docs](https://img.shields.io/readthedocs/python-tetris?style=for-the-badge)](https://python-tetris.readthedocs.io/en/latest/?badge=latest)
[![technical-debt](https://img.shields.io/badge/contains-technical%20debt-009fef?style=for-the-badge)](https://forthebadge.com/)

---

## Intro

A simple and modular library for implementing and analysing Tetris games, [guideline](https://archive.org/details/2009-tetris-variant-concepts_202201)-compliant by default

```py
>>> import tetris
>>> game = tetris.BaseGame(board_size=(4, 4), seed=128)
>>> game.queue
<SevenBag object [J, O, L, I, T, S, J, ...]>
>>> for _ in range(4): game.hard_drop()
...
>>> game.playing
False
>>> print(game)
J O O
J J J
Z Z
  Z Z
```

## Links

-   [Documentation](https://python-tetris.readthedocs.io/)
-   [PyPI](https://pypi.org/project/tetris)
-   Support: [create an issue](https://github.com/g3ner1c/python-tetris/issues/new/choose) or [see author contact](https://dzshn.xyz)

## Install

This package is available on [PyPI](https://pypi.org/project/tetris/), you can install it with pip:

```sh
pip install tetris
# or `py -m pip ...` etc.
```

To install the git version:

```sh
pip install git+https://github.com/g3ner1c/python-tetris
```

