Metadata-Version: 2.2
Name: chimera-stack-cli
Version: 0.1.0
Summary: A template-based development environment manager
Home-page: https://github.com/Amirofcodes/ChimeraStack_CLI
Author: Amir
Author-email: amirofcodes@github.com
Project-URL: Bug Tracker, https://github.com/Amirofcodes/ChimeraStack_CLI/issues
Project-URL: Documentation, https://github.com/Amirofcodes/ChimeraStack_CLI#readme
Project-URL: Source Code, https://github.com/Amirofcodes/ChimeraStack_CLI
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: python-dotenv>=0.19.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: colorama>=0.4.4
Requires-Dist: docker>=6.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: questionary>=2.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ChimeraStack CLI

A powerful, template-based development environment manager that simplifies the setup of Docker-based development environments using dynamic port allocation.

## Features

✨ **Ready-to-Use Templates**

- **PHP/Nginx Stacks**
  - MySQL
  - PostgreSQL
  - MariaDB
- **Fullstack Environments**
  - React + PHP + MySQL

🔄 **Dynamic Port Allocation**

- Automatic port assignment to avoid conflicts
- Run multiple projects simultaneously
- Smart port range management:
  - Frontend (React): 3000-3999
  - Backend (PHP/Node): 8000-8999
  - Databases:
    - MySQL: 3300-3399
    - MariaDB: 3400-3499
    - PostgreSQL: 5432-5632
  - Admin Tools:
    - phpMyAdmin: 8081-8180
    - pgAdmin: 8181-8280

🚀 **Coming Soon**

- Python development environments
- Node.js stacks
- More frontend frameworks
- Additional database options

## Quick Start

### Installation

```bash
pip install chimera-cli
```

### Create a Project

1. Create a new project:

```bash
chimera create my-project
```

2. Choose your template using the interactive arrow-key menu:

```
? Choose a category:
❯ PHP Development
  Fullstack Development

? Choose a template:
❯ php/nginx/mysql - PHP development environment with Nginx web server and MySQL database
  php/nginx/postgresql - PHP development environment with Nginx web server and PostgreSQL database
  php/nginx/mariadb - PHP development environment with Nginx web server and MariaDB database
  fullstack/react-php/mysql-nginx - Complete fullstack development environment with React, PHP backend, and MySQL database
```

3. Navigate to your project and start:

```bash
cd my-project
docker-compose up -d
```

## Templates

### PHP Development

#### PHP/Nginx/MySQL Stack

- Web server (Nginx + PHP-FPM)
- MySQL Database
- phpMyAdmin
- Pre-configured for PHP development

#### PHP/Nginx/PostgreSQL Stack

- Web server (Nginx + PHP-FPM)
- PostgreSQL Database
- pgAdmin
- Pre-configured for PHP development

#### PHP/Nginx/MariaDB Stack

- Web server (Nginx + PHP-FPM)
- MariaDB Database
- phpMyAdmin
- Pre-configured for PHP development

### Fullstack Development

#### React/PHP/MySQL Stack

- React Frontend with hot reload
- PHP Backend (Nginx + PHP-FPM)
- MySQL Database
- phpMyAdmin
- Pre-configured API connectivity

## Key Benefits

- 🎯 **Zero Configuration**: Pre-configured development environments that work out of the box
- 🔄 **Dynamic Ports**: Smart port allocation to avoid conflicts between projects
- 🔌 **Project Isolation**: Run multiple projects simultaneously
- 🛠️ **Development Ready**: Hot-reload, debugging tools, and development utilities included
- 🔒 **Secure Defaults**: Security best practices configured by default
- 🔄 **Consistent Environments**: Ensure your team uses the same development setup

## Status

ChimeraStack CLI is under active development. We're continuously adding new templates and features to support more development scenarios.

## Contributing

We welcome contributions! Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## Support

For issues, feature requests, or questions:

- Create an issue on GitHub
- Check our documentation
- Join our community discussions

## License

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