fastapi-lite-admin 0.1.0__py3-none-any.whl

fastapi_admin_lite/ui/templates/model_list.html

@@ -0,0 +1,440 @@
+{% extends "layout.html" %}
+
+{% set active_nav = model_name %}
+
+{% block extra_css %}
+    .header-actions {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        margin-bottom: 24px;
+    }
+
+    .table-card {
+        padding: 0;
+        overflow: hidden;
+        margin-bottom: 32px;
+    }
+
+    .data-table {
+        width: 100%;
+        border-collapse: collapse;
+    }
+
+    .data-table th {
+        text-align: left;
+        padding: 6px 12px;
+        font-size: 0.75rem;
+        font-weight: 700;
+        text-transform: uppercase;
+        color: var(--text-muted);
+        border-bottom: 1px solid var(--border);
+        background-color: #f1f5f9;
+    }
+
+    .data-table td {
+        padding: 4px 12px;
+        font-size: 0.8rem;
+        border-bottom: 1px solid var(--border);
+        color: #334155;
+    }
+
+    .status-badge {
+        display: inline-flex;
+        align-items: center;
+        gap: 4px;
+        font-size: 0.7rem;
+        font-weight: 600;
+    }
+
+    .status-dot {
+        width: 4px;
+        height: 4px;
+        border-radius: 50%;
+    }
+
+    .status-active .status-dot { background-color: var(--success); }
+    .status-active { color: #065f46; }
+
+    .status-inactive .status-dot { background-color: var(--text-muted); }
+    .status-inactive { color: var(--text-muted); }
+
+    .action-btns {
+        display: flex;
+        gap: 6px;
+    }
+
+    .action-btn {
+        background: none;
+        border: none;
+        color: var(--primary);
+        cursor: pointer;
+        font-size: 0.75rem;
+        font-weight: 600;
+        transition: color 0.2s;
+    }
+
+    .action-btn:hover {
+        color: var(--text-main);
+    }
+
+    .action-btn.delete:hover {
+        color: var(--error);
+    }
+
+    /* Footer Stats */
+    .table-footer-stats {
+        display: grid;
+        grid-template-columns: repeat(3, 1fr);
+        gap: 24px;
+    }
+
+    .footer-stat-card {
+        display: flex;
+        align-items: center;
+        gap: 16px;
+        padding: 20px;
+    }
+
+    .footer-stat-icon {
+        width: 40px;
+        height: 40px;
+        border-radius: 8px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-size: 1.2rem;
+    }
+
+    .footer-stat-info .label {
+        font-size: 0.7rem;
+        text-transform: uppercase;
+        font-weight: 700;
+        color: var(--text-muted);
+        margin-bottom: 2px;
+    }
+
+    .footer-stat-info .value {
+        font-size: 1.25rem;
+        font-weight: 700;
+    }
+
+    /* Pagination */
+    .pagination {
+        padding: 16px 24px;
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        border-top: 1px solid var(--border);
+        background-color: #fafafa;
+    }
+
+    .pagination-info {
+        font-size: 0.85rem;
+        color: var(--text-muted);
+    }
+
+    .pagination-btns {
+        display: flex;
+        align-items: center;
+        gap: 16px;
+    }
+
+    .page-size-selector {
+        font-size: 0.85rem;
+        color: var(--text-muted);
+        display: flex;
+        align-items: center;
+        gap: 8px;
+    }
+
+    .page-size-selector select {
+        padding: 4px 8px;
+        border: 1px solid var(--border);
+        border-radius: 4px;
+        outline: none;
+        background: white;
+    }
+
+    .activity-badge {
+        display: inline-flex;
+        align-items: center;
+        gap: 6px;
+        padding: 2px 8px;
+        background-color: #f1f5f9;
+        color: var(--text-muted);
+        border-radius: 12px;
+        font-size: 0.75rem;
+        font-weight: 600;
+        border: 1px solid var(--border);
+    }
+
+    .activity-badge.active {
+        background-color: #ecfeff;
+        color: var(--primary);
+        border-color: #cffafe;
+    }
+
+    .activity-badge i {
+        font-size: 0.7rem;
+    }
+{% endblock %}
+
+{% block content %}
+
+<div class="header-actions">
+    <div>
+        <h1 class="page-title">{{ model_name|capitalize }}</h1>
+        <div style="display: flex; align-items: center; gap: 10px; margin-top: 4px;">
+            <p class="page-subtitle" style="margin: 0;">Manage and monitor your {{ model_name }} records.</p>
+            <div class="activity-badge {% if has_date_field %}active{% endif %}" title="Activity in last 24 hours">
+                <i class="fas {% if has_date_field %}fa-bolt{% else %}fa-circle-info{% endif %}"></i>
+                {% if has_date_field %}
+                    {{ recent_count }} new today
+                {% else %}
+                    date_field not set
+                {% endif %}
+            </div>
+        </div>
+    </div>
+    <button class="btn btn-primary" onclick="location.href='/admin/{{ model_name }}/new'">
+        <i class="fas fa-plus"></i> Create {{ model_name|capitalize }}
+    </button>
+</div>
+
+<div class="card table-card">
+    <table class="data-table">
+        <thead id="table-head">
+            <!-- Columns injected via JS -->
+        </thead>
+        <tbody id="table-body">
+            <!-- Loading indicator -->
+            <tr>
+                <td colspan="100%" style="text-align: center; padding: 48px; color: var(--text-muted);">
+                    <i class="fas fa-circle-notch fa-spin"></i> Loading {{ model_name }} data...
+                </td>
+            </tr>
+        </tbody>
+    </table>
+    
+    <div class="pagination">
+        <div class="pagination-info" id="pagination-info">
+            Showing 0-0 of 0 {{ model_name }}
+        </div>
+        <div class="pagination-btns">
+            <div class="page-size-selector">
+                <span>Per page:</span>
+                <select id="page-size-select">
+                    <option value="10">10</option>
+                    <option value="20">20</option>
+                    <option value="30">30</option>
+                    <option value="50">50</option>
+                </select>
+            </div>
+            <div style="display: flex; gap: 8px;">
+                <button class="btn btn-secondary btn-sm" id="prev-btn">Previous</button>
+                <button class="btn btn-secondary btn-sm" id="next-btn">Next</button>
+            </div>
+        </div>
+    </div>
+</div>
+
+<div class="table-footer-stats">
+    <div class="card footer-stat-card">
+        <div class="footer-stat-icon" style="background-color: #e0f2fe; color: #0369a1;">
+            <i class="fas fa-user-group"></i>
+        </div>
+        <div class="footer-stat-info">
+            <div class="label">Total {{ model_name|capitalize }}</div>
+            <div class="value" id="total-count">0</div>
+        </div>
+    </div>
+    <div class="card footer-stat-card">
+        <div class="footer-stat-icon" style="background-color: #e0e7ff; color: #4338ca;">
+            <i class="fas fa-bolt"></i>
+        </div>
+        <div class="footer-stat-info">
+            <div class="label">New Today</div>
+            <div class="value">{% if has_date_field %}{{ recent_count }}{% else %}--{% endif %}</div>
+        </div>
+    </div>
+    <div class="card footer-stat-card">
+        <div class="footer-stat-icon" style="background-color: #fee2e2; color: #b91c1c;">
+            <i class="fas fa-triangle-exclamation"></i>
+        </div>
+        <div class="footer-stat-info">
+            <div class="label">Attention Needed</div>
+            <div class="value">{% if has_attention_filter %}{{ attention_count }}{% else %}--{% endif %}</div>
+        </div>
+    </div>
+</div>
+
+{% endblock %}
+
+{% block extra_js %}
+<script>
+    const modelName = "{{ model_name }}";
+    const apiBaseUrl = "/admin/api";
+    let currentPage = 1;
+    let pageSize = 10;
+    let currentSortField = 'id';
+    let currentSortDir = 'desc';
+
+    async function loadData() {
+        try {
+            // 1. Fetch Schema to get configuration
+            const schemaResponse = await fetch(`${apiBaseUrl}/schema`);
+            const schema = await schemaResponse.json();
+            const modelSchema = schema.models.find(m => m.name === modelName);
+            const listDisplay = modelSchema ? modelSchema.list_display : null;
+
+            // 2. Fetch Data
+            const skip = (currentPage - 1) * pageSize;
+            const url = `${apiBaseUrl}/${modelName}?skip=${skip}&limit=${pageSize}&order_by=${currentSortField}&order_dir=${currentSortDir}`;
+            const response = await fetch(url);
+            const result = await response.json();
+            const data = result.data;
+            const total = result.total;
+
+            document.getElementById('total-count').textContent = total;
+            
+            const start = data.length > 0 ? skip + 1 : 0;
+            const end = skip + data.length;
+            document.getElementById('pagination-info').textContent = `Showing ${start}-${end} of ${total} ${modelName}`;
+
+            // Update button states
+            document.getElementById('prev-btn').disabled = currentPage === 1;
+            document.getElementById('next-btn').disabled = end >= total;
+
+            if (data.length === 0 && currentPage === 1) {
+                document.getElementById('table-body').innerHTML = '<tr><td colspan="100%" style="text-align: center; padding: 48px;">No records found</td></tr>';
+                return;
+            }
+
+            // 3. Determine columns to show
+            let columns = [];
+            if (listDisplay && listDisplay.length > 0) {
+                columns = listDisplay;
+            } else {
+                columns = Object.keys(data[0]);
+                if (columns.includes('id')) {
+                    columns = ['id', ...columns.filter(c => c !== 'id')];
+                }
+            }
+
+            const headRow = document.getElementById('table-head');
+            headRow.innerHTML = '<tr>' + 
+                columns.map(col => {
+                    const isSorted = currentSortField === col;
+                    const icon = isSorted ? (currentSortDir === 'asc' ? 'fa-sort-up' : 'fa-sort-down') : 'fa-sort';
+                    return `
+                        <th onclick="toggleSort('${col}')" style="cursor: pointer; user-select: none;">
+                            <div style="display: flex; align-items: center; gap: 8px;">
+                                ${col.replace('_', ' ')}
+                                <i class="fas ${icon}" style="font-size: 0.7rem; color: ${isSorted ? 'var(--primary)' : '#ccc'}"></i>
+                            </div>
+                        </th>
+                    `;
+                }).join('') + 
+                '<th>Actions</th></tr>';
+
+            const body = document.getElementById('table-body');
+            body.innerHTML = data.map(row => `
+                <tr>
+                    ${columns.map(col => {
+                        const val = row[col];
+                        
+                        // Special rendering for specific fields
+                        if (col === 'id') return `<td style="font-family: monospace; color: var(--text-muted); font-size: 0.8rem;">#${val}</td>`;
+                        
+                        if (col === 'email' || col === 'name') {
+                            const name = row['name'] || (row['email'] ? row['email'].split('@')[0] : 'Item');
+                            return `
+                                <td>
+                                    <span style="font-weight: 600;">${val}</span>
+                                    ${col === 'name' && row['email'] ? `<span style="font-size: 0.7rem; color: var(--text-muted); margin-left: 4px;">(${row['email']})</span>` : ''}
+                                </td>
+                            `;
+                        }
+
+                        if (typeof val === 'boolean' || col === 'is_active') {
+                            const isActive = val === true || val === 'true';
+                            return `
+                                <td>
+                                    <span class="status-badge ${isActive ? 'status-active' : 'status-inactive'}">
+                                        <div class="status-dot"></div>
+                                        ${isActive ? 'Active' : 'Inactive'}
+                                    </span>
+                                </td>
+                            `;
+                        }
+
+                        return `<td>${val}</td>`;
+                    }).join('')}
+                    <td>
+                        <div class="action-btns">
+                            <button class="action-btn" onclick="location.href='/admin/${modelName}/${row.id}/detail'" title="View">
+                                <i class="far fa-eye"></i>
+                            </button>
+                            <button class="action-btn" onclick="location.href='/admin/${modelName}/${row.id}'" title="Edit">
+                                <i class="fas fa-pencil-alt"></i>
+                            </button>
+                            <button class="action-btn delete" onclick="deleteRecord('${row.id}')" title="Delete">
+                                <i class="far fa-trash-alt"></i>
+                            </button>
+                        </div>
+                    </td>
+                </tr>
+            `).join('');
+        } catch (error) {
+            console.error('Error loading data:', error);
+            document.getElementById('table-body').innerHTML = '<tr><td colspan="100%" style="text-align: center; padding: 48px; color: var(--error);">Error loading data</td></tr>';
+        }
+    }
+
+    function toggleSort(field) {
+        if (currentSortField === field) {
+            currentSortDir = currentSortDir === 'asc' ? 'desc' : 'asc';
+        } else {
+            currentSortField = field;
+            currentSortDir = 'asc';
+        }
+        currentPage = 1; // Reset to first page on sort
+        loadData();
+    }
+
+    async function deleteRecord(id) {
+        if (!confirm('Are you sure you want to delete this record?')) return;
+        try {
+            const response = await fetch(`${apiBaseUrl}/${modelName}/${id}`, { method: 'DELETE' });
+            if (response.ok) {
+                loadData();
+            } else {
+                alert('Failed to delete record');
+            }
+        } catch (error) {
+            alert('Error deleting record');
+        }
+    }
+
+    document.getElementById('prev-btn').addEventListener('click', () => {
+        if (currentPage > 1) {
+            currentPage--;
+            loadData();
+        }
+    });
+
+    document.getElementById('next-btn').addEventListener('click', () => {
+        currentPage++;
+        loadData();
+    });
+
+    document.getElementById('page-size-select').addEventListener('change', (e) => {
+        pageSize = parseInt(e.target.value);
+        currentPage = 1;
+        loadData();
+    });
+
+    loadData();
+</script>
+{% endblock %}

fastapi_admin_lite/ui/views.py

@@ -0,0 +1,154 @@
+from typing import Any
+from fastapi import APIRouter, Request
+from fastapi.responses import HTMLResponse
+from fastapi.templating import Jinja2Templates
+import os
+
+# Get path to templates directory relative to this file
+TEMPLATES_DIR = os.path.join(os.path.dirname(__file__), "templates")
+templates = Jinja2Templates(directory=TEMPLATES_DIR)
+
+def create_ui_router(admin: Any) -> APIRouter:
+    router = APIRouter()
+
+    @router.get("/", response_class=HTMLResponse)
+    async def dashboard(request: Request):
+        from datetime import datetime, timedelta
+        models = admin.registry.get_models()
+        model_names = list(models.keys())
+        
+        # Collect real counts for each model
+        stats = []
+        for name, reg in models.items():
+            # Skip if user has specified a subset of models for the dashboard
+            if admin.dashboard_models and name not in admin.dashboard_models:
+                continue
+                
+            db_gen = reg.get_db()
+            db = next(db_gen)
+            try:
+                # 1. Get Total Count
+                total_count = db.query(reg.model).count()
+                
+                # 2. Get 24h Count if date_field is set
+                recent_count = None
+                date_field = reg.config.get("date_field")
+                
+                if date_field and hasattr(reg.model, date_field):
+                    yesterday = datetime.now() - timedelta(hours=24)
+                    recent_count = db.query(reg.model).filter(
+                        getattr(reg.model, date_field) >= yesterday
+                    ).count()
+
+                stats.append({
+                    "name": reg.config.get("display_name") or name.capitalize(),
+                    "count": total_count,
+                    "recent_count": recent_count,
+                    "model_name": name,
+                    "has_date_field": bool(date_field)
+                })
+            finally:
+                # Handle generators properly
+                try:
+                    next(db_gen)
+                except StopIteration:
+                    pass
+                    
+        # Fetch Logs
+        logs = []
+        if admin.get_logs:
+            try:
+                logs = admin.get_logs()
+            except Exception as e:
+                print(f"Error fetching logs: {e}")
+
+        return templates.TemplateResponse(
+            request=request, 
+            name=admin.dashboard_template or "dashboard.html", 
+            context={
+                "models": model_names, 
+                "stats": stats,
+                "admin_title": admin.title,
+                "logs": logs,
+                "logs_config": admin.logs_config
+            }
+        )
+
+    @router.get("/{model_name}", response_class=HTMLResponse)
+    async def model_list(request: Request, model_name: str):
+        from datetime import datetime, timedelta
+        reg = admin.registry.get_model(model_name)
+        if not reg:
+            raise HTTPException(status_code=404, detail="Model not found")
+            
+        models = list(admin.registry.get_models().keys())
+        
+        # Calculate 24h stats for this specific model
+        recent_count = None
+        date_field = reg.config.get("date_field")
+        
+        if date_field and hasattr(reg.model, date_field):
+            db_gen = reg.get_db()
+            db = next(db_gen)
+            try:
+                yesterday = datetime.now() - timedelta(hours=24)
+                recent_count = db.query(reg.model).filter(
+                    getattr(reg.model, date_field) >= yesterday
+                ).count()
+            finally:
+                try: next(db_gen)
+                except StopIteration: pass
+        
+        # Calculate Attention count
+        attention_count = None
+        attn_filter = reg.config.get("attention_filter")
+        if attn_filter is not None:
+            db_gen = reg.get_db()
+            db = next(db_gen)
+            try:
+                attention_count = db.query(reg.model).filter(attn_filter).count()
+            finally:
+                try: next(db_gen)
+                except StopIteration: pass
+
+        return templates.TemplateResponse(
+            request=request, 
+            name="model_list.html", 
+            context={
+                "model_name": model_name, 
+                "models": models,
+                "recent_count": recent_count,
+                "attention_count": attention_count,
+                "has_date_field": bool(date_field),
+                "has_attention_filter": attn_filter is not None
+            }
+        )
+
+    @router.get("/{model_name}/new", response_class=HTMLResponse)
+    async def model_create(request: Request, model_name: str):
+        models = list(admin.registry.get_models().keys())
+        return templates.TemplateResponse(
+            request=request, 
+            name="model_form.html", 
+            context={"model_name": model_name, "id": None, "models": models}
+        )
+
+    @router.get("/{model_name}/{id}", response_class=HTMLResponse)
+    async def model_edit(request: Request, model_name: str, id: str):
+        models = list(admin.registry.get_models().keys())
+        return templates.TemplateResponse(
+            request=request, 
+            name="model_form.html", 
+            context={"model_name": model_name, "id": id, "models": models}
+        )
+    
+    @router.get("/{model_name}/{id}/detail", response_class=HTMLResponse)
+    async def model_detail(request: Request, model_name: str, id: str):
+        models = list(admin.registry.get_models().keys())
+        return templates.TemplateResponse(
+            request=request, 
+            name="model_detail.html", 
+            context={"model_name": model_name, "id": id, "models": models}
+        )
+
+    return router

fastapi_lite_admin-0.1.0.dist-info/METADATA

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: fastapi-lite-admin
+Version: 0.1.0
+Summary: A lightweight, pluggable admin panel for FastAPI
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.100.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: python-multipart>=0.0.6
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: httpx; extra == "dev"
+Requires-Dist: uvicorn; extra == "dev"
+
+# FastAPI Lite Admin
+
+A premium, lightweight, pluggable admin panel for FastAPI and SQLAlchemy.
+
+## Features
+
+- **Zero-config CRUD**: Automatically generate admin interfaces for your models.
+- **ORM Agnostic**: Initial support for SQLAlchemy, designed to support others.
+- **API First**: All admin actions are available via a REST API.
+- **Lightweight UI**: Simple Jinja2 templates for the dashboard and forms.
+
+## Quick Start
+
+(Documentation coming soon)
+
+## Development
+
+```bash
+# Install dependencies
+pip install -e ".[dev]"
+
+# Run example
+python -m example.main
+```

fastapi_lite_admin-0.1.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+fastapi_admin_lite/__init__.py,sha256=HUejMXcpfadaZXn62qtBvCV0rE7QAaX4GYBO_KbdSOw,45
+fastapi_admin_lite/main.py,sha256=sRh3x6t-ryKdzpSXBpqMabTDrWdQnyhmJznf5Zagfqk,3743
+fastapi_admin_lite/core/config.py,sha256=g-WGUlkL1OV4rmtvh3dr6S2xzotyWLF6MIbaSLN7ur0,493
+fastapi_admin_lite/core/crud.py,sha256=3QL33KyrNFqc3icUSWA-JPu496uzzlfWU9Rh6R8xP5M,3626
+fastapi_admin_lite/core/registry.py,sha256=8SqoTmCXkJAsvu4yADquachD9Prtc2zKm35p_NftDvw,1099
+fastapi_admin_lite/core/schema.py,sha256=O-Fmo2EFRK1YL5-xx-Ywe2YbSfyCXqd7Y5fGA0qbax0,904
+fastapi_admin_lite/dependencies/db.py,sha256=FcOZK2gY9QsvVz_ZQMKK5_Bei2yzhL1U8vizrcpefAo,271
+fastapi_admin_lite/integrations/sqlalchemy.py,sha256=KGX3q8ugxSLn2273MxdsknRvJTFHg1sJGNGcpDkw_ck,750
+fastapi_admin_lite/routers/admin.py,sha256=TqI24W8GXhOzzKLGisbSIFwve-YjAgrxcl7OOlVBimg,3270
+fastapi_admin_lite/ui/views.py,sha256=BHkBzOlH2Eg-CfYq_ZT2iL7W9NniB_d58WN4p1CJI0E,5793
+fastapi_admin_lite/ui/templates/dashboard.html,sha256=-c2z3_mP5X33FTDgOguzsFKqmiClqRBoRUnyADgMLKA,6275
+fastapi_admin_lite/ui/templates/layout.html,sha256=_BcFkBVySv8JmXPKTPT91zC2ycZUKUOjoW9Wg9SeH5I,9046
+fastapi_admin_lite/ui/templates/model_detail.html,sha256=q_Wb0XjwTJBclBnEVhLNpGYcvWmQVCDtBewUhZmQNBo,5409
+fastapi_admin_lite/ui/templates/model_form.html,sha256=p4rc_TZYvsMFgGK-Oa2_Iu2_JbfsL1g-6hveLaOV74Q,11196
+fastapi_admin_lite/ui/templates/model_list.html,sha256=DdCT3qrMGuHLIFJQph5Vyp-EIuycWkbjEAGgM7qECmg,14739
+fastapi_lite_admin-0.1.0.dist-info/METADATA,sha256=CJdw8l2srR0mcT92nGlud0fOVIy6m0qmNbJxpc1NzR0,1065
+fastapi_lite_admin-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+fastapi_lite_admin-0.1.0.dist-info/top_level.txt,sha256=3tguJI_ZKi_gI3OEFdNwBR4PfzdNBR1ZBtKm4Wp3rsc,19
+fastapi_lite_admin-0.1.0.dist-info/RECORD,,

fastapi_lite_admin-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fastapi_lite_admin-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fastapi_admin_lite