fastapi-lite-admin 0.1.7__tar.gz → 0.1.8__tar.gz

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-lite-admin
-Version: 0.1.7
+Version: 0.1.8
 Summary: A lightweight, pluggable admin panel for FastAPI
 License: MIT
 Project-URL: Homepage, https://github.com/rishiqwerty/admin-panel-fast-api
@@ -145,6 +145,7 @@ The `Admin` class constructor supports the following parameters for customizatio
 | **`upload_dir`** | `str` | `"uploads"` | Local directory path where uploaded files will be stored. |
 | **`upload_url`** | `str` | `"/uploads"` | URL prefix used to serve uploaded files statically. |
 | **`upload_handler`** | `Callable` | `None` | Optional custom upload handler callback for buckets (S3, GCS, Azure). |
+| **`url_resolver`** | `Callable` | `None` | Optional custom URL resolver callback to resolve database keys to presigned URLs (S3, GCS). |
 
 ---
 
@@ -240,7 +241,24 @@ admin = Admin(
 )
 ```
 
-### 3. Enabling File Upload in Models
+### 3. Storage URL Resolution (Presigned URLs)
+If the database stores relative paths/keys (e.g. `generated/uuid.jpg` in GCS or S3) rather than full absolute URLs, browser requests will fail. You can provide a custom `url_resolver` callback:
+
+```python
+async def get_s3_presigned_url(path: str) -> str:
+    # 1. Generate temporary presigned GET URL for GCS/S3 key
+    # 2. Return URL
+    return s3_client.generate_presigned_url('get_object', Params={'Bucket': 'my-bucket', 'Key': path})
+
+admin = Admin(
+    title="Cloud Admin",
+    url_resolver=get_s3_presigned_url
+)
+```
+
+The admin panel routes all file rendering and download links through the `/admin/api/media?path=...` redirect proxy, which executes `url_resolver` to redirect the browser to the temporary accessible URL safely, keeping your database values clean.
+
+### 4. Enabling File Upload in Models
 Pass the `file_fields` parameter when registering your model:
 
 ```python

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/README.md

@@ -124,6 +124,7 @@ The `Admin` class constructor supports the following parameters for customizatio
 | **`upload_dir`** | `str` | `"uploads"` | Local directory path where uploaded files will be stored. |
 | **`upload_url`** | `str` | `"/uploads"` | URL prefix used to serve uploaded files statically. |
 | **`upload_handler`** | `Callable` | `None` | Optional custom upload handler callback for buckets (S3, GCS, Azure). |
+| **`url_resolver`** | `Callable` | `None` | Optional custom URL resolver callback to resolve database keys to presigned URLs (S3, GCS). |
 
 ---
 
@@ -219,7 +220,24 @@ admin = Admin(
 )
 ```
 
-### 3. Enabling File Upload in Models
+### 3. Storage URL Resolution (Presigned URLs)
+If the database stores relative paths/keys (e.g. `generated/uuid.jpg` in GCS or S3) rather than full absolute URLs, browser requests will fail. You can provide a custom `url_resolver` callback:
+
+```python
+async def get_s3_presigned_url(path: str) -> str:
+    # 1. Generate temporary presigned GET URL for GCS/S3 key
+    # 2. Return URL
+    return s3_client.generate_presigned_url('get_object', Params={'Bucket': 'my-bucket', 'Key': path})
+
+admin = Admin(
+    title="Cloud Admin",
+    url_resolver=get_s3_presigned_url
+)
+```
+
+The admin panel routes all file rendering and download links through the `/admin/api/media?path=...` redirect proxy, which executes `url_resolver` to redirect the browser to the temporary accessible URL safely, keeping your database values clean.
+
+### 4. Enabling File Upload in Models
 Pass the `file_fields` parameter when registering your model:
 
 ```python

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/fastapi_admin_lite/main.py

@@ -19,7 +19,8 @@ class Admin:
         logs_config: Optional[Dict[str, Any]] = None,
         upload_dir: str = "uploads",
         upload_url: str = "/uploads",
-        upload_handler: Optional[Callable[[Any], Any]] = None
+        upload_handler: Optional[Callable[[Any], Any]] = None,
+        url_resolver: Optional[Callable[[str], Any]] = None
     ):
         self.title = title
         self.base_url = base_url
@@ -40,6 +41,9 @@ class Admin:
         # Auth & Permissions
         self.auth_dependency = auth_dependency
         self.permission_checker = permission_checker or self.default_permission
+        
+        # Media resolver
+        self.url_resolver = url_resolver or self.default_url_resolver
 
         # Print warnings if not configured
         if not auth_dependency:
@@ -51,6 +55,21 @@ class Admin:
         """Default permission checker that allows everything."""
         return True
 
+    def default_url_resolver(self, path: str) -> str:
+        """Default URL resolver that resolves relative paths to the local static uploads URL."""
+        if not path:
+            return ""
+        if path.startswith("http://") or path.startswith("https://") or path.startswith("data:"):
+            return path
+        
+        clean_path = path.lstrip("/")
+        clean_prefix = self.upload_url.strip("/")
+        
+        if clean_path.startswith(clean_prefix):
+            return f"/{clean_path}"
+            
+        return f"{self.upload_url}/{clean_path}"
+
     def register(
         self,
         model: Type[Any],

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/fastapi_admin_lite/routers/admin.py

@@ -1,5 +1,6 @@
 from typing import Any, Dict, List
 from fastapi import APIRouter, Depends, HTTPException, Query, UploadFile, File
+from fastapi.responses import RedirectResponse
 import shutil
 import uuid
 import os
@@ -42,6 +43,19 @@ def create_admin_router(admin: Any) -> APIRouter:
                 
             return {"url": f"{admin.upload_url}/{filename}"}
 
+    @router.get("/media", name="admin_resolve_media")
+    async def resolve_media(path: str = Query(...)):
+        if not path:
+            raise HTTPException(status_code=400, detail="Path parameter is required")
+        try:
+            if asyncio.iscoroutinefunction(admin.url_resolver):
+                resolved_url = await admin.url_resolver(path)
+            else:
+                resolved_url = admin.url_resolver(path)
+            return RedirectResponse(url=resolved_url)
+        except Exception as e:
+            raise HTTPException(status_code=500, detail=f"Failed to resolve media URL: {str(e)}")
+
     @router.get("/models")
     async def list_models():
         return list(admin.registry.get_models().keys())

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/fastapi_admin_lite/ui/templates/model_detail.html

@@ -165,19 +165,20 @@
                     if (!val) {
                         displayVal = '<span style="color: var(--text-muted);">None</span>';
                     } else {
+                        const displayUrl = val.startsWith('http://') || val.startsWith('https://') ? val : `${apiBaseUrl}/media?path=${encodeURIComponent(val)}`;
                         const isImg = val.match(/\.(jpeg|jpg|gif|png|webp)$/i);
                         if (isImg) {
                             displayVal = `
                                 <div style="display: flex; flex-direction: column; gap: 8px; margin-top: 8px;">
-                                    <img src="${val}" alt="${key}" style="max-width: 300px; max-height: 300px; object-fit: contain; border-radius: 8px; border: 1px solid var(--border);">
-                                    <a href="${val}" target="_blank" class="file-preview-link" style="color: var(--primary); text-decoration: none; font-size: 0.85rem; font-weight: 500;">
+                                    <img src="${displayUrl}" alt="${key}" style="max-width: 300px; max-height: 300px; object-fit: contain; border-radius: 8px; border: 1px solid var(--border);">
+                                    <a href="${displayUrl}" target="_blank" class="file-preview-link" style="color: var(--primary); text-decoration: none; font-size: 0.85rem; font-weight: 500;">
                                         <i class="fas fa-external-link-alt"></i> View full size
                                     </a>
                                 </div>
                             `;
                         } else {
                             displayVal = `
-                                <a href="${val}" target="_blank" class="file-preview-link" style="display: inline-flex; align-items: center; gap: 8px; color: var(--primary); text-decoration: none; font-weight: 500; margin-top: 4px;">
+                                <a href="${displayUrl}" target="_blank" class="file-preview-link" style="display: inline-flex; align-items: center; gap: 8px; color: var(--primary); text-decoration: none; font-weight: 500; margin-top: 4px;">
                                     <i class="fas fa-file-alt" style="font-size: 1.25rem;"></i> View File (${val.split('/').pop()})
                                 </a>
                             `;

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/fastapi_admin_lite/ui/templates/model_form.html

@@ -451,12 +451,13 @@
 
                 const isFile = fileFields.includes(name);
                 if (isFile) {
+                    const displayUrl = val ? (val.startsWith('http://') || val.startsWith('https://') ? val : `${apiBaseUrl}/media?path=${encodeURIComponent(val)}`) : '';
                     const previewHtml = val ? `
                         <div class="file-preview-container" id="preview-${name}">
                             <div class="file-preview-icon"><i class="fas fa-file-alt"></i></div>
                             <div class="file-preview-info">
                                 <span class="file-preview-name">${val.split('/').pop()}</span>
-                                <a href="${val}" target="_blank" class="file-preview-link">View file</a>
+                                <a href="${displayUrl}" target="_blank" class="file-preview-link">View file</a>
                             </div>
                             <button type="button" class="btn-remove-file" onclick="clearFile('${name}')">
                                 <i class="fas fa-times"></i>
@@ -591,13 +592,15 @@
             // Set value in hidden input
             hiddenInput.value = fileUrl;
             
+            const displayUrl = fileUrl.startsWith('http://') || fileUrl.startsWith('https://') ? fileUrl : `${apiBaseUrl}/media?path=${encodeURIComponent(fileUrl)}`;
+            
             // Update preview
             previewWrapper.innerHTML = `
                 <div class="file-preview-container" id="preview-${fieldName}">
                     <div class="file-preview-icon"><i class="fas fa-file-alt"></i></div>
                     <div class="file-preview-info">
                         <span class="file-preview-name">${file.name}</span>
-                        <a href="${fileUrl}" target="_blank" class="file-preview-link">View file</a>
+                        <a href="${displayUrl}" target="_blank" class="file-preview-link">View file</a>
                     </div>
                     <button type="button" class="btn-remove-file" onclick="clearFile('${fieldName}')">
                         <i class="fas fa-times"></i>

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/fastapi_admin_lite/ui/templates/model_list.html

@@ -303,6 +303,7 @@
             const schema = await schemaResponse.json();
             const modelSchema = schema.models.find(m => m.name === modelName);
             const listDisplay = modelSchema ? modelSchema.list_display : null;
+            const fileFields = modelSchema?.config?.file_fields || [];
 
             // 2. Fetch Data
             const skip = (currentPage - 1) * pageSize;
@@ -385,6 +386,18 @@
                             `;
                         }
 
+                        if (fileFields.includes(col)) {
+                            if (!val) return '<td>--</td>';
+                            const displayUrl = val.startsWith('http://') || val.startsWith('https://') ? val : `${apiBaseUrl}/media?path=${encodeURIComponent(val)}`;
+                            return `
+                                <td>
+                                    <a href="${displayUrl}" target="_blank" class="file-preview-link" style="color: var(--primary); text-decoration: none; font-weight: 500; display: inline-flex; align-items: center; gap: 6px;">
+                                        <i class="fas fa-external-link-alt"></i> View File
+                                    </a>
+                                </td>
+                            `;
+                        }
+
                         return `<td>${val}</td>`;
                     }).join('')}
                     <td>

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/fastapi_lite_admin.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-lite-admin
-Version: 0.1.7
+Version: 0.1.8
 Summary: A lightweight, pluggable admin panel for FastAPI
 License: MIT
 Project-URL: Homepage, https://github.com/rishiqwerty/admin-panel-fast-api
@@ -145,6 +145,7 @@ The `Admin` class constructor supports the following parameters for customizatio
 | **`upload_dir`** | `str` | `"uploads"` | Local directory path where uploaded files will be stored. |
 | **`upload_url`** | `str` | `"/uploads"` | URL prefix used to serve uploaded files statically. |
 | **`upload_handler`** | `Callable` | `None` | Optional custom upload handler callback for buckets (S3, GCS, Azure). |
+| **`url_resolver`** | `Callable` | `None` | Optional custom URL resolver callback to resolve database keys to presigned URLs (S3, GCS). |
 
 ---
 
@@ -240,7 +241,24 @@ admin = Admin(
 )
 ```
 
-### 3. Enabling File Upload in Models
+### 3. Storage URL Resolution (Presigned URLs)
+If the database stores relative paths/keys (e.g. `generated/uuid.jpg` in GCS or S3) rather than full absolute URLs, browser requests will fail. You can provide a custom `url_resolver` callback:
+
+```python
+async def get_s3_presigned_url(path: str) -> str:
+    # 1. Generate temporary presigned GET URL for GCS/S3 key
+    # 2. Return URL
+    return s3_client.generate_presigned_url('get_object', Params={'Bucket': 'my-bucket', 'Key': path})
+
+admin = Admin(
+    title="Cloud Admin",
+    url_resolver=get_s3_presigned_url
+)
+```
+
+The admin panel routes all file rendering and download links through the `/admin/api/media?path=...` redirect proxy, which executes `url_resolver` to redirect the browser to the temporary accessible URL safely, keeping your database values clean.
+
+### 4. Enabling File Upload in Models
 Pass the `file_fields` parameter when registering your model:
 
 ```python

{fastapi_lite_admin-0.1.7 → fastapi_lite_admin-0.1.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fastapi-lite-admin"
-version = "0.1.7"
+version = "0.1.8"
 description = "A lightweight, pluggable admin panel for FastAPI"
 readme = "README.md"
 requires-python = ">=3.9"