infomankit 0.3.23__py3-none-any.whl

infoman/cli/templates/Makefile.template

@@ -0,0 +1,132 @@
+# Makefile for infomankit-based project
+# Generated by: infomankit makefile
+.PHONY: help install dev test lint format clean docker-build docker-up docker-down
+
+.DEFAULT_GOAL := help
+
+# Variables
+PYTHON := python3
+PIP := pip
+PYTEST := pytest
+DOCKER_COMPOSE := docker compose
+PROJECT_NAME := {{PROJECT_NAME}}
+
+help: ## Show this help message
+	@echo '════════════════════════════════════════════════════════'
+	@echo '         $(PROJECT_NAME) - Development Commands        '
+	@echo '════════════════════════════════════════════════════════'
+	@echo ''
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'
+	@echo ''
+
+# ==================== Installation ====================
+
+install: ## Install dependencies
+	$(PIP) install -e .
+
+install-dev: ## Install with dev dependencies
+	$(PIP) install -e ".[dev]"
+
+install-full: ## Install with all features
+	$(PIP) install -e ".[full]"
+
+upgrade: ## Upgrade dependencies
+	$(PIP) install --upgrade pip
+	$(PIP) install --upgrade -e .
+
+# ==================== Development ====================
+
+dev: ## Run development server
+	infoman-serve run main:app --host 0.0.0.0 --port 8000 --reload
+
+run: ## Run production server
+	infoman-serve run main:app --host 0.0.0.0 --port 8000
+
+# ==================== Testing ====================
+
+test: ## Run tests
+	$(PYTEST) tests/ -v
+
+test-cov: ## Run tests with coverage
+	$(PYTEST) tests/ -v --cov --cov-report=term-missing --cov-report=html
+
+test-watch: ## Run tests in watch mode
+	$(PYTEST) tests/ -v --watch
+
+# ==================== Code Quality ====================
+
+lint: ## Run linting
+	ruff check .
+
+lint-fix: ## Fix linting issues
+	ruff check . --fix
+
+format: ## Format code
+	ruff format .
+
+format-check: ## Check formatting
+	ruff format . --check
+
+typecheck: ## Run type checking (if mypy installed)
+	@command -v mypy >/dev/null 2>&1 && mypy . || echo "mypy not installed, skipping"
+
+qa: lint format-check ## Run all quality checks
+
+# ==================== Docker ====================
+
+docker-build: ## Build Docker image
+	docker build -t $(PROJECT_NAME):latest .
+
+docker-up: ## Start services
+	$(DOCKER_COMPOSE) up -d
+
+docker-down: ## Stop services
+	$(DOCKER_COMPOSE) down
+
+docker-logs: ## Show logs
+	$(DOCKER_COMPOSE) logs -f
+
+docker-clean: ## Clean Docker resources
+	$(DOCKER_COMPOSE) down -v --remove-orphans
+
+docker-restart: docker-down docker-up ## Restart services
+
+# ==================== Database ====================
+
+db-migrate: ## Run database migrations
+	@echo "Run your migration command here"
+	@echo "e.g., alembic upgrade head"
+
+db-rollback: ## Rollback last migration
+	@echo "Run your rollback command here"
+	@echo "e.g., alembic downgrade -1"
+
+# ==================== Utilities ====================
+
+clean: ## Clean build artifacts
+	rm -rf build/ dist/ *.egg-info
+	rm -rf .pytest_cache/ .ruff_cache/ .mypy_cache/
+	rm -rf htmlcov/ .coverage coverage.xml
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name '*.pyc' -delete
+	find . -type f -name '*.pyo' -delete
+
+clean-logs: ## Clean log files
+	rm -rf logs/*.log
+
+clean-all: clean clean-logs docker-clean ## Clean everything
+
+init-env: ## Initialize .env from example
+	@if [ ! -f .env ]; then \
+		cp .env.example .env && \
+		echo "✅ .env file created" && \
+		echo "⚠️  Update .env with your configuration"; \
+	else \
+		echo "⚠️  .env already exists"; \
+	fi
+
+tree: ## Show project structure
+	@tree -I '__pycache__|*.pyc|*.egg-info|.git|.venv|node_modules' -L 3 || echo "tree command not found"
+
+lines: ## Count lines of code
+	@find . -name '*.py' -not -path "./.venv/*" -not -path "./build/*" | xargs wc -l | tail -1

infoman/cli/templates/app/__init__.py.template

@@ -0,0 +1,3 @@
+"""
+{project_name} Application Package
+"""

infoman/cli/templates/app/app.py.template

@@ -0,0 +1,4 @@
+from infoman.service.app import application
+from app.routers import api_router
+
+application.include_router(api_router)

infoman/cli/templates/app/models_base.py.template

@@ -0,0 +1,18 @@
+"""
+Base Model
+
+Base class for all ORM models with common fields.
+"""
+
+from sqlalchemy import Column, Integer, DateTime, func
+from app.core.database import Base
+
+
+class BaseModel(Base):
+    """Base model with common fields"""
+
+    __abstract__ = True
+
+    id = Column(Integer, primary_key=True, index=True, autoincrement=True)
+    created_at = Column(DateTime(timezone=True), server_default=func.now(), nullable=False)
+    updated_at = Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now(), nullable=False)

infoman/cli/templates/app/models_entity_init.py.template

@@ -0,0 +1,11 @@
+"""
+Entity Models
+
+Import all entity models here for Alembic auto-generation.
+"""
+
+# Example:
+# from app.models.entity.user import User
+# from app.models.entity.product import Product
+
+__all__ = []

infoman/cli/templates/app/models_schemas_init.py.template

@@ -0,0 +1,11 @@
+"""
+Pydantic Schemas
+
+Import all schemas here for easy access.
+"""
+
+# Example:
+# from app.models.schemas.user import UserCreate, UserUpdate, UserResponse
+# from app.models.schemas.product import ProductCreate, ProductUpdate, ProductResponse
+
+__all__ = []

infoman/cli/templates/app/repository_init.py.template

@@ -0,0 +1,11 @@
+"""
+Data Access Layer
+
+Import all repository classes here for easy access.
+"""
+
+# Example:
+# from app.repository.user_repository import UserRepository
+# from app.repository.product_repository import ProductRepository
+
+__all__ = []

infoman/cli/templates/app/routers_init.py.template

@@ -0,0 +1,15 @@
+"""
+API Routers
+
+Central router registration.
+"""
+
+from fastapi import APIRouter
+
+# Create main API router
+api_router = APIRouter()
+
+# Import and register sub-routers here
+# Example:
+# from app.routers import user_router
+# api_router.include_router(user_router.router, prefix="/users", tags=["Users"])

infoman/cli/templates/app/services_init.py.template

@@ -0,0 +1,11 @@
+"""
+Business Logic Services
+
+Import all service classes here for easy access.
+"""
+
+# Example:
+# from app.services.user_service import UserService
+# from app.services.auth_service import AuthService
+
+__all__ = []

infoman/cli/templates/app/static_index.html.template

@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{project_name}</title>
+    <link rel="stylesheet" href="/static/css/style.css">
+</head>
+<body>
+    <div class="container">
+        <header>
+            <h1>Welcome to {project_name}</h1>
+            <p>FastAPI application built with infomankit</p>
+        </header>
+
+        <main>
+            <section class="links">
+                <h2>Quick Links</h2>
+                <ul>
+                    <li><a href="/docs">API Documentation (Swagger UI)</a></li>
+                    <li><a href="/redoc">API Documentation (ReDoc)</a></li>
+                    <li><a href="/health">Health Check</a></li>
+                </ul>
+            </section>
+
+            <section class="info">
+                <h2>Getting Started</h2>
+                <p>Your API is up and running! Visit the documentation links above to explore available endpoints.</p>
+            </section>
+        </main>
+
+        <footer>
+            <p>Built with <a href="https://github.com/ai-infoman/infoman-pykit" target="_blank">infomankit</a></p>
+        </footer>
+    </div>
+
+    <script src="/static/js/main.js"></script>
+</body>
+</html>

infoman/cli/templates/app/static_main.js.template

@@ -0,0 +1,31 @@
+// Main JavaScript for {project_name}
+
+document.addEventListener('DOMContentLoaded', function() {{
+    console.log('{project_name} loaded successfully');
+
+    // Add smooth scrolling
+    document.querySelectorAll('a[href^="#"]').forEach(anchor => {{
+        anchor.addEventListener('click', function (e) {{
+            e.preventDefault();
+            const target = document.querySelector(this.getAttribute('href'));
+            if (target) {{
+                target.scrollIntoView({{
+                    behavior: 'smooth'
+                }});
+            }}
+        }});
+    }});
+
+    // Check API health
+    checkHealth();
+}});
+
+async function checkHealth() {{
+    try {{
+        const response = await fetch('/health');
+        const data = await response.json();
+        console.log('Health check:', data);
+    }} catch (error) {{
+        console.error('Health check failed:', error);
+    }}
+}}

infoman/cli/templates/app/static_style.css.template

@@ -0,0 +1,111 @@
+/* Basic styles for {project_name} */
+
+* {{
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}}
+
+body {{
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+    line-height: 1.6;
+    color: #333;
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    min-height: 100vh;
+    padding: 20px;
+}}
+
+.container {{
+    max-width: 800px;
+    margin: 0 auto;
+    background: white;
+    border-radius: 10px;
+    box-shadow: 0 10px 40px rgba(0, 0, 0, 0.2);
+    overflow: hidden;
+}}
+
+header {{
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    color: white;
+    padding: 40px;
+    text-align: center;
+}}
+
+header h1 {{
+    font-size: 2.5rem;
+    margin-bottom: 10px;
+}}
+
+header p {{
+    font-size: 1.2rem;
+    opacity: 0.9;
+}}
+
+main {{
+    padding: 40px;
+}}
+
+section {{
+    margin-bottom: 30px;
+}}
+
+h2 {{
+    color: #667eea;
+    margin-bottom: 15px;
+    font-size: 1.8rem;
+}}
+
+.links ul {{
+    list-style: none;
+}}
+
+.links li {{
+    margin: 10px 0;
+}}
+
+.links a {{
+    display: inline-block;
+    padding: 12px 24px;
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    color: white;
+    text-decoration: none;
+    border-radius: 5px;
+    transition: transform 0.2s, box-shadow 0.2s;
+}}
+
+.links a:hover {{
+    transform: translateY(-2px);
+    box-shadow: 0 5px 15px rgba(102, 126, 234, 0.4);
+}}
+
+.info p {{
+    font-size: 1.1rem;
+    color: #666;
+}}
+
+footer {{
+    background: #f8f9fa;
+    padding: 20px;
+    text-align: center;
+    color: #666;
+    border-top: 1px solid #eee;
+}}
+
+footer a {{
+    color: #667eea;
+    text-decoration: none;
+}}
+
+footer a:hover {{
+    text-decoration: underline;
+}}
+
+@media (max-width: 768px) {{
+    header h1 {{
+        font-size: 2rem;
+    }}
+
+    main {{
+        padding: 20px;
+    }}
+}}

infoman/cli/templates/app/utils_init.py.template

@@ -0,0 +1,11 @@
+"""
+Utility Functions
+
+Common utility functions and helpers.
+"""
+
+# Example:
+# from app.utils.time_utils import format_datetime, parse_datetime
+# from app.utils.string_utils import slugify, sanitize
+
+__all__ = []

infoman/cli/templates/config/.env.dev.template

@@ -0,0 +1,43 @@
+# Application Settings
+APP_NAME={project_name}
+APP_ENV=dev
+APP_PORT=8000
+APP_DEBUG=true
+
+LOG_DIR=logs
+LOG_LEVEL=DEBUG
+LOG_FORMAT=simple
+
+USE_TEMPLATES=1
+USE_PRO_ORM=1
+TEMPLATE_DIR=./app/template
+#USE_STATIC=1
+
+# Database Configuration (infomankit format)
+MYSQL_ENABLED=true
+MYSQL_HOST=127.0.0.1
+MYSQL_PORT=3306
+MYSQL_DB=XXX
+MYSQL_USER=XXX
+MYSQL_PASSWORD=XXX
+MYSQL_CHARSET=utf8mb4
+MYSQL_POOL_MAX_SIZE=10
+MYSQL_POOL_RECYCLE=3600
+MYSQL_ECHO=false
+MYSQL_MODELS_PATH=app.models
+MYSQL_MODELS=entity
+
+
+# JWT Configuration
+JWT_SECRET_KEY=your-secret-key-change-this-in-production
+JWT_ALGORITHM=HS256
+JWT_ACCESS_TOKEN_EXPIRE_MINUTES=30
+
+# CORS Configuration (comma-separated origins)
+CORS_ORIGINS=http://localhost:3000,http://localhost:8000
+
+# Redis Configuration (Optional)
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_DB=0
+REDIS_PASSWORD=

infoman/cli/templates/config/.env.prod.template

@@ -0,0 +1,43 @@
+# Application Settings
+APP_NAME={project_name}
+APP_ENV=prod
+APP_PORT=8000
+APP_DEBUG=false
+
+LOG_DIR=logs
+LOG_LEVEL=INFO
+LOG_FORMAT=json
+
+USE_TEMPLATES=1
+USE_PRO_ORM=1
+TEMPLATE_DIR=./app/template
+#USE_STATIC=1
+
+# Database Configuration (infomankit format)
+MYSQL_ENABLED=true
+MYSQL_HOST=127.0.0.1
+MYSQL_PORT=3306
+MYSQL_DB=XXX
+MYSQL_USER=XXX
+MYSQL_PASSWORD=XXX
+MYSQL_CHARSET=utf8mb4
+MYSQL_POOL_MAX_SIZE=20
+MYSQL_POOL_RECYCLE=3600
+MYSQL_ECHO=false
+MYSQL_MODELS_PATH=app.models
+MYSQL_MODELS=entity
+
+
+# JWT Configuration
+JWT_SECRET_KEY=your-secret-key-change-this-in-production
+JWT_ALGORITHM=HS256
+JWT_ACCESS_TOKEN_EXPIRE_MINUTES=30
+
+# CORS Configuration (comma-separated origins)
+CORS_ORIGINS=https://your-domain.com
+
+# Redis Configuration (Optional)
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_DB=0
+REDIS_PASSWORD=

infoman/cli/templates/config/README.md.template

@@ -0,0 +1,28 @@
+# Configuration Files
+
+This directory contains environment-specific configuration files for the application.
+
+## Files
+
+- `.env.dev` - Development environment configuration
+- `.env.prod` - Production environment configuration
+
+## Usage
+
+1. Copy the appropriate config to project root:
+   ```bash
+   cp config/.env.dev .env  # For development
+   cp config/.env.prod .env # For production
+   ```
+
+2. Update the values in `.env` according to your environment:
+   - Database credentials (MYSQL_USER, MYSQL_PASSWORD, MYSQL_DB)
+   - JWT secret key
+   - Redis password (if applicable)
+   - CORS origins
+
+3. Never commit `.env` files to version control
+
+## Environment Variables
+
+See individual `.env.*` files for detailed documentation of each variable.

infoman/cli/templates/docker/.dockerignore.template

@@ -0,0 +1,60 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+
+# Virtual Environment
+venv/
+env/
+.venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+logs/
+*.log
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Documentation
+doc/
+*.md
+!README.md
+
+# Git
+.git/
+.gitignore
+
+# Docker
+docker/
+Dockerfile
+docker-compose*.yml
+.dockerignore
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Database
+*.db
+*.sqlite
+*.sqlite3

infoman/cli/templates/docker/Dockerfile.template

@@ -0,0 +1,47 @@
+# Multi-stage build for optimal image size
+FROM python:3.11-slim as builder
+
+WORKDIR /app
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements
+COPY pyproject.toml ./
+
+# Install Python dependencies
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir -e .
+
+# Runtime stage
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install runtime dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy Python packages from builder
+COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
+
+# Copy application code
+COPY . .
+
+# Create logs directory
+RUN mkdir -p logs
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# Run application
+CMD ["infoman-serve", "run", "app.app:app", "--host", "0.0.0.0", "--port", "8000"]