Metadata-Version: 2.4
Name: jsnake
Version: 0.1.1
Summary: 🐍 JSNAKE: The ultimate neon-powered terminal arcade snake with addictive leveling and perfectly balanced movement!
Author-email: Jithi <jithi@example.com>
License: MIT
Project-URL: Homepage, https://github.com/Jithi/jsnake
Project-URL: Repository, https://github.com/Jithi/jsnake
Project-URL: Issues, https://github.com/Jithi/jsnake/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Games/Entertainment
Classifier: Intended Audience :: End Users/Desktop
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=0.50.0
Requires-Dist: rich>=13.7.0
Provides-Extra: dev
Requires-Dist: ruff>=0.4.0; extra == "dev"
Requires-Dist: mypy>=1.9.0; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Dynamic: license-file

# 🐍 JSNAKE

[![PyPI version](https://img.shields.io/pypi/v/jsnake.svg)](https://pypi.org/project/jsnake/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**jsnake** is the ultimate neon-powered terminal arcade snake! Challenge yourself with addictive leveling and perfectly balanced movement in the coolest CLI game on PyPI.

---

## 🚀 Experience the Evolution

### 1. Unified Game Balance

We've solved the "vertical vs horizontal" speed illusion common in terminal games by using an optimized 2-character grid system. Every move feels identical in all directions.

### 2. Arcade Leveling System

- **Progression**: Advance through levels every 50 points.
- **Dynamic Speed**: The game's intensity scales directly with your level.
- **Visual Feedback**: Real-time progress bars and level-up indicators keep you in the flow.

### 3. Industrial Tech Stack

- **[Textual](https://textual.textualize.io/)**: Async-driven terminal engine for fluid 60FPS-like movement.
- **[Rich](https://rich.readthedocs.io/)**: Modern rendering for high-fidelity CLI aesthetics.
- **Modular MVC Architecture**: Clean separation between state logic and UI rendering.

## 🕹️ Quick Start

### Installation

Install globally from PyPI to play from anywhere in your terminal:

```bash
pip install jsnake
```

### Controls
```bash
jsnake  # Launch the game
```

- **W / A / S / D**: Movement
- **P**: Pause/Resume
- **R**: Restart (Reboot)
- **Q**: Quit (Terminate)

## 🛸 Professional Development

### Local Setup

```bash
git clone https://github.com/your-username/jsnake.git
cd jsnake
python -m venv .venv
.\.venv\Scripts\activate  # Windows
pip install -e ".[dev]"
```

### CI/CD

The project uses **GitHub Actions** for automated quality enforcement:

- **Ruff**: Linting & style checks.
- **Mypy**: Strict static typing.
- **Pytest**: Automated engine logic validation.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
