flower-garden-cli 1.0.0

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

🌺 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.

🌸 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:

pip install flower-garden-cli
flower-garden

Alternative command:

garden

📦 Installation Methods

Method 1: pip install (Recommended)

# 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

# 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

# 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

# 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 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.

---

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