Metadata-Version: 2.1
Name: pytemon
Version: 0.1.0
Summary: Interactive Pokemon game library for the terminal, built with Textual TUI
Home-page: https://github.com/MobyNL/pytemon
License: MIT
Keywords: pokemon,game,tui,terminal,textual,interactive
Author: Mark Moberts
Author-email: markmoberts@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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: Topic :: Games/Entertainment :: Role-Playing
Classifier: Topic :: Terminals
Requires-Dist: rich (>=13.7.0,<14.0.0)
Requires-Dist: textual (>=0.73.0,<0.74.0)
Project-URL: Repository, https://github.com/MobyNL/pytemon
Description-Content-Type: text/markdown

# pytemon

Python Pokemon game library with interactive terminal UI.

## Overview

`pytemon` is a pure Python library that implements an interactive Pokemon game using the [Textual](https://textual.textualize.io/) TUI framework. It contains the full game engine — exploration, battles, items, gyms, evolution, and a rich terminal interface.

The [rf-pytemon](../rf-pytemon/) sibling project wraps this library as a Robot Framework keyword library.

## Setup

```bash
cd pytemon/
poetry install
```

## Run the game directly

```bash
poetry run python run_terminal.py
```

## Run unit tests

```bash
poetry run pytest tests/ --tb=short -v --cov=pytemon --cov-report=term-missing
```

## Project structure

```
pytemon/
├── pytemon/           # The Python package
│   ├── terminal.py    # Textual TUI app
│   ├── game_state.py  # Central game state
│   ├── exploration.py # Movement and encounters
│   ├── buildings.py   # Pokemon Center, Pokemart, etc.
│   ├── battle/        # Battle UI and actions
│   ├── data/          # Pokemon, move, trainer data
│   ├── engine/        # Core battle engine
│   └── ui/            # TUI mixin modules
├── tests/             # Pytest unit tests
├── run_terminal.py    # Direct launcher
└── pyproject.toml
```

