rhamaa 0.4.1

CLI tools to accelerate Wagtail web development with RhamaaCMS

Rhamaa CLI

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

⚡ Quick Start

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

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

# 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

🔧 After Installing Apps

1. Add to INSTALLED_APPS:

INSTALLED_APPS = [
    # ... existing apps
    'apps.your_app_name',
]

2. Run migrations:

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
• PyPI Package
• GitHub Repository
• Issues & Support

---

Made with ❤️ by the RhamaaCMS team