Metadata-Version: 2.4
Name: retro-snake-game
Version: 1.0.2
Summary: A retro-style snake game
Author-email: Adrian Rubio-Punal <adrian.rubio.punal@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/adrirubio/retro-snake-game
Project-URL: Repository, https://github.com/adrirubio/retro-snake-game
Project-URL: Issues, https://github.com/adrirubio/retro-snake-game/issues
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pygame>=2.0.0
Dynamic: license-file

# retro-snake-game
Retro snake game with 8-bit charm

<p align="left">
    <img src="retro-snake-logo.png"
         alt="retro-snake-logo"
         width="200">
</p>

## Demo

Watch a quick preview below (GIF)

### 🔹 Preview (GIF)
![Text Lens - Preview](https://github.com/adrirubio/demo-files/raw/main/retro-snake-game-demo.gif)

## Features

- Classic Snake Gameplay: Navigate your growing snake to collect apples while avoiding walls and self-collision
- Retro 8-bit Graphics: Animated pixel art sprites for snake segments, apples, and authentic retro aesthetic
- Sound Effects: Nostalgic coin collection sounds, game start jingles, and background music
- High Score Tracking: Persistent local high score saves to challenge your best performance
- Smooth Controls: Responsive arrow key controls with intelligent direction handling
- Dynamic Difficulty: Snake size increases as you grow, making the game progressively challenging

# Installation

### Prerequisites
- Python 3.7 or higher

### Install from PyPI

```bash
pip install retro-snake-game
```

Or:
```bash
# Install UV if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install retro-snake-game
uv pip install retro-snake-game
```

### Run the application
```bash
retro-snake
```

Or:
```bash
python -m retro_snake_game
```

### Install from source

1. **Clone the repository**
   ```bash
   git clone https://github.com/adrirubio/retro-snake-game.git
   cd retro-snake-game
   ```

2. **Install the package**
   ```bash
   pip install .
   ```

3. **Run the application**
   ```bash
   retro-snake
   ```

   Or:
   ```bash
   python -m retro_snake_game
   ```
