Metadata-Version: 2.4
Name: rhamaa
Version: 0.4.2
Summary: CLI tools to accelerate Wagtail web development with RhamaaCMS
Home-page: https://github.com/RhamaaCMS/RhamaaCLI
Author: RhamaaCMS Team
Author-email: Firdaus <firdaus@rhamaa.com>
Maintainer-email: Firdaus <firdaus@rhamaa.com>
License: MIT
Project-URL: Homepage, https://github.com/RhamaaCMS/RhamaaCLI
Project-URL: Documentation, https://github.com/RhamaaCMS/RhamaaCLI/wiki
Project-URL: Repository, https://github.com/RhamaaCMS/RhamaaCLI
Project-URL: Bug Reports, https://github.com/RhamaaCMS/RhamaaCLI/issues
Keywords: wagtail,django,cms,cli,rhamaa,code-generator
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Content Management System
Classifier: License :: OSI Approved :: MIT License
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: Framework :: Django
Classifier: Framework :: Wagtail
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=12.0.0
Requires-Dist: requests>=2.25.0
Requires-Dist: gitpython>=3.1.0
Provides-Extra: cms
Requires-Dist: wagtail>=5.0; extra == "cms"
Provides-Extra: cv
Requires-Dist: ultralytics>=8.0.0; extra == "cv"
Requires-Dist: opencv-python>=4.8.0; extra == "cv"
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: build; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Rhamaa CLI

Simple CLI tool for Wagtail CMS development. Create projects and install prebuilt apps instantly.

## ⚡ Quick Start

```bash
# Basic install (CLI only)
pip install rhamaa

# With CMS support (includes Wagtail) - Recommended
pip install "rhamaa[cms]"

# With Computer Vision support
pip install "rhamaa[cv]"

# Create Wagtail project
rhamaa cms start MyProject
cd MyProject

# Create minimal Django app
rhamaa cms startapp blog

# Install prebuilt app
rhamaa cms startapp iot --prebuild mqtt

# List available apps
rhamaa cms startapp --list
```

## 🎯 CMS-Focused Commands

### `rhamaa cms start <project>`
Creates new Wagtail project using RhamaaCMS template.
- `--template-url <zip>` gunakan URL ZIP kustom
- `--template-file <path>` arahkan ke ZIP/direktori lokal
- `--local-dev` pakai template di `../RhamaaCMS`
- `--list` tampilkan katalog template registry

### `rhamaa cms startapp <name>`
Creates Django apps or installs prebuilt apps:
- `--type minimal` - Standard Django app (default)
- `--type wagtail` - Wagtail app with models/templates
- `--prebuild <key>` - Install from registry
- `--list` - Show available prebuilt apps

### `rhamaa cms build-template [source]`
Konversi proyek RhamaaCMS hasil eksplorasi kembali menjadi template siap pakai:
- `--slug <name>` tentukan slug proyek asli (default: nama folder sumber)
- `--output <zip>` nama arsip output (disimpan di `dist/`)
- `--no-wrap-templates` lewati pembungkusan `{% verbatim %}` pada file HTML
- `--wrap-templates` aktif secara default untuk menjaga tag template saat di-render `wagtail start`

### `rhamaa cms run`
Development and production server management:
- `rhamaa cms run` - Start development server
- `rhamaa cms run --prod` - Start with Gunicorn
- `rhamaa cms check` - Run system checks
- `rhamaa cms status` - Show project status

## 📦 Available Prebuilt Apps

| Key | Name | Category |
|-----|------|----------|
| `mqtt` | MQTT Apps | IoT |
| `users` | User Management | Authentication |
| `articles` | Article System | Content |

## 💡 Usage Examples

```bash
# Blog project
rhamaa cms start MyBlog
cd MyBlog
rhamaa cms startapp articles --prebuild articles

# IoT dashboard
rhamaa cms start IoTDash
cd IoTDash
rhamaa cms startapp devices --prebuild mqtt

# Educational platform
rhamaa cms start EduSite
cd EduSite
rhamaa cms startapp courses --prebuild lms

# Bootstrapping from custom template sources
rhamaa cms start MyLocal --template-file ./dist/rhamaacms-template.zip
rhamaa cms start Latest --template-url https://example.com/custom-template.zip

# Build template kembali dari proyek lokal
rhamaa cms build-template .
```

## 🔧 After Installing Apps

1. Add to `INSTALLED_APPS`:
```python
INSTALLED_APPS = [
    # ... existing apps
    'apps.your_app_name',
]
```

2. Run migrations:
```bash
python manage.py makemigrations
python manage.py migrate
```

## 🚀 Features

- **Rich Terminal UI** - Beautiful ASCII art and progress bars
- **Auto Directory Structure** - Apps created in `apps/` folder
- **GitHub Integration** - Downloads apps from repositories
- **Force Install** - Overwrite existing apps with `--force`
- **Project Detection** - Validates Wagtail project structure

## 📋 Requirements

- Python 3.7+
- Django/Wagtail (for project creation)

## 🔗 Links

- [Documentation](https://rhamaacms.github.io/RhamaaCLI)
- [PyPI Package](https://pypi.org/project/rhamaa/)
- [GitHub Repository](https://github.com/RhamaaCMS/RhamaaCLI)
- [Issues & Support](https://github.com/RhamaaCMS/RhamaaCLI/issues)

---

Made with ❤️ by the [RhamaaCMS](https://github.com/RhamaaCMS) team
