Files
micronomicon/backend/converter.py
2026-04-05 09:53:01 +02:00

127 lines
3.9 KiB
Python

"""µFrame compile, DSL metadata, and image upload endpoints."""
import os
import subprocess
import sys
import tempfile
from pathlib import Path
from fastapi import APIRouter, HTTPException, UploadFile, File
from pydantic import BaseModel
import uframe
import uframe.keywords # noqa: F401 — triggers keyword registration
from uframe.errors import UFrameError
from uframe.registry import get_dsl_meta
router = APIRouter()
UPLOAD_DIR = Path(os.environ.get("SOURCES_DIR", "/data/sources")) / "images"
BACKEND_DIR = str(Path(__file__).resolve().parent)
def execute_dynamic_script(script: str, timeout: int = 10) -> str:
"""Execute a dynamic page script and return its stdout (micron output).
Used by both the compile preview and the browse page reader.
"""
env = {**os.environ, "PYTHONPATH": BACKEND_DIR}
with tempfile.NamedTemporaryFile(mode="w", suffix=".py", delete=False) as f:
f.write(script)
f.flush()
try:
result = subprocess.run(
[sys.executable, f.name],
capture_output=True, text=True, timeout=timeout,
cwd=BACKEND_DIR, env=env,
)
if result.returncode != 0 and result.stderr:
return result.stderr
return result.stdout
except subprocess.TimeoutExpired:
return "Error: script timed out"
finally:
os.unlink(f.name)
class CompileRequest(BaseModel):
source: str
width: int = 64
class CompileResponse(BaseModel):
ascii: str
micron: str
script: str
is_dynamic: bool
warnings: list[str]
@router.post("/compile", response_model=CompileResponse)
async def compile_source(req: CompileRequest):
"""Compile µFrame .uf source into ASCII and Micron output.
For dynamic pages, the generated script is executed and the
resolved micron output replaces the static micron in the response.
"""
try:
result = uframe.compile(req.source, width=req.width)
micron = result.micron
if result.is_dynamic and result.script:
executed = execute_dynamic_script(result.script)
# Strip cache header line if present
lines = executed.split("\n")
if lines and lines[0].startswith("#!c="):
lines = lines[1:]
micron = "\n".join(lines)
return CompileResponse(
ascii=result.ascii,
micron=micron,
script=result.script,
is_dynamic=result.is_dynamic,
warnings=[w.message for w in result.warnings],
)
except UFrameError as e:
raise HTTPException(status_code=422, detail=str(e))
@router.get("/dsl-meta")
async def dsl_meta():
"""Return DSL metadata for frontend syntax highlighting and autocomplete."""
return get_dsl_meta()
@router.post("/upload-image")
async def upload_image(file: UploadFile = File(...)):
"""Upload an image for use in .uf pages."""
UPLOAD_DIR.mkdir(parents=True, exist_ok=True)
# Sanitize filename
name = file.filename or "upload.png"
safe_name = "".join(c for c in name if c.isalnum() or c in "._-").rstrip(".")
if not safe_name:
safe_name = "upload.png"
dest = UPLOAD_DIR / safe_name
content = await file.read()
dest.write_bytes(content)
# Return the path relative to backend working directory
rel_path = str(dest)
return {"path": rel_path, "filename": safe_name, "size": len(content)}
@router.get("/images")
async def list_images():
"""List uploaded images available for embedding."""
if not UPLOAD_DIR.is_dir():
return []
images = []
for f in sorted(UPLOAD_DIR.iterdir()):
if f.suffix.lower() in (".png", ".jpg", ".jpeg", ".bmp", ".webp", ".gif"):
images.append({
"filename": f.name,
"path": str(f),
"size": f.stat().st_size,
})
return images