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.

0 downloads

PyStructUI/pystructui/renderers.py
Download zip
Clone
Clone with git
git clone https://gitstable.com/git/askrobots/PyStructUI.git
HTTPS
https://gitstable.com/git/askrobots/PyStructUI.git
SSH
ssh://git@gitstable.com:2222/askrobots/PyStructUI.git

Cloning needs no sign-in. Pushing over HTTPS asks for your username and an access token. SSH needs your key under SSH keys.

danq9 feat: Package restructure and PyPI release 0.1.0 616b847 1 year, 2 months ago History
renderers.py · 12.3 KB · 351 lines
1"""
2Built-in renderers for different UI frameworks
3"""
4
5from typing import Dict, Any
6from .core import Renderer
7
8
9class 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
271class 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
341class 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>'