Metadata-Version: 2.4
Name: tetris-terminal
Version: 0.0.1a1
Summary: A tetris game runs in the terminal
Author-email: jayzhu <jay.l.zhu@foxmail.com>
Project-URL: homepage, https://github.com/zlh124/pytetris
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Games/Entertainment :: Puzzle Games
Classifier: Topic :: Terminals
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

![gameplay](./gameplay.gif)  
# Pytetris 🎮
A terminal-based Tetris game written in Python using the `curses` library.

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Python 3.8+](https://img.shields.io/badge/Python-3.8%2B-blue)]()  

### Features
- Classic Tetris gameplay with 7 standard tetrominoes
- Real-time score
- Next piece preview

### Platform Support
Based on Python's [`curses`](https://docs.python.org/3/library/curses.html) module:
- ✅ **Linux/macOS**: Works out of the box
- ⚠️ **Windows**: Not supported yet

### Installation & Usage
- Using [uv](https://github.com/astral-sh/uv) (recommended):
```bash
uv pip install -e .
pytetris
```
- Using pip (alternative):
```bash
pip install -e .
pytetris
```

### Controls
| Key       | Action          |
|-----------|-----------------|
|    `a`    | Move left       |
|    `d`    | Move right      |
|    `w`    | Rotate piece    |
|    `s`    | Hard drop       |
|    `q`    | Quit game       |

### License
MIT License - see [LICENSE](LICENSE) for details.

### Acknowledgements
Game logic adapted from [tinytetris](https://github.com/taylorconor/tinytetris) (a C implementation).
