pyreactor-forge 0.1.0__py3-none-any.whl

pyreactor_forge/__init__.py

@@ -0,0 +1,3 @@
+"""PyReactor Forge - Full-stack Python + React application generator."""
+__version__ = "0.1.0"
+__author__ = "Panagiotis Adamopoulos"

pyreactor_forge/cli.py

@@ -0,0 +1,234 @@
+"""PyReactor Forge CLI - JHipster-inspired full-stack generator for Python + React."""
+
+import click
+import sys
+from pathlib import Path
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+from pyreactor_forge import __version__
+from pyreactor_forge.generators.app import AppGenerator
+from pyreactor_forge.generators.entity import EntityGenerator
+from pyreactor_forge.utils.display import print_banner, print_success, print_error
+
+
+def _force_utf8_stdio():
+    """Windows defaults stdio to the legacy ANSI code page (cp1252 on most
+    installs), which cannot encode the Unicode we print. It only bites when
+    output is redirected -- a bare terminal goes through WriteConsoleW and
+    works fine -- so piping to a file or running under CI would otherwise
+    crash with UnicodeEncodeError.
+    """
+    for stream in (sys.stdout, sys.stderr):
+        reconfigure = getattr(stream, "reconfigure", None)
+        if reconfigure is not None:
+            reconfigure(encoding="utf-8", errors="replace")
+
+
+_force_utf8_stdio()
+
+console = Console()
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="PyReactor Forge")
+def cli():
+    """
+    \b
+    ██████╗ ██╗   ██╗██████╗ ███████╗ █████╗  ██████╗████████╗ ██████╗ ██████╗
+    ██╔══██╗╚██╗ ██╔╝██╔══██╗██╔════╝██╔══██╗██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗
+    ██████╔╝ ╚████╔╝ ██████╔╝█████╗  ███████║██║        ██║   ██║   ██║██████╔╝
+    ██╔═══╝   ╚██╔╝  ██╔══██╗██╔══╝  ██╔══██║██║        ██║   ██║   ██║██╔══██╗
+    ██║        ██║   ██║  ██║███████╗██║  ██║╚██████╗   ██║   ╚██████╔╝██║  ██║
+    ╚═╝        ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝ ╚═════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝
+
+    Full-stack Python + React application generator.
+    Inspired by JHipster. Built for the Python ecosystem.
+    """
+    pass
+
+
+@cli.command()
+@click.option("--name", "-n", prompt="Application name", help="Name of the application")
+@click.option(
+    "--backend",
+    "-b",
+    type=click.Choice(["fastapi", "django", "flask"], case_sensitive=False),
+    default="fastapi",
+    prompt="Backend framework",
+    show_default=True,
+    help="Python backend framework",
+)
+@click.option(
+    "--frontend",
+    "-f",
+    type=click.Choice(["react", "react-ts"], case_sensitive=False),
+    default="react-ts",
+    prompt="Frontend framework",
+    show_default=True,
+    help="Frontend framework",
+)
+@click.option(
+    "--database",
+    "-d",
+    type=click.Choice(["postgresql", "mysql", "sqlite"], case_sensitive=False),
+    default="postgresql",
+    prompt="Database",
+    show_default=True,
+    help="Database engine",
+)
+@click.option(
+    "--auth",
+    "-a",
+    type=click.Choice(["jwt", "session", "oauth2"], case_sensitive=False),
+    default="jwt",
+    prompt="Authentication type",
+    show_default=True,
+    help="Authentication strategy",
+)
+@click.option(
+    "--output-dir",
+    "-o",
+    default=".",
+    help="Output directory (default: current directory)",
+)
+@click.option(
+    "--docker/--no-docker",
+    default=True,
+    prompt="Include Docker configuration?",
+    help="Generate Docker and docker-compose files",
+)
+@click.option(
+    "--ci",
+    type=click.Choice(["github-actions", "gitlab-ci", "none"], case_sensitive=False),
+    default="github-actions",
+    prompt="CI/CD pipeline",
+    show_default=True,
+    help="CI/CD pipeline configuration",
+)
+def new(name, backend, frontend, database, auth, output_dir, docker, ci):
+    """Generate a new full-stack Python + React application."""
+    print_banner()
+
+    config = {
+        "name": name,
+        "backend": backend,
+        "frontend": frontend,
+        "database": database,
+        "auth": auth,
+        "docker": docker,
+        "ci": ci,
+        "output_dir": output_dir,
+    }
+
+    console.print(
+        Panel.fit(
+            f"[bold cyan]Generating application:[/bold cyan] [yellow]{name}[/yellow]\n"
+            f"  Backend:  [green]{backend}[/green]\n"
+            f"  Frontend: [green]{frontend}[/green]\n"
+            f"  Database: [green]{database}[/green]\n"
+            f"  Auth:     [green]{auth}[/green]\n"
+            f"  Docker:   [green]{'yes' if docker else 'no'}[/green]\n"
+            f"  CI/CD:    [green]{ci}[/green]",
+            title="⚡ PyReactor Forge",
+            border_style="cyan",
+        )
+    )
+
+    generator = AppGenerator(config)
+    try:
+        generator.generate()
+        print_success(name, config)
+    except Exception as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@cli.command()
+@click.option("--name", "-n", prompt="Entity name (singular, PascalCase)", help="Entity name, e.g. Product")
+@click.option(
+    "--app-dir",
+    "-a",
+    default=".",
+    help="Path to the generated app directory",
+)
+def entity(name, app_dir):
+    """Add a new entity (model + API + UI) to an existing app."""
+    app_path = Path(app_dir)
+    config_file = app_path / ".pyforge.json"
+
+    if not config_file.exists():
+        console.print(
+            "[red]Error:[/red] No .pyforge.json found. "
+            "Run this command inside a PyReactor Forge-generated project."
+        )
+        sys.exit(1)
+
+    import json
+    with open(config_file, encoding="utf-8") as f:
+        app_config = json.load(f)
+
+    console.print(f"\n[bold cyan]⚡ Adding entity:[/bold cyan] [yellow]{name}[/yellow]\n")
+
+    # Interactively collect fields
+    fields = []
+    console.print("[dim]Define fields (press Enter with no name to finish):[/dim]\n")
+
+    while True:
+        field_name = click.prompt("  Field name", default="", show_default=False)
+        if not field_name:
+            break
+
+        field_type = click.prompt(
+            "  Field type",
+            type=click.Choice(["string", "integer", "float", "boolean", "date", "datetime", "text"]),
+            default="string",
+        )
+        required = click.confirm("  Required?", default=True)
+        fields.append({"name": field_name, "type": field_type, "required": required})
+        console.print()
+
+    if not fields:
+        console.print("[yellow]No fields defined. Aborting.[/yellow]")
+        sys.exit(0)
+
+    gen = EntityGenerator(name, fields, app_config, app_path)
+    gen.generate()
+
+    console.print(f"\n[bold green]✓ Entity [yellow]{name}[/yellow] added successfully![/bold green]")
+    console.print("\nFiles created/updated:")
+    for f in gen.created_files:
+        console.print(f"  [cyan]→[/cyan] {f}")
+
+
+@cli.command()
+def info():
+    """Display information about the PyReactor Forge generator."""
+    print_banner()
+    console.print(
+        Panel(
+            "[bold]PyReactor Forge[/bold] is a full-stack code generator inspired by JHipster.\n\n"
+            "[bold cyan]Supported backends:[/bold cyan]\n"
+            "  • [green]FastAPI[/green]  — Modern, fast async Python API framework\n"
+            "  • [green]Django[/green]   — Batteries-included Python web framework\n"
+            "  • [green]Flask[/green]    — Lightweight Python micro-framework\n\n"
+            "[bold cyan]Supported frontends:[/bold cyan]\n"
+            "  • [green]React[/green]         — JavaScript (Vite + React)\n"
+            "  • [green]React-TS[/green]      — TypeScript (Vite + React + TypeScript)\n\n"
+            "[bold cyan]Supported databases:[/bold cyan]\n"
+            "  • [green]PostgreSQL[/green] • [green]MySQL[/green] • [green]SQLite[/green]\n\n"
+            "[bold cyan]Supported authentication:[/bold cyan]\n"
+            "  • [green]JWT[/green] • [green]Session[/green] • [green]OAuth2[/green]\n\n"
+            "[bold cyan]Commands:[/bold cyan]\n"
+            "  • [yellow]pyforge new[/yellow]     — Scaffold a new application\n"
+            "  • [yellow]pyforge entity[/yellow]  — Add a new entity to an existing app\n"
+            "  • [yellow]pyforge info[/yellow]    — Show this information",
+            title="ℹ️  About PyReactor Forge",
+            border_style="blue",
+        )
+    )
+
+
+if __name__ == "__main__":
+    cli()

pyreactor_forge/generators/app.py

@@ -0,0 +1,281 @@
+"""App Generator - scaffolds the full project structure."""
+
+import json
+import os
+import shutil
+from pathlib import Path
+from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from pyreactor_forge.generators.backend.fastapi import FastAPIGenerator
+from pyreactor_forge.generators.backend.django import DjangoGenerator
+from pyreactor_forge.generators.backend.flask import FlaskGenerator
+from pyreactor_forge.generators.frontend import FrontendGenerator
+from pyreactor_forge.generators.devops import DevOpsGenerator
+
+console = Console()
+
+
+class AppGenerator:
+    def __init__(self, config: dict):
+        self.config = config
+        self.name = config["name"]
+        self.slug = self.name.lower().replace(" ", "-").replace("_", "-")
+        self.output_dir = Path(config.get("output_dir", ".")) / self.slug
+
+    def generate(self):
+        if self.output_dir.exists():
+            raise FileExistsError(
+                f"Directory '{self.output_dir}' already exists. "
+                "Please remove it or choose a different name."
+            )
+
+        self.output_dir.mkdir(parents=True)
+
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            console=console,
+        ) as progress:
+            # Backend
+            task = progress.add_task("[cyan]Generating backend...", total=None)
+            self._generate_backend()
+            progress.update(task, description="[green]✓ Backend generated")
+
+            # Frontend
+            task2 = progress.add_task("[cyan]Generating frontend...", total=None)
+            self._generate_frontend()
+            progress.update(task2, description="[green]✓ Frontend generated")
+
+            # DevOps
+            if self.config.get("docker") or self.config.get("ci") != "none":
+                task3 = progress.add_task("[cyan]Generating DevOps config...", total=None)
+                self._generate_devops()
+                progress.update(task3, description="[green]✓ DevOps config generated")
+
+            # Root files
+            task4 = progress.add_task("[cyan]Writing project files...", total=None)
+            self._write_root_files()
+            progress.update(task4, description="[green]✓ Project files written")
+
+    def _generate_backend(self):
+        backend = self.config["backend"]
+        backend_dir = self.output_dir / "backend"
+        backend_dir.mkdir()
+
+        if backend == "fastapi":
+            gen = FastAPIGenerator(self.config, backend_dir)
+        elif backend == "django":
+            gen = DjangoGenerator(self.config, backend_dir)
+        else:
+            gen = FlaskGenerator(self.config, backend_dir)
+
+        gen.generate()
+
+    def _generate_frontend(self):
+        frontend_dir = self.output_dir / "frontend"
+        frontend_dir.mkdir()
+        gen = FrontendGenerator(self.config, frontend_dir)
+        gen.generate()
+
+    def _generate_devops(self):
+        gen = DevOpsGenerator(self.config, self.output_dir)
+        gen.generate()
+
+    def _write_root_files(self):
+        # .pyforge.json - project metadata
+        meta = {
+            "name": self.name,
+            "slug": self.slug,
+            "backend": self.config["backend"],
+            "frontend": self.config["frontend"],
+            "database": self.config["database"],
+            "auth": self.config["auth"],
+            "version": "0.1.0",
+        }
+        with open(self.output_dir / ".pyforge.json", "w", encoding="utf-8") as f:
+            json.dump(meta, f, indent=2)
+
+        # Root README
+        readme = self._render_readme()
+        (self.output_dir / "README.md").write_text(readme, encoding="utf-8")
+
+        # Root .gitignore
+        (self.output_dir / ".gitignore").write_text(ROOT_GITIGNORE, encoding="utf-8")
+
+        # Makefile
+        (self.output_dir / "Makefile").write_text(self._render_makefile(), encoding="utf-8")
+
+    def _render_readme(self):
+        name = self.name
+        backend = self.config["backend"]
+        frontend = self.config["frontend"]
+        db = self.config["database"]
+        auth = self.config["auth"]
+
+        return f"""# {name}
+
+> Generated by [PyReactor Forge](https://github.com/panosadamop/pyreactor-forge) — Full-stack Python + React generator.
+
+## Stack
+
+| Layer      | Technology                          |
+|------------|-------------------------------------|
+| Backend    | {backend.capitalize()}              |
+| Frontend   | {frontend.upper()}                  |
+| Database   | {db.capitalize()}                   |
+| Auth       | {auth.upper()}                      |
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.11+
+- Node.js 18+
+- {db.capitalize()} running locally (or use Docker)
+
+### Development
+
+```bash
+# Install all dependencies and start both servers
+make dev
+```
+
+Or manually:
+
+```bash
+# Backend
+cd backend
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+{"python manage.py migrate && python manage.py runserver" if backend == "django" else "uvicorn app.main:app --reload"}
+
+# Frontend (in another terminal)
+cd frontend
+npm install
+npm run dev
+```
+
+### Docker
+
+```bash
+docker-compose up --build
+```
+
+## Project Structure
+
+```
+{name.lower()}/
+├── backend/          # {backend.capitalize()} application
+│   ├── app/          # Application code
+│   │   ├── models/   # Database models (SQLAlchemy / Django ORM)
+│   │   ├── routers/  # API route handlers
+│   │   ├── schemas/  # Pydantic schemas / serializers
+│   │   └── core/     # Config, auth, database setup
+│   └── tests/        # Backend tests
+├── frontend/         # React application
+│   ├── src/
+│   │   ├── components/  # Reusable UI components
+│   │   ├── pages/       # Route-level page components
+│   │   ├── services/    # API client layer
+│   │   ├── hooks/       # Custom React hooks
+│   │   └── store/       # State management
+│   └── public/
+├── docker-compose.yml
+├── Makefile
+└── .pyforge.json   # PyReactor Forge project metadata
+```
+
+## API Documentation
+
+When the backend is running, visit:
+- Swagger UI: http://localhost:8000/docs
+- ReDoc:       http://localhost:8000/redoc
+
+## License
+
+MIT
+"""
+
+    def _render_makefile(self):
+        backend = self.config["backend"]
+        run_cmd = (
+            "python manage.py runserver"
+            if backend == "django"
+            else "uvicorn app.main:app --reload --host 0.0.0.0 --port 8000"
+        )
+        migrate_cmd = (
+            "python manage.py migrate"
+            if backend == "django"
+            else "alembic upgrade head"
+        )
+        return f"""# Makefile for {self.name}
+
+.PHONY: dev backend frontend install migrate test lint docker-up docker-down
+
+dev:
+\t$(MAKE) -j2 backend frontend
+
+backend:
+\tcd backend && source .venv/bin/activate && {run_cmd}
+
+frontend:
+\tcd frontend && npm run dev
+
+install:
+\tcd backend && python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt
+\tcd frontend && npm install
+
+migrate:
+\tcd backend && source .venv/bin/activate && {migrate_cmd}
+
+test:
+\tcd backend && source .venv/bin/activate && pytest
+\tcd frontend && npm run test
+
+lint:
+\tcd backend && source .venv/bin/activate && ruff check . && mypy .
+\tcd frontend && npm run lint
+
+docker-up:
+\tdocker-compose up --build -d
+
+docker-down:
+\tdocker-compose down
+"""
+
+
+ROOT_GITIGNORE = """# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+.env
+dist/
+build/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+
+# Node
+node_modules/
+dist/
+.env.local
+.env.*.local
+
+# Database
+*.db
+*.sqlite3
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+.docker/
+"""