0d0297423e
Some checks failed
CI/CD Pipeline / Test Suite (push) Has been cancelled
CI/CD Pipeline / Security Audit (push) Has been cancelled
CI/CD Pipeline / Performance Benchmarks (push) Has been cancelled
Rust CI / Security Audit (push) Has been cancelled
Rust CI / Check + Test + Lint (nightly) (push) Has been cancelled
Rust CI / Check + Test + Lint (stable) (push) Has been cancelled
CI/CD Pipeline / Build Docker Image (push) Has been cancelled
CI/CD Pipeline / Deploy to Staging (push) Has been cancelled
CI/CD Pipeline / Deploy to Production (push) Has been cancelled
CI/CD Pipeline / Cleanup (push) Has been cancelled
499 lines
15 KiB
Makefile
499 lines
15 KiB
Makefile
# =============================================================================
|
|
# jpl-website - Unified Template System Justfile
|
|
# =============================================================================
|
|
# Generated by cargo rustelo v0.1.0 using unified template system
|
|
# Template: {{template_name}} | Features: {{#each features}}{{this}} {{/each}}
|
|
#
|
|
# This justfile supports layered override system with feature-aware commands.
|
|
# Layer precedence: Local > Feature > Template > Framework
|
|
#
|
|
# IMPORTANT: This file is managed by the template system.
|
|
# Local customizations should go in config/local/justfile (highest precedence).
|
|
|
|
# Set shell for commands
|
|
set shell := ["bash", "-c"]
|
|
|
|
# Import local overrides from layered system
|
|
mod? local 'config/local/justfile'
|
|
{{#each features}}
|
|
mod? {{this}} 'config/features/{{this}}/justfile'
|
|
{{/each}}
|
|
|
|
# =============================================================================
|
|
# CORE PROJECT TASKS
|
|
# =============================================================================
|
|
|
|
# Show available tasks (default)
|
|
default:
|
|
@echo "📋 jpl-website - Available Tasks:"
|
|
@just --list
|
|
|
|
# Start development server with hot reload
|
|
dev:
|
|
@echo "🚀 Starting development server..."
|
|
cargo rustelo dev
|
|
|
|
# Build for development
|
|
build:
|
|
@echo "🔨 Building for development..."
|
|
cargo rustelo build
|
|
|
|
# Build for production (optimized)
|
|
build-prod:
|
|
@echo "🔨 Building for production..."
|
|
cargo rustelo build --release
|
|
|
|
# Run tests
|
|
test:
|
|
@echo "🧪 Running tests..."
|
|
cargo test
|
|
|
|
# Check code quality (lint, format, etc.)
|
|
check:
|
|
@echo "🔍 Checking code quality..."
|
|
cargo check
|
|
cargo clippy
|
|
cargo fmt --check
|
|
|
|
# Format code
|
|
fmt:
|
|
@echo "✨ Formatting code..."
|
|
cargo fmt
|
|
|
|
# Clean build artifacts
|
|
clean:
|
|
@echo "🧹 Cleaning build artifacts..."
|
|
cargo clean
|
|
rm -rf target/
|
|
rm -rf dist/
|
|
|
|
# Install/update dependencies
|
|
deps:
|
|
@echo "📦 Installing dependencies..."
|
|
cargo fetch
|
|
npm install
|
|
|
|
# =============================================================================
|
|
# SETUP AND INITIALIZATION TASKS
|
|
# =============================================================================
|
|
|
|
# Initial project setup
|
|
setup:
|
|
@echo "🔧 Setting up jpl-website..."
|
|
@if [ -f "scripts/setup/install.sh" ]; then \
|
|
chmod +x scripts/setup/*.sh && ./scripts/setup/install.sh; \
|
|
else \
|
|
echo "⚠️ No setup script found, running basic setup..."; \
|
|
just deps; \
|
|
fi
|
|
|
|
# Setup development environment
|
|
setup-dev:
|
|
@echo "🛠️ Setting up development environment..."
|
|
@if [ -f "scripts/setup/setup_dev.sh" ]; then \
|
|
chmod +x scripts/setup/setup_dev.sh && ./scripts/setup/setup_dev.sh; \
|
|
else \
|
|
just setup; \
|
|
fi
|
|
|
|
# =============================================================================
|
|
# ASSET AND BUILD PIPELINE TASKS
|
|
# =============================================================================
|
|
|
|
# List asset resolution paths
|
|
assets-list:
|
|
@echo "📁 Asset resolution paths:"
|
|
cargo rustelo assets list
|
|
|
|
# Check for asset conflicts
|
|
assets-check:
|
|
@echo "🔍 Checking for asset conflicts..."
|
|
cargo rustelo assets check
|
|
|
|
# Organize assets by category
|
|
assets-organize:
|
|
@echo "📂 Organizing assets by category..."
|
|
cargo rustelo assets organize ./dist
|
|
|
|
# Update assets from remote source
|
|
assets-update:
|
|
@echo "⬆️ Updating assets from source..."
|
|
cargo rustelo assets update
|
|
|
|
# =============================================================================
|
|
# DATABASE TASKS (if enabled)
|
|
# =============================================================================
|
|
|
|
# Setup database
|
|
db-setup:
|
|
@echo "🗄️ Setting up database..."
|
|
@if [ -f "scripts/database/db-setup.sh" ]; then \
|
|
chmod +x scripts/database/db-setup.sh && ./scripts/database/db-setup.sh; \
|
|
else \
|
|
echo "⚠️ No database setup script found"; \
|
|
fi
|
|
|
|
# Run database migrations
|
|
db-migrate:
|
|
@echo "🔄 Running database migrations..."
|
|
@if [ -f "scripts/database/db-migrate.sh" ]; then \
|
|
chmod +x scripts/database/db-migrate.sh && ./scripts/database/db-migrate.sh; \
|
|
else \
|
|
echo "⚠️ No migration script found"; \
|
|
fi
|
|
|
|
# Backup database
|
|
db-backup:
|
|
@echo "💾 Creating database backup..."
|
|
@if [ -f "scripts/database/db-backup.sh" ]; then \
|
|
chmod +x scripts/database/db-backup.sh && ./scripts/database/db-backup.sh; \
|
|
else \
|
|
echo "⚠️ No backup script found"; \
|
|
fi
|
|
|
|
# =============================================================================
|
|
# FRAMEWORK AND UPDATE TASKS
|
|
# =============================================================================
|
|
|
|
# Update framework dependencies (safe)
|
|
update:
|
|
@echo "⬆️ Updating framework dependencies..."
|
|
cargo rustelo update
|
|
|
|
# Update with interactive conflict resolution
|
|
update-interactive:
|
|
@echo "⬆️ Interactive framework update..."
|
|
cargo rustelo update --interactive
|
|
|
|
# Show framework and project information
|
|
info:
|
|
@echo "📋 Project Information:"
|
|
@echo " Name: jpl-website"
|
|
@echo " Template: content-website"
|
|
@echo " Generated by: cargo rustelo v0.1.0"
|
|
@echo " Generation time: 2025-10-28T18:46:17.145459+00:00"
|
|
@echo " Rust version: $(rustc --version)"
|
|
@echo " Cargo version: $(cargo --version)"
|
|
@echo " Node version: $(node --version 2>/dev/null || echo 'Not installed')"
|
|
@echo " Project root: $(pwd)"
|
|
|
|
# =============================================================================
|
|
# DEPLOYMENT AND CROSS-COMPILATION
|
|
# =============================================================================
|
|
|
|
# Initialize cross-compilation for Linux
|
|
cross-init:
|
|
@echo "🐋 Initializing cross-compilation..."
|
|
@if [ -f "scripts/build/cross-build.sh" ]; then \
|
|
chmod +x scripts/build/cross-build.sh; \
|
|
fi
|
|
cargo rustelo cross init
|
|
|
|
# Build for Linux using Docker (for deployment)
|
|
cross-build:
|
|
@echo "🐋 Cross-compiling for Linux..."
|
|
@if [ -f "scripts/build/cross-build.sh" ]; then \
|
|
./scripts/build/cross-build.sh; \
|
|
else \
|
|
cargo rustelo cross build; \
|
|
fi
|
|
|
|
# Deploy to production (customize as needed)
|
|
deploy: build-prod
|
|
@echo "🚀 Deploying to production..."
|
|
@if [ -f "scripts/deploy/deploy.sh" ]; then \
|
|
chmod +x scripts/deploy/deploy.sh && ./scripts/deploy/deploy.sh; \
|
|
else \
|
|
echo "⚠️ Customize this task for your deployment target"; \
|
|
echo "📁 Production build available in: target/release/"; \
|
|
fi
|
|
|
|
# =============================================================================
|
|
# TESTING TASKS
|
|
# =============================================================================
|
|
|
|
# Run all tests
|
|
test-all:
|
|
@echo "🧪 Running all tests..."
|
|
@if [ -f "scripts/testing/page-browser-tester.sh" ]; then \
|
|
chmod +x scripts/testing/*.sh; \
|
|
fi
|
|
cargo test
|
|
@if [ -d "end2end" ] && command -v npm >/dev/null 2>&1; then \
|
|
echo "🌐 Running end-to-end tests..."; \
|
|
cd end2end && npm test; \
|
|
fi
|
|
|
|
# Run performance tests
|
|
test-performance:
|
|
@echo "⚡ Running performance tests..."
|
|
@if [ -f "scripts/testing/page-browser-tester.sh" ]; then \
|
|
./scripts/testing/page-browser-tester.sh --performance; \
|
|
else \
|
|
echo "⚠️ No performance testing script found"; \
|
|
fi
|
|
|
|
# =============================================================================
|
|
# FEATURE-SPECIFIC TASKS
|
|
# =============================================================================
|
|
|
|
{{#if features.analytics}}
|
|
# === Analytics Commands ===
|
|
|
|
# Start analytics development server
|
|
analytics-dev:
|
|
@echo "📊 Starting analytics development..."
|
|
cargo run --bin analytics -- dev --port 3001
|
|
|
|
# Generate analytics report
|
|
analytics-report hours="24":
|
|
@echo "📈 Generating analytics report for {{hours}} hours..."
|
|
cargo run --bin analytics -- report --hours {{hours}}
|
|
|
|
# Run analytics dashboard
|
|
analytics-dashboard:
|
|
@echo "📋 Starting analytics dashboard..."
|
|
cargo run --bin analytics -- dashboard --refresh 30
|
|
|
|
# Test analytics functionality
|
|
test-analytics:
|
|
@echo "🧪 Testing analytics..."
|
|
cargo test --package analytics --all-features
|
|
{{/if}}
|
|
|
|
{{#if features.smart-build}}
|
|
# === Smart Build Commands ===
|
|
|
|
# Build with smart caching
|
|
build-cached:
|
|
@echo "⚡ Building with smart cache..."
|
|
cargo run --bin smart-build -- build --cached
|
|
|
|
# Clean build cache
|
|
cache-clean:
|
|
@echo "🧹 Cleaning build cache..."
|
|
cargo run --bin smart-build -- cache clean
|
|
|
|
# Show cache statistics
|
|
cache-stats:
|
|
@echo "📊 Build cache statistics..."
|
|
cargo run --bin smart-build -- cache stats
|
|
|
|
# Optimize cache
|
|
cache-optimize:
|
|
@echo "⚡ Optimizing build cache..."
|
|
cargo run --bin smart-build -- cache optimize
|
|
{{/if}}
|
|
|
|
{{#if features.debugging-tools}}
|
|
# === Debugging Commands ===
|
|
|
|
# Start debug mode with enhanced logging
|
|
dev-debug:
|
|
@echo "🐛 Starting debug mode..."
|
|
RUST_LOG=debug cargo leptos watch
|
|
|
|
# Watch debug logs
|
|
debug-watch:
|
|
@echo "👀 Watching debug logs..."
|
|
cargo run --bin debugging-tools -- watch --verbose
|
|
|
|
# Capture browser logs
|
|
debug-browser page="/":
|
|
@echo "🌐 Capturing browser logs for {{page}}..."
|
|
cargo run --bin debugging-tools -- browser {{page}}
|
|
|
|
# Full debugging session
|
|
debug-full page="/":
|
|
@echo "🔍 Starting full debugging session..."
|
|
cargo run --bin debugging-tools -- full-debug {{page}}
|
|
{{/if}}
|
|
|
|
{{#if features.content-static}}
|
|
# === Content Management Commands ===
|
|
|
|
# Build static content
|
|
content-build:
|
|
@echo "📝 Building static content..."
|
|
cargo run --bin tools -- content build
|
|
|
|
# Watch content changes
|
|
content-watch:
|
|
@echo "👀 Watching content changes..."
|
|
cargo run --bin tools -- content watch
|
|
|
|
# Validate content
|
|
content-validate:
|
|
@echo "✅ Validating content..."
|
|
cargo run --bin tools -- content validate
|
|
{{/if}}
|
|
|
|
# === CSS and Styling Commands ===
|
|
|
|
# Build CSS with UnoCSS (layered configuration)
|
|
css-build:
|
|
@echo "🎨 Building CSS with layered configuration..."
|
|
{{#if has_package_json}}
|
|
npm run css:build
|
|
{{else}}
|
|
cargo run --bin tools -- css build
|
|
{{/if}}
|
|
|
|
# Watch CSS changes
|
|
css-watch:
|
|
@echo "👀 Watching CSS changes..."
|
|
{{#if has_package_json}}
|
|
npm run css:watch
|
|
{{else}}
|
|
cargo run --bin tools -- css watch
|
|
{{/if}}
|
|
|
|
# Optimize CSS for production
|
|
css-optimize:
|
|
@echo "⚡ Optimizing CSS for production..."
|
|
cargo run --bin tools -- css optimize
|
|
|
|
# === Layered Override Management ===
|
|
|
|
# List all active overrides
|
|
list-overrides:
|
|
@echo "📋 Active layered overrides:"
|
|
cargo rustelo list-overrides
|
|
|
|
# Create local override
|
|
override type name:
|
|
@echo "🎛️ Creating local override for {{type}}: {{name}}"
|
|
cargo rustelo override {{type}} {{name}}
|
|
|
|
# Trace resolution path
|
|
trace type name:
|
|
@echo "🔍 Tracing resolution for {{type}}: {{name}}"
|
|
cargo rustelo trace {{type}} {{name}}
|
|
|
|
# Remove local override
|
|
remove-override type name:
|
|
@echo "🗑️ Removing local override for {{type}}: {{name}}"
|
|
cargo rustelo remove-override {{type}} {{name}} --force
|
|
|
|
# =============================================================================
|
|
# UNIFIED DEVELOPMENT WORKFLOWS
|
|
# =============================================================================
|
|
|
|
# Full development mode (all enabled features)
|
|
dev-full:
|
|
@echo "🔥 Starting full development mode..."
|
|
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
# Start development server in background
|
|
cargo leptos watch &
|
|
LEPTOS_PID=$!
|
|
|
|
# Start CSS watcher
|
|
{{#if has_package_json}}
|
|
npm run css:watch &
|
|
CSS_PID=$!
|
|
{{/if}}
|
|
|
|
{{#if features.analytics}}
|
|
# Start analytics development server
|
|
just analytics-dev &
|
|
ANALYTICS_PID=$!
|
|
{{/if}}
|
|
|
|
{{#if features.debugging-tools}}
|
|
# Start debug log watcher
|
|
just debug-watch &
|
|
DEBUG_PID=$!
|
|
{{/if}}
|
|
|
|
echo "🚀 All services started. Press Ctrl+C to stop all."
|
|
|
|
# Trap Ctrl+C and kill all background processes
|
|
trap 'kill $LEPTOS_PID {{#if has_package_json}}$CSS_PID{{/if}} {{#if features.analytics}}$ANALYTICS_PID{{/if}} {{#if features.debugging-tools}}$DEBUG_PID{{/if}} 2>/dev/null' INT
|
|
|
|
# Wait for all background processes
|
|
wait
|
|
|
|
# Quality assurance workflow
|
|
quality:
|
|
@echo "✨ Running comprehensive quality checks..."
|
|
just fmt
|
|
just check
|
|
just test
|
|
{{#if features.analytics}}
|
|
just test-analytics
|
|
{{/if}}
|
|
{{#if features.smart-build}}
|
|
just cache-stats
|
|
{{/if}}
|
|
cargo audit
|
|
|
|
# =============================================================================
|
|
# HELP AND DOCUMENTATION
|
|
# =============================================================================
|
|
|
|
# Show detailed help for common workflows
|
|
help:
|
|
@echo "🚀 jpl-website - Common Workflows:"
|
|
@echo ""
|
|
@echo "🔧 Development:"
|
|
@echo " just setup # Initial project setup"
|
|
@echo " just dev # Start development server"
|
|
@echo " just test # Run tests"
|
|
@echo " just check # Check code quality"
|
|
@echo ""
|
|
@echo "🔨 Building:"
|
|
@echo " just build # Development build"
|
|
@echo " just build-prod # Production build"
|
|
@echo " just clean # Clean artifacts"
|
|
@echo ""
|
|
@echo "🗄️ Database:"
|
|
@echo " just db-setup # Setup database"
|
|
@echo " just db-migrate # Run migrations"
|
|
@echo " just db-backup # Backup database"
|
|
@echo ""
|
|
@echo "🎨 Assets:"
|
|
@echo " just assets-list # Show asset paths"
|
|
@echo " just assets-check # Check conflicts"
|
|
@echo " just assets-update# Update from source"
|
|
@echo ""
|
|
@echo "⬆️ Updates:"
|
|
@echo " just update # Safe framework update"
|
|
@echo " just info # Show project info"
|
|
@echo ""
|
|
@echo "🚀 Deployment:"
|
|
@echo " just cross-init # Setup cross-compilation"
|
|
@echo " just cross-build # Build for Linux"
|
|
@echo " just deploy # Deploy to production"
|
|
@echo ""
|
|
@echo "📖 More help:"
|
|
@echo " cargo rustelo --help # All available commands"
|
|
@echo " just --list # All available tasks"
|
|
|
|
# Show framework-specific help
|
|
help-framework:
|
|
@echo "🦀 Rustelo Framework Help:"
|
|
cargo rustelo --help
|
|
|
|
# =============================================================================
|
|
# LOCAL CUSTOMIZATION NOTES
|
|
# =============================================================================
|
|
#
|
|
# To add local tasks without modifying this file:
|
|
# 1. Create 'local-tasks.just' in this directory
|
|
# 2. Add your custom tasks there
|
|
# 3. They will be automatically imported above
|
|
#
|
|
# Example local-tasks.just:
|
|
# ```
|
|
# # Custom deployment task
|
|
# deploy-staging:
|
|
# @echo "Deploying to staging..."
|
|
# # Your custom deployment commands
|
|
# ```
|
|
#
|
|
# This approach keeps your customizations separate from the generated file,
|
|
# making framework updates safe and preserving your local modifications.
|
|
# =============================================================================
|