rapidkit 0.14.1 → 0.15.1

package/templates/kits/fastapi-standard/src/cli.py.j2

@@ -1,335 +0,0 @@
-#!/usr/bin/env python3
-"""Professional CLI commands for {{ project_name }} - Poetry Scripts Integration
-
-A modern CLI inspired by Next.js developer experience for FastAPI projects.
-"""
-
-import os
-import subprocess
-import sys
-from pathlib import Path
-from typing import Any, Dict
-
-
-def _print_banner(emoji: str, message: str, color_code: str = "36") -> None:
-    """Print colored banner message."""
-    print(f"\033[{color_code}m{emoji} {message}\033[0m")
-
-
-def _print_error(message: str) -> None:
-    """Print error message in red."""
-    print(f"\033[91m❌ {message}\033[0m")
-
-
-def _print_success(message: str) -> None:
-    """Print success message in green."""
-    print(f"\033[92m✅ {message}\033[0m")
-
-
-def _get_env_var(key: str, default: str) -> str:
-    """Get environment variable with default."""
-    return os.getenv(key, default)
-
-
-def _parse_args() -> dict:
-    """Parse command line arguments."""
-    args = {"port": "8000", "host": "0.0.0.0", "workers": "1", "env": "development"}
-
-    i = 0
-    while i < len(sys.argv):
-        if sys.argv[i] in ["--port", "-p"] and i + 1 < len(sys.argv):
-            args["port"] = sys.argv[i + 1]
-            i += 2
-        elif sys.argv[i] in ["--host", "-h"] and i + 1 < len(sys.argv):
-            args["host"] = sys.argv[i + 1]
-            i += 2
-        elif sys.argv[i] in ["--workers", "-w"] and i + 1 < len(sys.argv):
-            args["workers"] = sys.argv[i + 1]
-            i += 2
-        elif sys.argv[i] in ["--env", "-e"] and i + 1 < len(sys.argv):
-            args["env"] = sys.argv[i + 1]
-            i += 2
-        else:
-            i += 1
-
-    return args
-
-def _run_uvicorn(module: str, reload: bool = False, **kwargs: Any) -> None:
-    """Run uvicorn server with proper error handling."""
-    args: Dict[str, Any] = _parse_args()
-
-    cmd: list[str] = [
-        sys.executable, "-m", "uvicorn",
-        module,
-        "--host", str(args.get("host", "0.0.0.0")),
-        "--port", str(args.get("port", 8000))
-    ]
-
-    if reload:
-        cmd.append("--reload")
-        cmd.extend(["--reload-dir", "src"])
-
-    env: str = args.get("env", "development")
-    if env == "production" and "workers" in args:
-        cmd.extend(["--workers", str(args["workers"])])
-        cmd.append("--no-access-log")
-
-    extra_args: list[str] = kwargs.get("extra_args", [])
-    cmd.extend(extra_args)
-
-    env_vars: Dict[str, str] = os.environ.copy()
-    env_vars.update({
-        "PYTHONPATH": str(Path.cwd()),
-        "ENVIRONMENT": env
-    })
-
-    try:
-        subprocess.run(cmd, check=False, env=env_vars)
-    except KeyboardInterrupt:
-        _print_banner("🛑", "Server stopped by user")
-    except Exception as e:
-        _print_error(f"Failed to start server: {e}")
-        sys.exit(1)
-
-def dev() -> None:
-    """🚀 Start development server with hot reload
-
-    Usage:
-        rapidkit dev [options]  # preferred (project-aware)
-        # or: poetry run dev [options]
-
-    Options:
-        --port, -p PORT     Server port (default: 8000)
-        --host, -h HOST     Server host (default: 0.0.0.0)
-        --env, -e ENV       Environment (default: development)
-
-    Examples:
-        rapidkit dev
-        rapidkit dev --port 3000
-        rapidkit dev --host 127.0.0.1 --port 8080
-        # or: poetry run dev --port 3000
-    """
-    _print_banner("🚀", "Starting development server with hot reload...")
-    _print_banner("📁", f"Working directory: {Path.cwd()}")
-
-    args = _parse_args()
-    _print_banner("🌐", f"Server will be available at: http://{args['host']}:{args['port']}")
-
-    _run_uvicorn("src.main:app", reload=True)
-
-
-def start() -> None:
-    """⚡ Start production server
-
-    Usage:
-        poetry run start [options]
-
-    Options:
-        --port, -p PORT     Server port (default: 8000)
-        --host, -h HOST     Server host (default: 0.0.0.0)
-        --workers, -w NUM   Number of workers (default: 1)
-
-    Examples:
-        poetry run start
-        poetry run start --workers 4 --port 80
-    """
-    _print_banner("⚡", "Starting production server...")
-
-    args = _parse_args()
-    _print_banner("👥", f"Workers: {args['workers']}")
-    _print_banner("🌐", f"Server will be available at: http://{args['host']}:{args['port']}")
-
-    _run_uvicorn("src.main:app", reload=False, env="production")
-
-
-def build() -> None:
-    """📦 Build project for production
-
-    This command prepares the project for production deployment:
-    - Validates dependencies
-    - Runs type checking
-    - Builds distribution packages
-    """
-    _print_banner("📦", "Building project for production...")
-
-    try:
-        # Type checking
-        _print_banner("🔍", "Running type checks...")
-        result = subprocess.run([
-            sys.executable, "-m", "mypy", "src", "--ignore-missing-imports"
-        ], capture_output=True, text=True)
-
-        if result.returncode != 0:
-            _print_error("Type checking failed!")
-            print(result.stdout)
-            print(result.stderr)
-        else:
-            _print_success("Type checking passed!")
-
-        # Build wheel
-        _print_banner("🏗️", "Building distribution packages...")
-        subprocess.run([sys.executable, "-m", "build"], check=True)
-
-        _print_success("Build completed successfully!")
-        _print_banner("📁", "Distribution files created in 'dist/' directory")
-
-    except subprocess.CalledProcessError as e:
-        _print_error(f"Build failed: {e}")
-        sys.exit(1)
-    except FileNotFoundError:
-        _print_error("Build tools not found. Install with: rapidkit init (or: poetry install --group dev)")
-        sys.exit(1)
-
-
-def test() -> None:
-    """🧪 Run tests with coverage
-
-    Usage:
-        poetry run test [pytest-options]
-
-    Examples:
-        poetry run test
-        poetry run test -v
-        poetry run test tests/test_api.py
-        poetry run test --cov-report=html
-    """
-    _print_banner("🧪", "Running tests with coverage...")
-
-    # Get additional pytest args
-    pytest_args = [arg for arg in sys.argv[2:] if not arg.startswith("-")]
-
-    cmd = [
-        sys.executable, "-m", "pytest",
-        "--cov=src",
-        "--cov-report=term-missing",
-        "--cov-report=xml",
-        "-v"
-    ] + pytest_args
-
-    try:
-        result = subprocess.run(cmd, check=False)
-
-        if result.returncode == 0:
-            _print_success("All tests passed!")
-        else:
-            _print_error("Some tests failed!")
-            sys.exit(result.returncode)
-
-    except FileNotFoundError:
-        _print_error("pytest not found. Install with: rapidkit init (or: poetry install --group dev)")
-        sys.exit(1)
-
-
-def lint() -> None:
-    """� Run code linting and formatting
-
-    This command runs:
-    - ruff for linting
-    - black for formatting
-    - isort for import sorting
-    """
-    _print_banner("�", "Running linting and formatting...")
-
-    try:
-        # Ruff linting
-        _print_banner("📋", "Running ruff linter...")
-        subprocess.run([sys.executable, "-m", "ruff", "check", "src"], check=True)
-
-        # Black formatting
-        _print_banner("🎨", "Running black formatter...")
-        subprocess.run([sys.executable, "-m", "black", "src", "--check"], check=True)
-
-        # isort import sorting
-        _print_banner("📦", "Checking import sorting...")
-        subprocess.run([sys.executable, "-m", "isort", "src", "--check-only"], check=True)
-
-        _print_success("All linting checks passed!")
-
-    except subprocess.CalledProcessError:
-        _print_error("Linting failed! Run 'poetry run format' to fix issues.")
-        sys.exit(1)
-    except FileNotFoundError:
-        _print_error("Linting tools not found. Install with: rapidkit init (or: poetry install --group dev)")
-        sys.exit(1)
-
-
-def format() -> None:
-    """✨ Format code automatically
-
-    This command auto-fixes:
-    - Code formatting with black
-    - Import sorting with isort
-    - Auto-fixable linting issues with ruff
-    """
-    _print_banner("✨", "Formatting code...")
-
-    try:
-        # Ruff auto-fix
-        _print_banner("🔧", "Auto-fixing with ruff...")
-        subprocess.run([sys.executable, "-m", "ruff", "check", "src", "--fix"], check=True)
-
-        # Black formatting
-        _print_banner("🎨", "Formatting with black...")
-        subprocess.run([sys.executable, "-m", "black", "src"], check=True)
-
-        # isort import sorting
-        _print_banner("📦", "Sorting imports with isort...")
-        subprocess.run([sys.executable, "-m", "isort", "src"], check=True)
-
-        _print_success("Code formatting completed!")
-
-    except subprocess.CalledProcessError as e:
-        _print_error(f"Formatting failed: {e}")
-        sys.exit(1)
-    except FileNotFoundError:
-        _print_error("Formatting tools not found. Install with: rapidkit init (or: poetry install --group dev)")
-        sys.exit(1)
-
-
-def help_cmd() -> None:
-    """📚 Show detailed help information"""
-    _print_banner("📚", "{{ project_name }} - Available Commands")
-
-    commands = {
-        "dev": "🚀 Start development server with hot reload",
-        "start": "⚡ Start production server",
-        "build": "📦 Build project for production",
-        "test": "🧪 Run tests with coverage",
-        "lint": "🔧 Run code linting and formatting checks",
-        "format": "✨ Format code automatically",
-        "help": "📚 Show this help message"
-    }
-
-    print("\nCommands:")
-    for cmd, desc in commands.items():
-        print(f"  poetry run {cmd:<10} {desc}")
-
-    print("\nFor detailed command help:")
-    print("  poetry run <command> --help")
-
-    print("\nProject: {{ project_name }}")
-    print("Framework: FastAPI + RapidKit")
-
-
-if __name__ == "__main__":
-    if len(sys.argv) < 2:
-        help_cmd()
-        sys.exit(0)
-
-    command = sys.argv[1]
-    commands = {
-        "dev": dev,
-        "start": start,
-        "build": build,
-        "test": test,
-        "lint": lint,
-        "format": format,
-        "help": help_cmd,
-    }
-
-    if command in commands:
-        commands[command]()
-    else:
-        _print_error(f"Unknown command: {command}")
-        print("\nRun 'poetry run help' to see available commands.")
-        sys.exit(1)

package/templates/kits/fastapi-standard/src/main.py.j2

@@ -1,44 +0,0 @@
-"""{{ project_name }} application entrypoint."""
-
-from __future__ import annotations
-
-from contextlib import asynccontextmanager
-from typing import AsyncIterator
-
-from fastapi import FastAPI
-from fastapi.middleware.cors import CORSMiddleware
-
-# <<<inject:imports>>>
-
-from .routing import api_router
-
-
-@asynccontextmanager
-async def lifespan(app: FastAPI) -> AsyncIterator[None]:
-    """Application lifespan context manager for startup/shutdown events."""
-    # Startup
-    # <<<inject:startup>>>
-    yield
-    # Shutdown
-    # <<<inject:shutdown>>>
-
-
-app = FastAPI(
-    title="{{ project_name }}",
-    description="{{ description }}",
-    version="{{ app_version }}",
-    docs_url="/docs",
-    redoc_url="/redoc",
-    lifespan=lifespan,
-)
-
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=["*"],
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-app.include_router(api_router, prefix="/api")
-# <<<inject:routes>>>

package/templates/kits/fastapi-standard/src/modules/__init__.py.j2

@@ -1,3 +0,0 @@
-"""Module bootstrap namespace."""
-
-# <<<inject:module-init>>>

package/templates/kits/fastapi-standard/src/routing/__init__.py.j2

@@ -1,13 +0,0 @@
-"""API router assembly."""
-
-from __future__ import annotations
-
-from fastapi import APIRouter
-
-from .health import router as health_router
-# <<<inject:router-imports>>>
-
-api_router = APIRouter()
-
-api_router.include_router(health_router)
-# <<<inject:router-mount>>>

package/templates/kits/fastapi-standard/src/routing/health.py.j2

@@ -1,32 +0,0 @@
-"""Health endpoints."""
-
-from __future__ import annotations
-
-from fastapi import APIRouter
-
-try:
-    from src.health.registry import (
-        list_registered_health_routes as _list_registered_health_routes,
-    )
-except ImportError:  # pragma: no cover - registry not generated yet
-    def _list_registered_health_routes(
-        prefix: str = "/api/health",
-    ) -> list[dict[str, str]]:
-        return []
-
-
-router = APIRouter(prefix="/health", tags=["health"])
-
-
-@router.get("/", summary="Health check")
-async def heartbeat() -> dict[str, str]:
-    """Return basic service heartbeat."""
-
-    return {"status": "ok"}
-
-
-@router.get("/modules", summary="Registered module health endpoints")
-async def module_health_catalog() -> dict[str, list[dict[str, str]]]:
-    """Expose metadata for module-provided health routers."""
-
-    return {"routes": _list_registered_health_routes()}

package/templates/kits/fastapi-standard/tests/__init__.py.j2

@@ -1 +0,0 @@
-"""Test package placeholder."""

package/templates/kits/nestjs-standard/.env.example.j2

@@ -1,16 +0,0 @@
-# Application
-APP_NAME={{ project_name | upper | replace('-', '_') }}
-PORT=8000
-HOST=0.0.0.0
-NODE_ENV=development
-
-# Security
-JWT_SECRET=your-super-secret-jwt-key-change-in-production
-JWT_EXPIRATION=1h
-
-# Database (optional)
-# DATABASE_URL=postgresql://user:password@localhost:5432/{{ project_name | replace('-', '_') }}
-
-# Redis (optional)
-# REDIS_HOST=localhost
-# REDIS_PORT=6379

package/templates/kits/nestjs-standard/.eslintrc.js.j2

@@ -1,25 +0,0 @@
-module.exports = {
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    project: ['tsconfig.json'],
-    tsconfigRootDir: __dirname,
-    sourceType: 'module',
-  },
-  plugins: ['@typescript-eslint/eslint-plugin'],
-  extends: [
-    'plugin:@typescript-eslint/recommended',
-    'plugin:prettier/recommended',
-  ],
-  root: true,
-  env: {
-    node: true,
-    jest: true,
-  },
-  ignorePatterns: ['.eslintrc.js'],
-  rules: {
-    '@typescript-eslint/interface-name-prefix': 'off',
-    '@typescript-eslint/explicit-function-return-type': 'off',
-    '@typescript-eslint/explicit-module-boundary-types': 'off',
-    '@typescript-eslint/no-explicit-any': 'warn',
-  },
-};

package/templates/kits/nestjs-standard/.gitignore.j2

@@ -1,26 +0,0 @@
-# Node artifacts
-node_modules/
-dist/
-.tmp/
-.env
-.env.*
-!.env.example
-
-# Logs
-logs/
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-# OS
-.DS_Store
-Thumbs.db
-
-# IDEs
-.idea/
-.vscode/
-
-# Coverage
-coverage/

package/templates/kits/nestjs-standard/.node-version.j2

@@ -1 +0,0 @@
-20

package/templates/kits/nestjs-standard/.nvmrc.j2

@@ -1 +0,0 @@
-20

package/templates/kits/nestjs-standard/.prettierrc.j2

@@ -1,7 +0,0 @@
-{
-  "singleQuote": true,
-  "trailingComma": "all",
-  "printWidth": 100,
-  "tabWidth": 2,
-  "semi": true
-}

package/templates/kits/nestjs-standard/.rapidkit/activate.j2

@@ -1,25 +0,0 @@
-#!/bin/bash
-# RapidKit Environment Activation
-# Usage: source .rapidkit/activate
-
-# Get the directory where this script is located
-RAPIDKIT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$RAPIDKIT_DIR")"
-
-# Add project root to PATH (where rapidkit script lives)
-if [[ ":$PATH:" != *":$PROJECT_ROOT:"* ]]; then
-    export PATH="$PROJECT_ROOT:$PATH"
-    echo "✅ RapidKit activated! You can now use 'rapidkit' commands directly."
-else
-    echo "ℹ️  RapidKit already activated."
-fi
-
-# Show available commands
-echo ""
-echo "📚 Available commands:"
-echo "   rapidkit dev      - Start development server"
-echo "   rapidkit init     - Install dependencies" 
-echo "   rapidkit build    - Build for production"
-echo "   rapidkit test     - Run tests"
-echo "   rapidkit --help   - Show all commands"
-echo ""

package/templates/kits/nestjs-standard/.rapidkit/context.json

@@ -1,3 +0,0 @@
-{
-  "engine": "npm"
-}

package/templates/kits/nestjs-standard/.rapidkit/project.json.j2

@@ -1,7 +0,0 @@
-{
-  "kit_name": "nestjs.standard",
-  "profile": "nestjs/standard",
-  "project_name": "{{ project_name }}",
-  "created_at": "{{ created_at }}",
-  "rapidkit_version": "npm-{{ rapidkit_version }}"
-}