282 lines
10 KiB
Text
282 lines
10 KiB
Text
|
# =============================================================================
|
||
|
|
# RUSTELO TOOLS MODULE
|
||
|
|
# Unified development toolkit for analysis, generation, and publishing
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Set shell for all commands in this module
|
||
|
|
set shell := ["bash", "-c"]
|
||
|
|
|
||
|
|
# Tools binary path
|
||
|
|
TOOLS_BIN := "cargo run --package tools --bin tools --features cli"
|
||
|
|
|
||
|
|
# =============================================================================
|
||
|
|
# ANALYSIS & DOCUMENTATION
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Generate comprehensive project analysis and documentation
|
||
|
|
tools-analyze format="markdown" output="site/info":
|
||
|
|
@echo "🔍 Analyzing project structure..."
|
||
|
|
{{TOOLS_BIN}} analyze --format {{format}} --output {{output}}
|
||
|
|
@echo "✅ Analysis complete! Check {{output}}/"
|
||
|
|
|
||
|
|
# Generate documentation only (alias for analyze)
|
||
|
|
tools-docs: (tools-analyze "markdown" "site/info")
|
||
|
|
|
||
|
|
# Validate generated documentation
|
||
|
|
tools-validate:
|
||
|
|
@echo "📋 Validating generated documentation..."
|
||
|
|
@if [ -d "site/info" ]; then \
|
||
|
|
echo "✅ Documentation directory exists"; \
|
||
|
|
find site/info -name "*.md" -exec echo " 📄 {}" \;; \
|
||
|
|
find site/info -name "*.json" -exec echo " 📊 {}" \;; \
|
||
|
|
else \
|
||
|
|
echo "❌ No documentation found. Run: just tools-analyze"; \
|
||
|
|
exit 1; \
|
||
|
|
fi
|
||
|
|
|
||
|
|
# Clean generated documentation
|
||
|
|
tools-clean:
|
||
|
|
@echo "🧹 Cleaning generated documentation..."
|
||
|
|
rm -rf site/info
|
||
|
|
@echo "✅ Documentation cleaned"
|
||
|
|
|
||
|
|
# Refresh documentation (clean + generate)
|
||
|
|
tools-refresh: tools-clean tools-analyze
|
||
|
|
|
||
|
|
# =============================================================================
|
||
|
|
# CODE GENERATION
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Generate a new page
|
||
|
|
tools-generate-page name template="basic":
|
||
|
|
@echo "🚀 Generating page: {{name}}"
|
||
|
|
{{TOOLS_BIN}} generate page {{name}} --template {{template}}
|
||
|
|
|
||
|
|
# Generate a new component
|
||
|
|
tools-generate-component name template="basic":
|
||
|
|
@echo "🧩 Generating component: {{name}}"
|
||
|
|
{{TOOLS_BIN}} generate component {{name}} --template {{template}}
|
||
|
|
|
||
|
|
# Generate a new route
|
||
|
|
tools-generate-route path:
|
||
|
|
@echo "🛣️ Generating route: {{path}}"
|
||
|
|
{{TOOLS_BIN}} generate route {{path}}
|
||
|
|
|
||
|
|
# Generate a new template
|
||
|
|
tools-generate-template name:
|
||
|
|
@echo "📄 Generating template: {{name}}"
|
||
|
|
{{TOOLS_BIN}} generate template {{name}}
|
||
|
|
|
||
|
|
# List available templates
|
||
|
|
tools-list-templates:
|
||
|
|
@echo "📋 Available templates:"
|
||
|
|
@if [ -d "site/templates" ]; then \
|
||
|
|
find site/templates -name "*.tera" -exec basename {} .tera \;; \
|
||
|
|
else \
|
||
|
|
echo " No templates directory found"; \
|
||
|
|
fi
|
||
|
|
|
||
|
|
# =============================================================================
|
||
|
|
# INTERACTIVE MANAGEMENT
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Launch interactive tools manager (TUI)
|
||
|
|
tools-manage mode="dashboard":
|
||
|
|
@echo "🎛️ Launching Rustelo Tools Manager..."
|
||
|
|
{{TOOLS_BIN}} manage --mode {{mode}}
|
||
|
|
|
||
|
|
# Quick page editor
|
||
|
|
tools-edit-page name:
|
||
|
|
@echo "✏️ Editing page: {{name}}"
|
||
|
|
{{TOOLS_BIN}} manage --mode editor --page {{name}}
|
||
|
|
|
||
|
|
# =============================================================================
|
||
|
|
# PUBLISHING & SYNC
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Sync with main Rustelo project
|
||
|
|
tools-sync target="templates":
|
||
|
|
@echo "🔄 Syncing {{target}} with Rustelo project..."
|
||
|
|
{{TOOLS_BIN}} publish sync {{target}}
|
||
|
|
|
||
|
|
# Package project for distribution
|
||
|
|
tools-package format="template" output="dist":
|
||
|
|
@echo "📦 Packaging project ({{format}})..."
|
||
|
|
{{TOOLS_BIN}} publish package --format {{format}} --output {{output}}
|
||
|
|
|
||
|
|
# Deploy documentation
|
||
|
|
tools-deploy target="github-pages":
|
||
|
|
@echo "🚀 Deploying documentation to {{target}}..."
|
||
|
|
{{TOOLS_BIN}} docs deploy {{target}}
|
||
|
|
|
||
|
|
# Serve documentation locally
|
||
|
|
tools-serve port="8080":
|
||
|
|
@echo "🌐 Serving documentation on http://localhost:{{port}}"
|
||
|
|
{{TOOLS_BIN}} docs serve --port {{port}}
|
||
|
|
|
||
|
|
# =============================================================================
|
||
|
|
# DEVELOPMENT WORKFLOW INTEGRATION
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Complete development setup with tools integration
|
||
|
|
tools-dev-complete:
|
||
|
|
#!/usr/bin/env bash
|
||
|
|
echo "🚀 Starting complete Rustelo development environment..."
|
||
|
|
|
||
|
|
# Start main development server in background
|
||
|
|
echo " 🌐 Starting development server..."
|
||
|
|
just dev &
|
||
|
|
DEV_PID=$!
|
||
|
|
|
||
|
|
# Generate fresh documentation
|
||
|
|
echo " 📚 Generating documentation..."
|
||
|
|
just tools-analyze
|
||
|
|
|
||
|
|
# Start documentation server
|
||
|
|
echo " 📖 Starting documentation server..."
|
||
|
|
just tools-serve 8081 &
|
||
|
|
DOCS_PID=$!
|
||
|
|
|
||
|
|
echo ""
|
||
|
|
echo "✅ Development environment ready!"
|
||
|
|
echo " 🌐 Main app: http://localhost:3030"
|
||
|
|
echo " 📖 Documentation: http://localhost:8081"
|
||
|
|
echo " 🎛️ Tools manager: just tools-manage"
|
||
|
|
echo ""
|
||
|
|
echo "Press Ctrl+C to stop all services..."
|
||
|
|
|
||
|
|
# Trap Ctrl+C to cleanup
|
||
|
|
trap 'echo "🛑 Shutting down..."; kill $DEV_PID $DOCS_PID 2>/dev/null; exit' INT
|
||
|
|
|
||
|
|
# Wait for Ctrl+C
|
||
|
|
wait
|
||
|
|
|
||
|
|
# Fast development with automatic tools refresh
|
||
|
|
tools-dev-watch:
|
||
|
|
#!/usr/bin/env bash
|
||
|
|
echo "👁️ Starting development with tools auto-refresh..."
|
||
|
|
|
||
|
|
# Start development server
|
||
|
|
just dev &
|
||
|
|
DEV_PID=$!
|
||
|
|
|
||
|
|
# Watch for changes and regenerate docs
|
||
|
|
echo " 🔍 Watching for changes..."
|
||
|
|
while true; do
|
||
|
|
if command -v fswatch >/dev/null 2>&1; then
|
||
|
|
fswatch -o src/ site/ | while read; do
|
||
|
|
echo " 🔄 Changes detected, regenerating documentation..."
|
||
|
|
just tools-analyze > /dev/null 2>&1
|
||
|
|
done
|
||
|
|
else
|
||
|
|
echo " ⚠️ fswatch not available, install with: brew install fswatch"
|
||
|
|
echo " 📚 Generating documentation once..."
|
||
|
|
just tools-analyze
|
||
|
|
break
|
||
|
|
fi
|
||
|
|
done &
|
||
|
|
WATCH_PID=$!
|
||
|
|
|
||
|
|
trap 'echo "🛑 Shutting down..."; kill $DEV_PID $WATCH_PID 2>/dev/null; exit' INT
|
||
|
|
wait
|
||
|
|
|
||
|
|
# Setup tools development environment
|
||
|
|
tools-setup:
|
||
|
|
@echo "🔧 Setting up Rustelo Tools development environment..."
|
||
|
|
@echo " 📦 Checking tools crate..."
|
||
|
|
cargo check --package tools --features analysis-only
|
||
|
|
@echo " 📁 Creating directories..."
|
||
|
|
mkdir -p site/info site/templates dist
|
||
|
|
@echo " 📋 Generating initial documentation..."
|
||
|
|
just tools-analyze
|
||
|
|
@echo "✅ Tools environment ready!"
|
||
|
|
|
||
|
|
# =============================================================================
|
||
|
|
# UTILITIES & DIAGNOSTICS
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Show tools status and capabilities
|
||
|
|
tools-status:
|
||
|
|
@echo "🛠️ Rustelo Tools Status"
|
||
|
|
@echo "========================"
|
||
|
|
@echo ""
|
||
|
|
@echo "📦 Crate Status:"
|
||
|
|
@cargo check --package tools --quiet && echo " ✅ Tools crate builds successfully" || echo " ❌ Tools crate has build errors"
|
||
|
|
@echo ""
|
||
|
|
@echo "🎯 Available Features:"
|
||
|
|
@echo " 📊 analysis-only (minimal build features)"
|
||
|
|
@echo " 🎨 templates (Tera template system)"
|
||
|
|
@echo " 🎛️ cli (interactive management)"
|
||
|
|
@echo " 📡 publishing (sync & deployment)"
|
||
|
|
@echo ""
|
||
|
|
@echo "📁 Generated Content:"
|
||
|
|
@if [ -d "site/info" ]; then \
|
||
|
|
echo " 📚 Documentation: $(find site/info -name "*.md" | wc -l) markdown files"; \
|
||
|
|
echo " 📊 Data files: $(find site/info -name "*.json" | wc -l) JSON files"; \
|
||
|
|
else \
|
||
|
|
echo " 📚 No documentation generated yet"; \
|
||
|
|
fi
|
||
|
|
@echo ""
|
||
|
|
@echo "🚀 Quick Start:"
|
||
|
|
@echo " just tools-analyze # Generate documentation"
|
||
|
|
@echo " just tools-manage # Interactive manager"
|
||
|
|
@echo " just tools-dev-complete # Full development environment"
|
||
|
|
|
||
|
|
# Test all tools functionality
|
||
|
|
tools-test:
|
||
|
|
@echo "🧪 Testing Rustelo Tools functionality..."
|
||
|
|
@echo " 📊 Testing analysis..."
|
||
|
|
just tools-analyze > /dev/null 2>&1 && echo " ✅ Analysis works" || echo " ❌ Analysis failed"
|
||
|
|
@echo " 🏗️ Testing build..."
|
||
|
|
cargo check --package tools --quiet && echo " ✅ Build works" || echo " ❌ Build failed"
|
||
|
|
@echo " 📋 Testing documentation generation..."
|
||
|
|
@[ -d "site/info" ] && echo " ✅ Documentation generated" || echo " ❌ No documentation found"
|
||
|
|
|
||
|
|
# Show available tools commands
|
||
|
|
tools-help:
|
||
|
|
@echo "🛠️ Rustelo Tools Commands"
|
||
|
|
@echo "=========================="
|
||
|
|
@echo ""
|
||
|
|
@echo "📊 Analysis & Documentation:"
|
||
|
|
@echo " tools-analyze Generate project analysis"
|
||
|
|
@echo " tools-docs Generate documentation (alias)"
|
||
|
|
@echo " tools-validate Validate generated docs"
|
||
|
|
@echo " tools-refresh Clean and regenerate docs"
|
||
|
|
@echo " tools-clean Remove generated docs"
|
||
|
|
@echo ""
|
||
|
|
@echo "🚀 Code Generation:"
|
||
|
|
@echo " tools-generate-page Create new page"
|
||
|
|
@echo " tools-generate-component Create new component"
|
||
|
|
@echo " tools-generate-route Create new route"
|
||
|
|
@echo " tools-list-templates Show available templates"
|
||
|
|
@echo ""
|
||
|
|
@echo "🎛️ Interactive Management:"
|
||
|
|
@echo " tools-manage Launch TUI manager"
|
||
|
|
@echo " tools-edit-page Quick page editor"
|
||
|
|
@echo ""
|
||
|
|
@echo "📡 Publishing & Sync:"
|
||
|
|
@echo " tools-sync Sync with Rustelo project"
|
||
|
|
@echo " tools-package Package for distribution"
|
||
|
|
@echo " tools-deploy Deploy documentation"
|
||
|
|
@echo " tools-serve Serve docs locally"
|
||
|
|
@echo ""
|
||
|
|
@echo "🔧 Development Workflow:"
|
||
|
|
@echo " tools-dev-complete Complete dev environment"
|
||
|
|
@echo " tools-dev-watch Dev with auto-refresh"
|
||
|
|
@echo " tools-setup Setup tools environment"
|
||
|
|
@echo ""
|
||
|
|
@echo "🔍 Utilities:"
|
||
|
|
@echo " tools-status Show tools status"
|
||
|
|
@echo " tools-test Test functionality"
|
||
|
|
@echo " tools-help Show this help"
|
||
|
|
|
||
|
|
# =============================================================================
|
||
|
|
# ALIASES FOR CONVENIENCE
|
||
|
|
# =============================================================================
|
||
|
|
|
||
|
|
# Short aliases for common commands
|
||
|
|
alias ta := tools-analyze
|
||
|
|
alias tm := tools-manage
|
||
|
|
alias tg := tools-generate-page
|
||
|
|
alias ts := tools-status
|
||
|
|
alias th := tools-help
|