Metadata-Version: 2.4
Name: flower-garden-cli
Version: 1.0.0
Summary: Beautiful CLI flower garden game - water flowers and watch them grow into stunning patterns!
Author-email: David Zhang <davzhang77@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/bdavidzhang/flower-garden-cli
Project-URL: Documentation, https://github.com/bdavidzhang/flower-garden-cli#readme
Project-URL: Repository, https://github.com/bdavidzhang/flower-garden-cli.git
Project-URL: Bug Tracker, https://github.com/bdavidzhang/flower-garden-cli/issues
Keywords: cli,game,flowers,patterns,fractals,art,terminal
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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: Topic :: Games/Entertainment
Classifier: Topic :: Artistic Software
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorama>=0.4.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Dynamic: license-file

# 🌺 Flower Garden CLI

**Beautiful CLI flower garden game - water flowers and watch them grow into stunning patterns!**

Transform your terminal into a magical garden where you can nurture 5 different types of flowers, each growing into unique mathematical patterns and fractals.

![Flower Garden Demo](https://img.shields.io/badge/demo-terminal-brightgreen)
![Python Version](https://img.shields.io/badge/python-3.7+-blue)
![License](https://img.shields.io/badge/license-MIT-green)

## 🌸 Features

- **5 Unique Flower Types**: Each with distinct mathematical patterns
  - 🌹 **Spiral Rose** - Fibonacci spirals with blooming petals
  - 🌳 **Fractal Tree** - Recursive branching with leaves
  - 🌺 **Mandala Bloom** - Geometric circular patterns
  - 🌊 **Wave Garden** - Flowing sine wave patterns
  - ⭐ **Star Burst** - Radiating star patterns

- **Growth System**: 10 levels of growth for each flower
- **Persistent Save**: Your garden state is automatically saved
- **Colorful Display**: Beautiful terminal colors (with colorama)
- **Interactive Menu**: Easy-to-use command interface

## 🚀 Quick Start

Install and run with a single command:

```bash
pip install flower-garden-cli
flower-garden
```

Alternative command:
```bash
garden
```

## 📦 Installation Methods

### Method 1: pip install (Recommended)
```bash
# Install from PyPI (when published)
pip install flower-garden-cli

# Or install from GitHub
pip install git+https://github.com/bdavidzhang/flower-garden-cli.git
```

### Method 2: Local Development
```bash
# Clone the repository
git clone https://github.com/bdavidzhang/flower-garden-cli.git
cd flower-garden-cli

# Install in development mode
pip install -e .

# Run the game
flower-garden
```

### Method 3: Direct from Source
```bash
# Download and run directly
curl -O https://raw.githubusercontent.com/bdavidzhang/flower-garden-cli/main/flower_garden_cli/main.py
python main.py
```

## 🎮 How to Play

1. **Launch the game**: Run `flower-garden` in your terminal
2. **Choose an action**: Select from the numbered menu options
3. **Water flowers**: Watch them grow from seeds to beautiful patterns
4. **Enjoy the patterns**: Each growth level reveals more complexity
5. **Save automatically**: Your progress is saved between sessions

### Menu Options:
- `1-5`: Water individual flower types
- `6`: View your entire garden
- `7`: Water all flowers at once
- `8`: Reset garden (start over)
- `9`: Quit game

## 🎨 Flower Types Preview

```
🌹 Spiral Rose (Level 6)             ⭐ Star burst (Level 4)
          ·                                  ·
        ·······                              ·
      ✿❀✿❀✿····                    ·   ·   ·
    ✿❀····✿····                    · ✧ ·
    ······❀✿···                      ✧ ✧ ✧
    ·······❀···                        ✧✧✧
   ······❀❀·····                 ···✧✧✧★✧✧✧···
    ···········                        ✧✧✧
    ···········                      ✧ ✧ ✧
    ···········                    · ✧ ·
      ·········                      ·   ·   ·
        ·······                          ·
          ·                              ·
```

## 🛠️ Development

### Project Structure
```
flower-garden-cli/
├── flower_garden_cli/
│   ├── __init__.py
│   └── main.py
├── pyproject.toml
├── README.md
├── LICENSE
└── tests/
    └── test_main.py
```

### Local Development Setup
```bash
# Clone and setup
git clone https://github.com/bdavidzhang/flower-garden-cli.git
cd flower-garden-cli

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black flower_garden_cli/
```

## 📋 Requirements

- **Python**: 3.7 or higher
- **Dependencies**: 
  - `colorama` (for colored terminal output)
- **Platform**: Cross-platform (Windows, macOS, Linux)

## 📄 License

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

## 🤝 Contributing

Contributions welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## 🌟 Support

If you enjoy this project, please give it a ⭐ on GitHub!

**Issues?** Please report them [here](https://github.com/bdavidzhang/flower-garden-cli/issues).

---

*Grow your digital garden, one flower at a time* 🌱✨
