askrobots / PyStructUI
Public
Transform data structures into HTML for any Python web framework. Works with Flask, Django, FastAPI. No templates needed - just data. Switch between Bootstrap, Tailwind, Material UI with one line.
core.py · 1.5 KB · 50 lines
| 1 | """ |
| 2 | Core presentation layer engine |
| 3 | """ |
| 4 | |
| 5 | from abc import ABC, abstractmethod |
| 6 | from typing import Dict, Any, Optional, List |
| 7 | import json |
| 8 | |
| 9 | |
| 10 | class Renderer(ABC): |
| 11 | """Base renderer class that all UI renderers must inherit from""" |
| 12 | |
| 13 | @abstractmethod |
| 14 | def render(self, data: Dict[str, Any]) -> str: |
| 15 | """Render data structure to HTML string""" |
| 16 | pass |
| 17 | |
| 18 | @abstractmethod |
| 19 | def render_component(self, component: Dict[str, Any]) -> str: |
| 20 | """Render a single component""" |
| 21 | pass |
| 22 | |
| 23 | |
| 24 | class PresentationLayer: |
| 25 | """Main presentation layer that manages renderers and rendering""" |
| 26 | |
| 27 | def __init__(self): |
| 28 | self.renderers = {} |
| 29 | self.default_renderer = None |
| 30 | |
| 31 | def add_renderer(self, name: str, renderer: Renderer): |
| 32 | """Register a renderer""" |
| 33 | self.renderers[name] = renderer |
| 34 | if not self.default_renderer: |
| 35 | self.default_renderer = name |
| 36 | |
| 37 | def render(self, data: Dict[str, Any], renderer: Optional[str] = None) -> str: |
| 38 | """Render data using specified or default renderer""" |
| 39 | renderer_name = renderer or self.default_renderer |
| 40 | if not renderer_name or renderer_name not in self.renderers: |
| 41 | raise ValueError(f"Renderer '{renderer_name}' not found") |
| 42 | return self.renderers[renderer_name].render(data) |
| 43 | |
| 44 | def render_json(self, data: Dict[str, Any]) -> str: |
| 45 | """Render data as JSON (useful for APIs)""" |
| 46 | return json.dumps(data, indent=2) |
| 47 | |
| 48 | def get_renderers(self) -> List[str]: |
| 49 | """Get list of available renderers""" |
| 50 | return list(self.renderers.keys()) |