Model-config web apps: describe the app in configuration instead of writing code. Built on Polars and DuckDB.
presentation_layer.py · 19.5 KB · 512 lines
| 1 | #!/usr/bin/env python3 |
| 2 | """ |
| 3 | DBBasic Presentation Layer - Abstract UI representation |
| 4 | Converts data structures to different UI frameworks (Bootstrap, Tailwind, Material, etc.) |
| 5 | """ |
| 6 | |
| 7 | from typing import Dict, List, Any, Union |
| 8 | from abc import ABC, abstractmethod |
| 9 | import json |
| 10 | |
| 11 | # ============================================ |
| 12 | # Abstract Presentation Layer |
| 13 | # ============================================ |
| 14 | |
| 15 | class UIRenderer(ABC): |
| 16 | """Abstract base class for UI renderers""" |
| 17 | |
| 18 | @abstractmethod |
| 19 | def render_page(self, data: Dict) -> str: |
| 20 | pass |
| 21 | |
| 22 | @abstractmethod |
| 23 | def render_navbar(self, data: Dict) -> str: |
| 24 | pass |
| 25 | |
| 26 | @abstractmethod |
| 27 | def render_card(self, data: Dict) -> str: |
| 28 | pass |
| 29 | |
| 30 | @abstractmethod |
| 31 | def render_button(self, data: Dict) -> str: |
| 32 | pass |
| 33 | |
| 34 | @abstractmethod |
| 35 | def render_grid(self, data: Dict) -> str: |
| 36 | pass |
| 37 | |
| 38 | @abstractmethod |
| 39 | def render_alert(self, data: Dict) -> str: |
| 40 | pass |
| 41 | |
| 42 | def render(self, data: Union[Dict, List, str]) -> str: |
| 43 | """Main render method that routes to specific renderers""" |
| 44 | if isinstance(data, str): |
| 45 | return data |
| 46 | |
| 47 | if isinstance(data, list): |
| 48 | return ''.join(self.render(item) for item in data) |
| 49 | |
| 50 | if isinstance(data, dict): |
| 51 | component_type = data.get('type', '') |
| 52 | |
| 53 | # Handle script components specially - collect them but don't render inline |
| 54 | if component_type == 'script': |
| 55 | if hasattr(self, 'scripts'): |
| 56 | content = data.get('content', '') |
| 57 | self.scripts.append(f'<script>{content}</script>') |
| 58 | return '' # Don't render inline |
| 59 | |
| 60 | # Route to specific renderer based on type |
| 61 | if component_type == 'page': |
| 62 | return self.render_page(data) |
| 63 | elif component_type == 'navbar': |
| 64 | return self.render_navbar(data) |
| 65 | elif component_type == 'card': |
| 66 | return self.render_card(data) |
| 67 | elif component_type == 'button': |
| 68 | return self.render_button(data) |
| 69 | elif component_type == 'grid': |
| 70 | return self.render_grid(data) |
| 71 | elif component_type == 'alert': |
| 72 | return self.render_alert(data) |
| 73 | elif component_type == 'hero': |
| 74 | return self.render_hero(data) |
| 75 | elif component_type == 'form': |
| 76 | return self.render_form(data) |
| 77 | elif component_type == 'raw': |
| 78 | # Raw HTML content - pass through directly |
| 79 | return data.get('content', '') |
| 80 | elif component_type == 'footer': |
| 81 | # Footer is just raw HTML |
| 82 | return data.get('content', '') |
| 83 | elif 'components' in data: |
| 84 | return self.render(data['components']) |
| 85 | elif 'items' in data: |
| 86 | return self.render(data['items']) |
| 87 | |
| 88 | return str(data) |
| 89 | |
| 90 | def render_hero(self, data: Dict) -> str: |
| 91 | """Default hero implementation""" |
| 92 | return f"<div><h1>{data.get('title', '')}</h1><p>{data.get('subtitle', '')}</p></div>" |
| 93 | |
| 94 | def render_form(self, data: Dict) -> str: |
| 95 | """Default form implementation""" |
| 96 | return "<form></form>" |
| 97 | |
| 98 | |
| 99 | # ============================================ |
| 100 | # Bootstrap 5.3 Renderer |
| 101 | # ============================================ |
| 102 | |
| 103 | class BootstrapRenderer(UIRenderer): |
| 104 | """Render to Bootstrap 5.3""" |
| 105 | |
| 106 | def __init__(self): |
| 107 | self.scripts = [] # Collect scripts during rendering |
| 108 | |
| 109 | def render_page(self, data: Dict) -> str: |
| 110 | title = data.get('title', 'DBBasic') |
| 111 | self.scripts = [] # Reset scripts for this page |
| 112 | components = self.render(data.get('components', [])) |
| 113 | |
| 114 | # Collect all scripts |
| 115 | scripts_html = '\n'.join(self.scripts) |
| 116 | |
| 117 | return f"""<!DOCTYPE html> |
| 118 | <html lang="en"> |
| 119 | <head> |
| 120 | <meta charset="UTF-8"> |
| 121 | <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 122 | <title>{title}</title> |
| 123 | <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet"> |
| 124 | <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.css"> |
| 125 | {self._get_custom_styles()} |
| 126 | </head> |
| 127 | <body> |
| 128 | {components} |
| 129 | <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script> |
| 130 | {scripts_html} |
| 131 | {self._get_scripts()} |
| 132 | </body> |
| 133 | </html>""" |
| 134 | |
| 135 | def render_navbar(self, data: Dict) -> str: |
| 136 | brand = data.get('brand', 'DBBasic') |
| 137 | links = data.get('links', []) |
| 138 | variant = data.get('variant', 'dark') |
| 139 | search = data.get('search', True) |
| 140 | user_menu = data.get('user_menu', True) |
| 141 | |
| 142 | nav_links = [] |
| 143 | for link in data.get('links', []): |
| 144 | if isinstance(link, str): |
| 145 | nav_links.append(f'<a class="nav-link" href="/{link.lower()}">{link}</a>') |
| 146 | else: |
| 147 | active_class = 'active' if link.get('active') else '' |
| 148 | icon = f'<i class="{link.get("icon", "")} me-1"></i> ' if link.get('icon') else '' |
| 149 | nav_links.append( |
| 150 | f'<li class="nav-item"><a class="nav-link {active_class}" href="{link["url"]}">{icon}{link["text"]}</a></li>' |
| 151 | ) |
| 152 | |
| 153 | # Professional dark navbar with gradient |
| 154 | navbar_style = """ |
| 155 | background: linear-gradient(135deg, #1e3c72 0%, #2a5298 100%); |
| 156 | border-bottom: 2px solid #3b82f6; |
| 157 | """ if variant == 'dark' else "" |
| 158 | |
| 159 | search_html = ''' |
| 160 | <form class="d-flex ms-auto me-3" role="search"> |
| 161 | <div class="input-group"> |
| 162 | <input class="form-control form-control-sm" type="search" |
| 163 | placeholder="Search services..." style="min-width: 200px;"> |
| 164 | <button class="btn btn-outline-light btn-sm" type="submit"> |
| 165 | <i class="bi bi-search"></i> |
| 166 | </button> |
| 167 | </div> |
| 168 | </form> |
| 169 | ''' if search else '' |
| 170 | |
| 171 | user_menu_html = ''' |
| 172 | <div class="dropdown"> |
| 173 | <button class="btn btn-link text-white dropdown-toggle text-decoration-none" |
| 174 | type="button" data-bs-toggle="dropdown"> |
| 175 | <i class="bi bi-person-circle fs-5"></i> |
| 176 | <span class="ms-1 d-none d-md-inline">Admin</span> |
| 177 | </button> |
| 178 | <ul class="dropdown-menu dropdown-menu-end shadow"> |
| 179 | <li><h6 class="dropdown-header">Account</h6></li> |
| 180 | <li><a class="dropdown-item" href="#"><i class="bi bi-person me-2"></i>Profile</a></li> |
| 181 | <li><a class="dropdown-item" href="#"><i class="bi bi-gear me-2"></i>Settings</a></li> |
| 182 | <li><hr class="dropdown-divider"></li> |
| 183 | <li><a class="dropdown-item" href="#"><i class="bi bi-file-text me-2"></i>Documentation</a></li> |
| 184 | <li><a class="dropdown-item" href="#"><i class="bi bi-github me-2"></i>GitHub</a></li> |
| 185 | <li><hr class="dropdown-divider"></li> |
| 186 | <li><a class="dropdown-item text-danger" href="#"><i class="bi bi-box-arrow-right me-2"></i>Sign out</a></li> |
| 187 | </ul> |
| 188 | </div> |
| 189 | ''' if user_menu else '' |
| 190 | |
| 191 | return f""" |
| 192 | <nav class="navbar navbar-expand-lg navbar-dark shadow-lg" style="{navbar_style}"> |
| 193 | <div class="container-fluid px-3"> |
| 194 | <a class="navbar-brand fw-bold d-flex align-items-center" href="/"> |
| 195 | <div class="bg-white text-primary rounded-circle p-2 me-2"> |
| 196 | <i class="bi bi-cpu-fill"></i> |
| 197 | </div> |
| 198 | <span class="fs-4">{brand}</span> |
| 199 | <span class="badge bg-success ms-2">v1.0</span> |
| 200 | </a> |
| 201 | |
| 202 | <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarMain"> |
| 203 | <span class="navbar-toggler-icon"></span> |
| 204 | </button> |
| 205 | |
| 206 | <div class="collapse navbar-collapse" id="navbarMain"> |
| 207 | <ul class="navbar-nav me-auto mb-2 mb-lg-0 ms-4"> |
| 208 | {' '.join(nav_links)} |
| 209 | </ul> |
| 210 | |
| 211 | {search_html} |
| 212 | |
| 213 | <div class="d-flex align-items-center"> |
| 214 | <span class="badge bg-warning text-dark me-3"> |
| 215 | <i class="bi bi-lightning-fill"></i> 402M rows/sec |
| 216 | </span> |
| 217 | <button class="btn btn-link text-white position-relative me-3"> |
| 218 | <i class="bi bi-bell fs-5"></i> |
| 219 | <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill bg-danger"> |
| 220 | 3 |
| 221 | </span> |
| 222 | </button> |
| 223 | {user_menu_html} |
| 224 | </div> |
| 225 | </div> |
| 226 | </div> |
| 227 | </nav>""" |
| 228 | |
| 229 | def render_card(self, data: Dict) -> str: |
| 230 | title = data.get('title', '') |
| 231 | category = data.get('category', '') |
| 232 | description = data.get('description', '') |
| 233 | body = data.get('body', '') |
| 234 | footer = data.get('footer') |
| 235 | actions = [] |
| 236 | |
| 237 | for action in data.get('actions', []): |
| 238 | if isinstance(action, str): |
| 239 | variant = 'success' if action == 'deploy' else 'secondary' |
| 240 | actions.append(f'<button class="btn btn-{variant} btn-sm" onclick="{action}Template(\'{title}\')">{action.title()}</button>') |
| 241 | |
| 242 | # If body is provided, use it; otherwise use description |
| 243 | if isinstance(body, dict): |
| 244 | # Body is a nested component - render it |
| 245 | content = self.render(body) |
| 246 | elif body: |
| 247 | content = f'<p class="card-text">{body}</p>' |
| 248 | elif description: |
| 249 | content = f'<p class="card-text">{description}</p>' |
| 250 | else: |
| 251 | content = '' |
| 252 | |
| 253 | return f""" |
| 254 | <div class="card h-100"> |
| 255 | <div class="card-body"> |
| 256 | <div class="d-flex justify-content-between align-items-start mb-2"> |
| 257 | <h5 class="card-title">{title}</h5> |
| 258 | {f'<span class="badge bg-primary">{category}</span>' if category else ''} |
| 259 | </div> |
| 260 | {content} |
| 261 | </div> |
| 262 | {self._render_card_footer(footer, actions)} |
| 263 | </div>""" |
| 264 | |
| 265 | def _render_card_footer(self, footer, actions): |
| 266 | """Render card footer with either footer object or actions list""" |
| 267 | if footer and isinstance(footer, dict): |
| 268 | onclick = footer.get('onclick', '') |
| 269 | variant = footer.get('variant', 'primary') |
| 270 | text = footer.get('text', 'Button') |
| 271 | return f'''<div class="card-footer bg-transparent"> |
| 272 | <div class="d-grid"> |
| 273 | <button class="btn btn-{variant}" onclick="{onclick}">{text}</button> |
| 274 | </div> |
| 275 | </div>''' |
| 276 | elif actions: |
| 277 | return f'<div class="card-footer bg-transparent"><div class="d-grid gap-2 d-flex justify-content-end">{" ".join(actions)}</div></div>' |
| 278 | return '' |
| 279 | |
| 280 | def render_button(self, data: Dict) -> str: |
| 281 | return f'<button class="btn btn-{data.get("variant", "primary")}">{data.get("text", "Button")}</button>' |
| 282 | |
| 283 | def render_grid(self, data: Dict) -> str: |
| 284 | columns = data.get('columns', 3) |
| 285 | items = [f'<div class="col">{self.render(item)}</div>' for item in data.get('items', [])] |
| 286 | |
| 287 | return f""" |
| 288 | <div class="container my-5"> |
| 289 | <div class="row row-cols-1 row-cols-md-{columns} g-4"> |
| 290 | {' '.join(items)} |
| 291 | </div> |
| 292 | </div>""" |
| 293 | |
| 294 | def render_alert(self, data: Dict) -> str: |
| 295 | return f'<div class="alert alert-{data.get("variant", "info")}">{data.get("message", "")}</div>' |
| 296 | |
| 297 | def render_hero(self, data: Dict) -> str: |
| 298 | return f""" |
| 299 | <div class="bg-primary text-white text-center py-5"> |
| 300 | <div class="container"> |
| 301 | <h1 class="display-4">{data.get('title', '')}</h1> |
| 302 | <p class="lead">{data.get('subtitle', '')}</p> |
| 303 | </div> |
| 304 | </div>""" |
| 305 | |
| 306 | def _get_custom_styles(self) -> str: |
| 307 | return """ |
| 308 | <style> |
| 309 | .card { transition: transform 0.3s; } |
| 310 | .card:hover { transform: translateY(-5px); } |
| 311 | </style>""" |
| 312 | |
| 313 | def _get_scripts(self) -> str: |
| 314 | return "" # Scripts are now handled by individual components |
| 315 | |
| 316 | |
| 317 | # ============================================ |
| 318 | # Tailwind CSS Renderer |
| 319 | # ============================================ |
| 320 | |
| 321 | class TailwindRenderer(UIRenderer): |
| 322 | """Render to Tailwind CSS""" |
| 323 | |
| 324 | def render_page(self, data: Dict) -> str: |
| 325 | title = data.get('title', 'DBBasic') |
| 326 | components = self.render(data.get('components', [])) |
| 327 | |
| 328 | return f"""<!DOCTYPE html> |
| 329 | <html lang="en"> |
| 330 | <head> |
| 331 | <meta charset="UTF-8"> |
| 332 | <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 333 | <title>{title}</title> |
| 334 | <script src="https://cdn.tailwindcss.com"></script> |
| 335 | </head> |
| 336 | <body class="bg-gray-50"> |
| 337 | {components} |
| 338 | </body> |
| 339 | </html>""" |
| 340 | |
| 341 | def render_navbar(self, data: Dict) -> str: |
| 342 | brand = data.get('brand', 'DBBasic') |
| 343 | links = [] |
| 344 | for link in data.get('links', []): |
| 345 | if isinstance(link, str): |
| 346 | links.append(f'<a class="px-3 py-2 text-gray-700 hover:text-gray-900" href="/{link.lower()}">{link}</a>') |
| 347 | |
| 348 | return f""" |
| 349 | <nav class="bg-white shadow-lg"> |
| 350 | <div class="container mx-auto px-4"> |
| 351 | <div class="flex justify-between items-center py-4"> |
| 352 | <span class="text-xl font-bold">{brand}</span> |
| 353 | <div class="flex space-x-4"> |
| 354 | {' '.join(links)} |
| 355 | </div> |
| 356 | </div> |
| 357 | </div> |
| 358 | </nav>""" |
| 359 | |
| 360 | def render_card(self, data: Dict) -> str: |
| 361 | title = data.get('title', '') |
| 362 | category = data.get('category', '') |
| 363 | description = data.get('description', '') |
| 364 | actions = [] |
| 365 | |
| 366 | for action in data.get('actions', []): |
| 367 | if isinstance(action, str): |
| 368 | color = 'green' if action == 'deploy' else 'gray' |
| 369 | actions.append(f'<button class="bg-{color}-500 hover:bg-{color}-600 text-white px-4 py-2 rounded" onclick="{action}Template(\'{title}\')">{action.title()}</button>') |
| 370 | |
| 371 | return f""" |
| 372 | <div class="bg-white rounded-lg shadow-md hover:shadow-lg transition-shadow p-6"> |
| 373 | <div class="flex justify-between items-start mb-2"> |
| 374 | <h3 class="text-xl font-semibold">{title}</h3> |
| 375 | {f'<span class="bg-blue-500 text-white px-2 py-1 rounded text-sm">{category}</span>' if category else ''} |
| 376 | </div> |
| 377 | <p class="text-gray-600 mb-4">{description}</p> |
| 378 | {f'<div class="flex justify-end space-x-2">{" ".join(actions)}</div>' if actions else ''} |
| 379 | </div>""" |
| 380 | |
| 381 | def render_button(self, data: Dict) -> str: |
| 382 | colors = {'primary': 'blue', 'success': 'green', 'danger': 'red'} |
| 383 | color = colors.get(data.get('variant', 'primary'), 'blue') |
| 384 | return f'<button class="bg-{color}-500 hover:bg-{color}-600 text-white px-4 py-2 rounded">{data.get("text", "Button")}</button>' |
| 385 | |
| 386 | def render_grid(self, data: Dict) -> str: |
| 387 | columns = data.get('columns', 3) |
| 388 | items = [self.render(item) for item in data.get('items', [])] |
| 389 | |
| 390 | return f""" |
| 391 | <div class="container mx-auto px-4 my-8"> |
| 392 | <div class="grid grid-cols-1 md:grid-cols-{columns} gap-6"> |
| 393 | {' '.join(items)} |
| 394 | </div> |
| 395 | </div>""" |
| 396 | |
| 397 | def render_alert(self, data: Dict) -> str: |
| 398 | colors = {'info': 'blue', 'success': 'green', 'warning': 'yellow', 'danger': 'red'} |
| 399 | color = colors.get(data.get('variant', 'info'), 'blue') |
| 400 | return f'<div class="bg-{color}-100 border border-{color}-400 text-{color}-700 px-4 py-3 rounded">{data.get("message", "")}</div>' |
| 401 | |
| 402 | def render_hero(self, data: Dict) -> str: |
| 403 | return f""" |
| 404 | <div class="bg-gradient-to-r from-blue-500 to-purple-600 text-white text-center py-16"> |
| 405 | <div class="container mx-auto px-4"> |
| 406 | <h1 class="text-5xl font-bold mb-4">{data.get('title', '')}</h1> |
| 407 | <p class="text-xl">{data.get('subtitle', '')}</p> |
| 408 | </div> |
| 409 | </div>""" |
| 410 | |
| 411 | |
| 412 | # ============================================ |
| 413 | # Presentation Manager |
| 414 | # ============================================ |
| 415 | |
| 416 | class PresentationLayer: |
| 417 | """Manages different UI renderers""" |
| 418 | |
| 419 | RENDERERS = { |
| 420 | 'bootstrap': BootstrapRenderer(), |
| 421 | 'tailwind': TailwindRenderer(), |
| 422 | } |
| 423 | |
| 424 | @classmethod |
| 425 | def initialize_extended(cls): |
| 426 | """Initialize with extended renderers""" |
| 427 | try: |
| 428 | from bootstrap_components import ExtendedBootstrapRenderer |
| 429 | cls.RENDERERS['bootstrap'] = ExtendedBootstrapRenderer() |
| 430 | cls.RENDERERS['bootstrap_extended'] = ExtendedBootstrapRenderer() |
| 431 | except ImportError: |
| 432 | pass # Use basic renderer if extended not available |
| 433 | |
| 434 | @staticmethod |
| 435 | def render(data: Union[Dict, List, str], framework: str = 'bootstrap') -> str: |
| 436 | """Render data using specified framework""" |
| 437 | renderer = PresentationLayer.RENDERERS.get(framework) |
| 438 | if not renderer: |
| 439 | raise ValueError(f"Unknown framework: {framework}. Available: {list(PresentationLayer.RENDERERS.keys())}") |
| 440 | |
| 441 | return renderer.render(data) |
| 442 | |
| 443 | @staticmethod |
| 444 | def add_renderer(name: str, renderer: UIRenderer): |
| 445 | """Add a custom renderer""" |
| 446 | PresentationLayer.RENDERERS[name] = renderer |
| 447 | |
| 448 | |
| 449 | # ============================================ |
| 450 | # Test the presentation layer |
| 451 | # ============================================ |
| 452 | |
| 453 | if __name__ == "__main__": |
| 454 | # Define UI structure as data (framework-agnostic) |
| 455 | ui_structure = { |
| 456 | 'type': 'page', |
| 457 | 'title': 'DBBasic Template Marketplace', |
| 458 | 'components': [ |
| 459 | { |
| 460 | 'type': 'navbar', |
| 461 | 'brand': 'DBBasic', |
| 462 | 'links': ['Monitor', 'Data', 'Templates'] |
| 463 | }, |
| 464 | { |
| 465 | 'type': 'hero', |
| 466 | 'title': 'Template Marketplace', |
| 467 | 'subtitle': 'Deploy apps instantly' |
| 468 | }, |
| 469 | { |
| 470 | 'type': 'grid', |
| 471 | 'columns': 3, |
| 472 | 'items': [ |
| 473 | { |
| 474 | 'type': 'card', |
| 475 | 'title': 'Blog', |
| 476 | 'category': 'CMS', |
| 477 | 'description': 'Full-featured blog platform', |
| 478 | 'actions': ['deploy', 'preview'] |
| 479 | }, |
| 480 | { |
| 481 | 'type': 'card', |
| 482 | 'title': 'Shop', |
| 483 | 'category': 'E-Commerce', |
| 484 | 'description': 'Online store with payments', |
| 485 | 'actions': ['deploy', 'preview'] |
| 486 | }, |
| 487 | { |
| 488 | 'type': 'card', |
| 489 | 'title': 'CRM', |
| 490 | 'category': 'Business', |
| 491 | 'description': 'Customer relationship manager', |
| 492 | 'actions': ['deploy', 'preview'] |
| 493 | } |
| 494 | ] |
| 495 | } |
| 496 | ] |
| 497 | } |
| 498 | |
| 499 | # Render to Bootstrap |
| 500 | bootstrap_html = PresentationLayer.render(ui_structure, 'bootstrap') |
| 501 | with open('test_bootstrap.html', 'w') as f: |
| 502 | f.write(bootstrap_html) |
| 503 | print("✅ Generated test_bootstrap.html") |
| 504 | |
| 505 | # Render to Tailwind |
| 506 | tailwind_html = PresentationLayer.render(ui_structure, 'tailwind') |
| 507 | with open('test_tailwind.html', 'w') as f: |
| 508 | f.write(tailwind_html) |
| 509 | print("✅ Generated test_tailwind.html") |
| 510 | |
| 511 | print("\nSame data structure rendered to different frameworks!") |
| 512 | print("Open test_bootstrap.html and test_tailwind.html to see the difference") |