rapidkit 0.11.3 → 0.12.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapidkit",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "type": "module",
   "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapidkit",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "type": "module",
   "description": "Create RapidKit projects with a single command - The official CLI for RapidKit framework",
   "keywords": [

package/templates/generator.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+/**
+ * RapidKit Project Generator
+ * This script is called by the rapidkit CLI to generate projects
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { execSync } = require('child_process');
+
+const TEMPLATES_DIR = path.join(__dirname, 'templates');
+
+async function generateProject(projectPath, template, useDefaults, skipGit, skipInstall) {
+  const projectName = path.basename(projectPath);
+  const templateDir = template === 'nestjs' ? 'nestjs-standard' : 'fastapi-standard';
+  const templatePath = path.join(TEMPLATES_DIR, templateDir);
+
+  // Check template exists
+  try {
+    await fs.access(templatePath);
+  } catch {
+    console.error('❌ Template not found:', templateDir);
+    process.exit(1);
+  }
+
+  // Create project directory
+  await fs.mkdir(projectPath, { recursive: true });
+
+  // Build context
+  const context = {
+    project_name: template === 'nestjs' 
+      ? projectName.replace(/_/g, '-').toLowerCase() 
+      : projectName.replace(/-/g, '_').toLowerCase(),
+    author: process.env.USER || 'RapidKit User',
+    description: template === 'nestjs' 
+      ? 'NestJS application generated with RapidKit' 
+      : 'FastAPI service generated with RapidKit',
+    app_version: '0.1.0',
+    license: 'MIT',
+    package_manager: 'npm',
+    created_at: new Date().toISOString(),
+    rapidkit_version: require('./config.json').rapidkit_version || '0.12.0',
+  };
+
+  // Copy and render template files
+  await copyTemplateDir(templatePath, projectPath, context);
+
+  console.log('✅ Project files created!');
+
+  // Git initialization
+  if (!skipGit) {
+    try {
+      execSync('git init', { cwd: projectPath, stdio: 'pipe' });
+      execSync('git add .', { cwd: projectPath, stdio: 'pipe' });
+      const commitMsg = 'Initial commit: ' + (template === 'nestjs' ? 'NestJS' : 'FastAPI') + ' project via RapidKit';
+      execSync(`git commit -m "${commitMsg}"`, { cwd: projectPath, stdio: 'pipe' });
+      console.log('✅ Git repository initialized');
+    } catch (e) {
+      console.log('⚠️  Could not initialize git');
+    }
+  }
+
+  // Install dependencies
+  if (!skipInstall) {
+    if (template === 'nestjs') {
+      console.log('📦 Installing dependencies...');
+      try {
+        execSync('npm install', { cwd: projectPath, stdio: 'inherit' });
+        console.log('✅ Dependencies installed');
+      } catch {
+        console.log('⚠️  Could not install dependencies. Run npm install manually.');
+      }
+    }
+  }
+
+  // Success message
+  const templateName = template === 'nestjs' ? 'NestJS' : 'FastAPI';
+  console.log('');
+  console.log('✨ ' + templateName + ' project created successfully!');
+  console.log('');
+  console.log('🚀 Get started:');
+  console.log('  cd ' + projectName);
+  if (template === 'fastapi') {
+    console.log('  rapidkit init    # poetry install');
+    console.log('  rapidkit dev     # Start dev server');
+  } else {
+    if (skipInstall) {
+      console.log('  rapidkit init    # npm install');
+    }
+    console.log('  cp .env.example .env');
+    console.log('  rapidkit dev     # Start dev server');
+  }
+  console.log('');
+}
+
+function renderTemplate(content, context) {
+  let result = content;
+  
+  for (const [key, value] of Object.entries(context)) {
+    // Simple variable replacement: {{ key }}
+    const simpleRegex = new RegExp(`\\{\\{\\s*${key}\\s*\\}\\}`, 'g');
+    result = result.replace(simpleRegex, String(value));
+    
+    // With replace filter: {{ key | replace('a', 'b') }}
+    const replaceRegex = new RegExp(
+      `\\{\\{\\s*${key}\\s*\\|\\s*replace\\s*\\(\\s*['"]([^'"]+)['"]\\s*,\\s*['"]([^'"]*)['"]\\s*\\)\\s*\\}\\}`,
+      'g'
+    );
+    result = result.replace(replaceRegex, (match, from, to) => {
+      return String(value).replace(new RegExp(from, 'g'), to);
+    });
+    
+    // With lower filter: {{ key | lower }}
+    const lowerRegex = new RegExp(`\\{\\{\\s*${key}\\s*\\|\\s*lower\\s*\\}\\}`, 'g');
+    result = result.replace(lowerRegex, String(value).toLowerCase());
+    
+    // Combined: {{ key | replace('a', 'b') | lower }}
+    const combinedRegex = new RegExp(
+      `\\{\\{\\s*${key}\\s*\\|\\s*replace\\s*\\(\\s*['"]([^'"]+)['"]\\s*,\\s*['"]([^'"]*)['"]\\s*\\)\\s*\\|\\s*lower\\s*\\}\\}`,
+      'g'
+    );
+    result = result.replace(combinedRegex, (match, from, to) => {
+      return String(value).replace(new RegExp(from, 'g'), to).toLowerCase();
+    });
+  }
+  
+  return result;
+}
+
+async function copyTemplateDir(src, dest, context) {
+  const entries = await fs.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destName = entry.name.replace(/\.j2$/, '');
+    const destPath = path.join(dest, destName);
+
+    if (entry.isDirectory()) {
+      await fs.mkdir(destPath, { recursive: true });
+      await copyTemplateDir(srcPath, destPath, context);
+    } else {
+      let content = await fs.readFile(srcPath, 'utf-8');
+
+      // Render template if it's a .j2 file
+      if (entry.name.endsWith('.j2')) {
+        content = renderTemplate(content, context);
+      }
+
+      await fs.writeFile(destPath, content);
+
+      // Make scripts executable
+      if (destName === 'rapidkit' || (destName.endsWith('.py') && destPath.includes('.rapidkit'))) {
+        await fs.chmod(destPath, 0o755);
+      }
+    }
+  }
+}
+
+// Main
+const args = process.argv.slice(2);
+const projectPath = args[0];
+const template = args[1] || 'fastapi';
+const useDefaults = args.includes('--yes');
+const skipGit = args.includes('--skip-git');
+const skipInstall = args.includes('--skip-install');
+
+if (!projectPath) {
+  console.error('Usage: node generator.js <project-path> <template> [--yes] [--skip-git] [--skip-install]');
+  process.exit(1);
+}
+
+generateProject(projectPath, template, useDefaults, skipGit, skipInstall).catch(err => {
+  console.error('Error:', err);
+  process.exit(1);
+});

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

@@ -0,0 +1 @@
+# RapidKit local CLI module

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

@@ -0,0 +1,24 @@
+#!/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 test     - Run tests"
+echo "   rapidkit --help   - Show all commands"
+echo ""

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

@@ -74,11 +74,13 @@ def dev(port: int = 8000, host: str = "0.0.0.0", allow_global_runtime: bool = Fa
 
     if ptype == "python":
         venv_dir = root / ".venv"
+        _print_banner("📁", f"Working directory: {root}")
+        _print_banner("🌐", f"Server will be available at: http://{host}:{port}")
 
         if venv_dir.exists():
             if not _venv_has_uvicorn(venv_dir):
                 print("❌ Project .venv was found but uvicorn/fastapi doesn't appear installed.")
-                print("💡 Run 'poetry install' to install dependencies.")
+                print("💡 Run 'rapidkit init' to install dependencies.")
                 sys.exit(1)
         else:
             if not allow_global_runtime:
@@ -86,7 +88,7 @@ def dev(port: int = 8000, host: str = "0.0.0.0", allow_global_runtime: bool = Fa
                 print("")
                 print("💡 Initialize and install dependencies with:")
                 print("")
-                print("  poetry install")
+                print("  rapidkit init")
                 print("")
                 print("If you intentionally want to use the system Python, run:")
                 print("")
@@ -97,12 +99,12 @@ def dev(port: int = 8000, host: str = "0.0.0.0", allow_global_runtime: bool = Fa
             if shutil.which("uvicorn") is None:
                 print("❌ No uvicorn executable found on PATH and no .venv present.")
                 print("")
-                print("💡 Install dependencies with: poetry install")
+                print("💡 Install dependencies with: rapidkit init")
                 print("")
                 sys.exit(1)
             print("⚠️  Running with system/global Python runtime.")
 
-        rc = _run(sys.executable, "-m", "uvicorn", "src.main:app", "--reload", "--host", host, "--port", str(port))
+        rc = _run(sys.executable, "-m", "uvicorn", "src.main:app", "--reload", "--reload-dir", "src", "--host", host, "--port", str(port))
         if rc != 0:
             sys.exit(rc)
     else:

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

@@ -1,6 +1,7 @@
 {
   "kit_name": "fastapi.standard",
   "profile": "fastapi/standard",
-  "created_at": "{{ created_at | default(now) }}",
-  "rapidkit_version": "npm-demo"
+  "project_name": "{{ project_name }}",
+  "created_at": "{{ created_at }}",
+  "rapidkit_version": "npm-{{ rapidkit_version }}"
 }

package/templates/kits/fastapi-standard/.rapidkit/rapidkit.j2

@@ -5,6 +5,37 @@
 set -euo pipefail
 ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
 
+show_help() {
+  cat << 'EOF'
+📚 RapidKit FastAPI Project Commands
+
+Usage: rapidkit <command> [options]
+
+Commands:
+  init         📦 Initialize project (poetry install)
+  dev          🚀 Start development server with hot reload
+  start        ⚡ Start production server
+  test         🧪 Run tests
+  lint         🔧 Lint code
+  format       ✨ Format code
+  help         📚 Show this help
+
+Examples:
+  rapidkit init      # Install dependencies
+  rapidkit dev       # Start dev server
+
+💡 Note: Commands are run through Poetry.
+EOF
+}
+
+# Handle help
+case "${1:-}" in
+  help|--help|-h|"")
+    show_help
+    exit 0
+    ;;
+esac
+
 # Detect project type
 if [ -f "$ROOT_DIR/pyproject.toml" ]; then
   PKG_TYPE="python"

package/templates/kits/fastapi-standard/Makefile.j2

@@ -0,0 +1,41 @@
+# RapidKit Project Commands
+# Usage: make <command>
+
+.PHONY: init dev start build test lint format help
+
+# Default target
+help:
+	@echo "🚀 RapidKit Commands"
+	@echo ""
+	@echo "Usage: make <command>"
+	@echo ""
+	@echo "Commands:"
+	@echo "  init      📦 Install dependencies (poetry install)"
+	@echo "  dev       🔥 Start development server"
+	@echo "  start     ⚡ Start production server"
+	@echo "  build     📦 Build for production"
+	@echo "  test      🧪 Run tests"
+	@echo "  lint      🔧 Run linting"
+	@echo "  format    ✨ Format code"
+	@echo ""
+
+init:
+	@poetry install
+
+dev:
+	@poetry run dev
+
+start:
+	@poetry run start
+
+build:
+	@poetry run build
+
+test:
+	@poetry run test
+
+lint:
+	@poetry run lint
+
+format:
+	@poetry run format

package/templates/kits/fastapi-standard/pyproject.toml.j2

@@ -7,6 +7,7 @@ license = "{{ license }}"
 packages = [{ include = "src" }]
 
 [tool.poetry.scripts]
+rapidkit = ".rapidkit.cli:main"
 dev = "src.cli:dev"
 start = "src.cli:start"
 build = "src.cli:build"

package/templates/kits/fastapi-standard/rapidkit.j2

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# RapidKit CLI - Local project commands
+# This wrapper delegates to .rapidkit/cli.py with smart Python detection
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+CLI_PY="${SCRIPT_DIR}/.rapidkit/cli.py"
+
+# Find the best Python to use
+find_python() {
+  # 1. Project venv
+  if [ -x "${SCRIPT_DIR}/.venv/bin/python" ]; then
+    echo "${SCRIPT_DIR}/.venv/bin/python"
+    return 0
+  fi
+  
+  # 2. Poetry's python
+  if command -v poetry >/dev/null 2>&1; then
+    POETRY_PY="$(poetry env info --executable 2>/dev/null || true)"
+    if [ -n "$POETRY_PY" ] && [ -x "$POETRY_PY" ]; then
+      echo "$POETRY_PY"
+      return 0
+    fi
+  fi
+  
+  # 3. System python3
+  if command -v python3 >/dev/null 2>&1; then
+    echo "python3"
+    return 0
+  fi
+  
+  # 4. System python
+  if command -v python >/dev/null 2>&1; then
+    echo "python"
+    return 0
+  fi
+  
+  return 1
+}
+
+# Find Python
+PYTHON_CMD="$(find_python)" || {
+  echo "❌ No Python interpreter found."
+  echo "💡 Install Python 3.11+ and try again."
+  exit 127
+}
+
+# Execute the CLI
+exec "$PYTHON_CMD" "$CLI_PY" "$@"

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

@@ -0,0 +1,16 @@
+# 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

@@ -0,0 +1,25 @@
+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

@@ -0,0 +1,26 @@
+# 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

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

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

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

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

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

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

@@ -0,0 +1,25 @@
+#!/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/project.json.j2

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