# 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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/dzshn/python-tetris",
"name": "tetris",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "tetris,stacker",
"author": "Sofia N. Lima",
"author_email": "me@dzshn.xyz",
"download_url": "https://files.pythonhosted.org/packages/0a/dd/5b3a4db0214080e1f41151dc7ce1c4b82400c3dda72e08948dc574dd3afd/tetris-1.0.0a0.tar.gz",
"platform": null,
"description": "# python-tetris: a simple and modular tetris library\n\n[![pypi](https://img.shields.io/pypi/v/tetris?logo=pypi&logoColor=f0f0f0&style=for-the-badge)](https://pypi.org/project/tetris/)\n[![python-versions](https://img.shields.io/pypi/pyversions/tetris?logo=python&logoColor=f0f0f0&style=for-the-badge)](https://pypi.org/project/tetris/)\n[![downloads](https://img.shields.io/pypi/dm/tetris?style=for-the-badge)](https://pypi.org/project/tetris/)\n[![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)\n[![docs](https://img.shields.io/readthedocs/python-tetris?style=for-the-badge)](https://python-tetris.readthedocs.io/en/latest/?badge=latest)\n[![technical-debt](https://img.shields.io/badge/contains-technical%20debt-009fef?style=for-the-badge)](https://forthebadge.com/)\n\n---\n\n## Intro\n\nA simple and modular library for implementing and analysing Tetris games, [guideline](https://archive.org/details/2009-tetris-variant-concepts_202201)-compliant by default\n\n```py\n>>> import tetris\n>>> game = tetris.BaseGame(board_size=(4, 4), seed=128)\n>>> game.queue\n<SevenBag object [J, O, L, I, T, S, J, ...]>\n>>> for _ in range(4): game.hard_drop()\n...\n>>> game.playing\nFalse\n>>> print(game)\nJ O O\nJ J J\nZ Z\n Z Z\n```\n\n## Links\n\n- [Documentation](https://python-tetris.readthedocs.io/)\n- [PyPI](https://pypi.org/project/tetris)\n- Support: [create an issue](https://github.com/g3ner1c/python-tetris/issues/new/choose) or [see author contact](https://dzshn.xyz)\n\n## Install\n\nThis package is available on [PyPI](https://pypi.org/project/tetris/), you can install it with pip:\n\n```sh\npip install tetris\n# or `py -m pip ...` etc.\n```\n\nTo install the git version:\n\n```sh\npip install git+https://github.com/g3ner1c/python-tetris\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Simple and modular tetris library",
"version": "1.0.0a0",
"project_urls": {
"Documentation": "https://python-tetris.readthedocs.io/",
"Homepage": "https://github.com/dzshn/python-tetris",
"Repository": "https://github.com/dzshn/python-tetris"
},
"split_keywords": [
"tetris",
"stacker"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "43e83ce8b6ed4da7698e248d75d76db7861986b5d3f98b7f387ce359936938b0",
"md5": "8f71242f0739710667d3023c90bd1e56",
"sha256": "b0f15a2dafee57160f91e6b86f368e1b74ec32198516daea8c7c9238db5c88f9"
},
"downloads": -1,
"filename": "tetris-1.0.0a0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8f71242f0739710667d3023c90bd1e56",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 36381,
"upload_time": "2023-06-30T19:35:52",
"upload_time_iso_8601": "2023-06-30T19:35:52.461789Z",
"url": "https://files.pythonhosted.org/packages/43/e8/3ce8b6ed4da7698e248d75d76db7861986b5d3f98b7f387ce359936938b0/tetris-1.0.0a0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0add5b3a4db0214080e1f41151dc7ce1c4b82400c3dda72e08948dc574dd3afd",
"md5": "8edab73350d4e43de150271814d13b5f",
"sha256": "719992c8be8c90b7eaded5a9b54298d678d341d288cb7fb06079706dce0b4248"
},
"downloads": -1,
"filename": "tetris-1.0.0a0.tar.gz",
"has_sig": false,
"md5_digest": "8edab73350d4e43de150271814d13b5f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 31948,
"upload_time": "2023-06-30T19:35:53",
"upload_time_iso_8601": "2023-06-30T19:35:53.988713Z",
"url": "https://files.pythonhosted.org/packages/0a/dd/5b3a4db0214080e1f41151dc7ce1c4b82400c3dda72e08948dc574dd3afd/tetris-1.0.0a0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-30 19:35:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "dzshn",
"github_project": "python-tetris",
"github_not_found": true,
"lcname": "tetris"
}