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.
renderers.py · 12.3 KB · 351 lines
| 1 | """ |
| 2 | Built-in renderers for different UI frameworks |
| 3 | """ |
| 4 | |
| 5 | from typing import Dict, Any |
| 6 | from .core import Renderer |
| 7 | |
| 8 | |
| 9 | class BootstrapRenderer(Renderer): |
| 10 | """Bootstrap 5 renderer""" |
| 11 | |
| 12 | def render(self, data: Dict[str, Any]) -> str: |
| 13 | """Render complete page with Bootstrap""" |
| 14 | if data.get('type') == 'page': |
| 15 | return self._render_page(data) |
| 16 | return self.render_component(data) |
| 17 | |
| 18 | def render_component(self, data: Dict[str, Any]) -> str: |
| 19 | """Render individual component""" |
| 20 | component_type = data.get('type', 'div') |
| 21 | |
| 22 | # Map component types to render methods |
| 23 | renderers = { |
| 24 | 'navbar': self._render_navbar, |
| 25 | 'card': self._render_card, |
| 26 | 'button': self._render_button, |
| 27 | 'form': self._render_form, |
| 28 | 'table': self._render_table, |
| 29 | 'alert': self._render_alert, |
| 30 | 'modal': self._render_modal, |
| 31 | 'grid': self._render_grid, |
| 32 | 'hero': self._render_hero, |
| 33 | 'breadcrumb': self._render_breadcrumb, |
| 34 | 'raw': lambda d: d.get('content', ''), |
| 35 | } |
| 36 | |
| 37 | renderer = renderers.get(component_type, self._render_div) |
| 38 | return renderer(data) |
| 39 | |
| 40 | def _render_page(self, data: Dict[str, Any]) -> str: |
| 41 | """Render full HTML page""" |
| 42 | title = data.get('title', 'PyStructUI App') |
| 43 | components = data.get('components', []) |
| 44 | |
| 45 | components_html = ''.join([ |
| 46 | self.render_component(c) for c in components |
| 47 | ]) |
| 48 | |
| 49 | return f"""<!DOCTYPE html> |
| 50 | <html lang="en"> |
| 51 | <head> |
| 52 | <meta charset="UTF-8"> |
| 53 | <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 54 | <title>{title}</title> |
| 55 | <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet"> |
| 56 | <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.7.2/font/bootstrap-icons.css"> |
| 57 | </head> |
| 58 | <body> |
| 59 | {components_html} |
| 60 | <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/js/bootstrap.bundle.min.js"></script> |
| 61 | </body> |
| 62 | </html>""" |
| 63 | |
| 64 | def _render_navbar(self, data: Dict[str, Any]) -> str: |
| 65 | """Render Bootstrap navbar""" |
| 66 | brand = data.get('brand', 'App') |
| 67 | links = data.get('links', []) |
| 68 | |
| 69 | nav_links = ''.join([ |
| 70 | f'<li class="nav-item"><a class="nav-link" href="{link.get("url", "#")}">{link.get("text", "Link")}</a></li>' |
| 71 | for link in links |
| 72 | ]) |
| 73 | |
| 74 | return f""" |
| 75 | <nav class="navbar navbar-expand-lg navbar-dark bg-primary"> |
| 76 | <div class="container-fluid"> |
| 77 | <a class="navbar-brand" href="/">{brand}</a> |
| 78 | <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav"> |
| 79 | <span class="navbar-toggler-icon"></span> |
| 80 | </button> |
| 81 | <div class="collapse navbar-collapse" id="navbarNav"> |
| 82 | <ul class="navbar-nav"> |
| 83 | {nav_links} |
| 84 | </ul> |
| 85 | </div> |
| 86 | </div> |
| 87 | </nav>""" |
| 88 | |
| 89 | def _render_card(self, data: Dict[str, Any]) -> str: |
| 90 | """Render Bootstrap card""" |
| 91 | title = data.get('title', '') |
| 92 | body = data.get('body', '') |
| 93 | footer = data.get('footer') |
| 94 | |
| 95 | body_html = body if isinstance(body, str) else self.render_component(body) |
| 96 | |
| 97 | footer_html = '' |
| 98 | if footer: |
| 99 | if isinstance(footer, dict): |
| 100 | footer_html = f'<div class="card-footer">{self.render_component(footer)}</div>' |
| 101 | else: |
| 102 | footer_html = f'<div class="card-footer">{footer}</div>' |
| 103 | |
| 104 | return f""" |
| 105 | <div class="card"> |
| 106 | {f'<div class="card-header"><h5>{title}</h5></div>' if title else ''} |
| 107 | <div class="card-body">{body_html}</div> |
| 108 | {footer_html} |
| 109 | </div>""" |
| 110 | |
| 111 | def _render_button(self, data: Dict[str, Any]) -> str: |
| 112 | """Render Bootstrap button""" |
| 113 | text = data.get('text', 'Button') |
| 114 | variant = data.get('variant', 'primary') |
| 115 | size = data.get('size', '') |
| 116 | onclick = data.get('onclick', '') |
| 117 | |
| 118 | size_class = f'btn-{size}' if size else '' |
| 119 | onclick_attr = f'onclick="{onclick}"' if onclick else '' |
| 120 | |
| 121 | return f'<button class="btn btn-{variant} {size_class}" {onclick_attr}>{text}</button>' |
| 122 | |
| 123 | def _render_form(self, data: Dict[str, Any]) -> str: |
| 124 | """Render Bootstrap form""" |
| 125 | fields = data.get('fields', []) |
| 126 | method = data.get('method', 'POST') |
| 127 | action = data.get('action', '#') |
| 128 | |
| 129 | fields_html = ''.join([self._render_form_field(f) for f in fields]) |
| 130 | |
| 131 | return f""" |
| 132 | <form method="{method}" action="{action}"> |
| 133 | {fields_html} |
| 134 | <button type="submit" class="btn btn-primary">Submit</button> |
| 135 | </form>""" |
| 136 | |
| 137 | def _render_form_field(self, field: Dict[str, Any]) -> str: |
| 138 | """Render form field""" |
| 139 | field_type = field.get('type', 'text') |
| 140 | name = field.get('name', '') |
| 141 | label = field.get('label', '') |
| 142 | placeholder = field.get('placeholder', '') |
| 143 | required = 'required' if field.get('required') else '' |
| 144 | |
| 145 | if field_type == 'textarea': |
| 146 | return f""" |
| 147 | <div class="mb-3"> |
| 148 | <label for="{name}" class="form-label">{label}</label> |
| 149 | <textarea class="form-control" id="{name}" name="{name}" placeholder="{placeholder}" {required}></textarea> |
| 150 | </div>""" |
| 151 | |
| 152 | return f""" |
| 153 | <div class="mb-3"> |
| 154 | <label for="{name}" class="form-label">{label}</label> |
| 155 | <input type="{field_type}" class="form-control" id="{name}" name="{name}" placeholder="{placeholder}" {required}> |
| 156 | </div>""" |
| 157 | |
| 158 | def _render_table(self, data: Dict[str, Any]) -> str: |
| 159 | """Render Bootstrap table""" |
| 160 | headers = data.get('headers', []) |
| 161 | rows = data.get('rows', []) |
| 162 | |
| 163 | header_html = ''.join([f'<th>{h}</th>' for h in headers]) |
| 164 | rows_html = ''.join([ |
| 165 | '<tr>' + ''.join([f'<td>{cell}</td>' for cell in row]) + '</tr>' |
| 166 | for row in rows |
| 167 | ]) |
| 168 | |
| 169 | return f""" |
| 170 | <table class="table table-striped table-hover"> |
| 171 | <thead><tr>{header_html}</tr></thead> |
| 172 | <tbody>{rows_html}</tbody> |
| 173 | </table>""" |
| 174 | |
| 175 | def _render_alert(self, data: Dict[str, Any]) -> str: |
| 176 | """Render Bootstrap alert""" |
| 177 | message = data.get('message', '') |
| 178 | variant = data.get('variant', 'info') |
| 179 | dismissible = data.get('dismissible', False) |
| 180 | |
| 181 | dismiss_html = '' |
| 182 | if dismissible: |
| 183 | dismiss_html = '<button type="button" class="btn-close" data-bs-dismiss="alert"></button>' |
| 184 | |
| 185 | return f""" |
| 186 | <div class="alert alert-{variant} {'alert-dismissible fade show' if dismissible else ''}" role="alert"> |
| 187 | {message} |
| 188 | {dismiss_html} |
| 189 | </div>""" |
| 190 | |
| 191 | def _render_modal(self, data: Dict[str, Any]) -> str: |
| 192 | """Render Bootstrap modal""" |
| 193 | modal_id = data.get('id', 'modal') |
| 194 | title = data.get('title', 'Modal') |
| 195 | body = data.get('body', '') |
| 196 | |
| 197 | body_html = body if isinstance(body, str) else self.render_component(body) |
| 198 | |
| 199 | return f""" |
| 200 | <div class="modal fade" id="{modal_id}" tabindex="-1"> |
| 201 | <div class="modal-dialog"> |
| 202 | <div class="modal-content"> |
| 203 | <div class="modal-header"> |
| 204 | <h5 class="modal-title">{title}</h5> |
| 205 | <button type="button" class="btn-close" data-bs-dismiss="modal"></button> |
| 206 | </div> |
| 207 | <div class="modal-body">{body_html}</div> |
| 208 | <div class="modal-footer"> |
| 209 | <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button> |
| 210 | <button type="button" class="btn btn-primary">Save changes</button> |
| 211 | </div> |
| 212 | </div> |
| 213 | </div> |
| 214 | </div>""" |
| 215 | |
| 216 | def _render_grid(self, data: Dict[str, Any]) -> str: |
| 217 | """Render Bootstrap grid""" |
| 218 | columns = data.get('columns', 3) |
| 219 | items = data.get('items', []) |
| 220 | |
| 221 | items_html = ''.join([ |
| 222 | f'<div class="col">{self.render_component(item)}</div>' |
| 223 | for item in items |
| 224 | ]) |
| 225 | |
| 226 | return f""" |
| 227 | <div class="container"> |
| 228 | <div class="row row-cols-1 row-cols-md-{columns} g-4"> |
| 229 | {items_html} |
| 230 | </div> |
| 231 | </div>""" |
| 232 | |
| 233 | def _render_hero(self, data: Dict[str, Any]) -> str: |
| 234 | """Render hero section""" |
| 235 | title = data.get('title', '') |
| 236 | subtitle = data.get('subtitle', '') |
| 237 | variant = data.get('variant', 'primary') |
| 238 | |
| 239 | return f""" |
| 240 | <div class="bg-{variant} text-white text-center py-5"> |
| 241 | <div class="container"> |
| 242 | <h1 class="display-4">{title}</h1> |
| 243 | <p class="lead">{subtitle}</p> |
| 244 | </div> |
| 245 | </div>""" |
| 246 | |
| 247 | def _render_breadcrumb(self, data: Dict[str, Any]) -> str: |
| 248 | """Render breadcrumb navigation""" |
| 249 | items = data.get('items', []) |
| 250 | |
| 251 | breadcrumb_items = ''.join([ |
| 252 | f'<li class="breadcrumb-item {"active" if item.get("active") else ""}"><a href="{item.get("url", "#")}">{item.get("text", "")}</a></li>' |
| 253 | if not item.get('active') else |
| 254 | f'<li class="breadcrumb-item active">{item.get("text", "")}</li>' |
| 255 | for item in items |
| 256 | ]) |
| 257 | |
| 258 | return f""" |
| 259 | <nav aria-label="breadcrumb"> |
| 260 | <ol class="breadcrumb"> |
| 261 | {breadcrumb_items} |
| 262 | </ol> |
| 263 | </nav>""" |
| 264 | |
| 265 | def _render_div(self, data: Dict[str, Any]) -> str: |
| 266 | """Fallback div renderer""" |
| 267 | content = data.get('content', '') |
| 268 | return f'<div>{content}</div>' |
| 269 | |
| 270 | |
| 271 | class TailwindRenderer(Renderer): |
| 272 | """Tailwind CSS renderer""" |
| 273 | |
| 274 | def render(self, data: Dict[str, Any]) -> str: |
| 275 | """Render with Tailwind CSS""" |
| 276 | # Similar structure to Bootstrap but with Tailwind classes |
| 277 | if data.get('type') == 'page': |
| 278 | return self._render_page(data) |
| 279 | return self.render_component(data) |
| 280 | |
| 281 | def render_component(self, data: Dict[str, Any]) -> str: |
| 282 | """Render component with Tailwind styles""" |
| 283 | component_type = data.get('type', 'div') |
| 284 | |
| 285 | if component_type == 'card': |
| 286 | return self._render_card(data) |
| 287 | elif component_type == 'button': |
| 288 | return self._render_button(data) |
| 289 | |
| 290 | return f'<div>{data.get("content", "")}</div>' |
| 291 | |
| 292 | def _render_page(self, data: Dict[str, Any]) -> str: |
| 293 | """Render full page with Tailwind""" |
| 294 | title = data.get('title', 'PyStructUI App') |
| 295 | components = data.get('components', []) |
| 296 | |
| 297 | components_html = ''.join([ |
| 298 | self.render_component(c) for c in components |
| 299 | ]) |
| 300 | |
| 301 | return f"""<!DOCTYPE html> |
| 302 | <html lang="en"> |
| 303 | <head> |
| 304 | <meta charset="UTF-8"> |
| 305 | <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| 306 | <title>{title}</title> |
| 307 | <script src="https://cdn.tailwindcss.com"></script> |
| 308 | </head> |
| 309 | <body class="bg-gray-100"> |
| 310 | {components_html} |
| 311 | </body> |
| 312 | </html>""" |
| 313 | |
| 314 | def _render_card(self, data: Dict[str, Any]) -> str: |
| 315 | """Render Tailwind card""" |
| 316 | title = data.get('title', '') |
| 317 | body = data.get('body', '') |
| 318 | |
| 319 | return f""" |
| 320 | <div class="bg-white rounded-lg shadow-md p-6"> |
| 321 | {f'<h3 class="text-xl font-semibold mb-4">{title}</h3>' if title else ''} |
| 322 | <div>{body}</div> |
| 323 | </div>""" |
| 324 | |
| 325 | def _render_button(self, data: Dict[str, Any]) -> str: |
| 326 | """Render Tailwind button""" |
| 327 | text = data.get('text', 'Button') |
| 328 | variant = data.get('variant', 'primary') |
| 329 | |
| 330 | colors = { |
| 331 | 'primary': 'bg-blue-500 hover:bg-blue-700', |
| 332 | 'success': 'bg-green-500 hover:bg-green-700', |
| 333 | 'danger': 'bg-red-500 hover:bg-red-700', |
| 334 | } |
| 335 | |
| 336 | color_classes = colors.get(variant, colors['primary']) |
| 337 | |
| 338 | return f'<button class="{color_classes} text-white font-bold py-2 px-4 rounded">{text}</button>' |
| 339 | |
| 340 | |
| 341 | class MaterialUIRenderer(Renderer): |
| 342 | """Material-UI inspired renderer""" |
| 343 | |
| 344 | def render(self, data: Dict[str, Any]) -> str: |
| 345 | """Render with Material Design principles""" |
| 346 | # Simplified Material Design implementation |
| 347 | return f'<div class="mdc-component">{data.get("content", "")}</div>' |
| 348 | |
| 349 | def render_component(self, data: Dict[str, Any]) -> str: |
| 350 | """Render Material Design component""" |
| 351 | return f'<div class="mdc-{data.get("type", "container")}">{data.get("content", "")}</div>' |