import inspect import re from typing import Callable, Union import docutils.core from nicegui import ui from nicegui.elements.markdown import apply_tailwind REGEX_H4 = re.compile(r'(.*?)') SPECIAL_CHARACTERS = re.compile('[^(a-z)(A-Z)(0-9)-]') class example: def __init__(self, content: Union[Callable, type, str], tight: bool = False, skip: bool = True) -> None: self.content = content self.markdown_classes = f'mr-8 w-full flex-none lg:w-{48 if tight else 80} xl:w-80' self.rendering_classes = f'w-{48 if tight else 64} flex-none lg:mt-12' self.source_classes = f'w-80 flex-grow overflow-auto lg:mt-12' self.skip = skip def __call__(self, f: Callable) -> Callable: if self.skip: return with ui.row().classes('flex w-full'): if isinstance(self.content, str): self._add_html_anchor(ui.markdown(self.content).classes(self.markdown_classes)) else: doc = self.content.__doc__ or self.content.__init__.__doc__ html: str = docutils.core.publish_parts(doc, writer_name='html')['html_body'] html = html.replace('

', '

', 1) html = html.replace('

', '

', 1) html = apply_tailwind(html) self._add_html_anchor(ui.html(html).classes(self.markdown_classes)) with ui.card() \ .classes(self.rendering_classes) \ .style('box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1)'): self._add_dots() f() code = inspect.getsource(f).splitlines() while not code[0].startswith(' ' * 8): del code[0] code = [l[8:] for l in code] while code[0].startswith('global '): del code[0] code.insert(0, '```python') code.insert(1, 'from nicegui import ui') if code[2].split()[0] not in ['from', 'import']: code.insert(2, '') for l, line in enumerate(code): if line.startswith('# ui.'): code[l] = line[2:] if line.startswith('# ui.run('): break else: code.append('') code.append('ui.run()') code.append('```') code = '\n'.join(code) with ui.card() \ .classes(self.source_classes) \ .style('box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1); background: #e3eafd'): self._add_dots() ui.markdown(code) return f @staticmethod def _add_html_anchor(element: ui.html) -> None: html = element.content match = REGEX_H4.search(html) if not match: return headline = match.groups()[0].strip() headline_id = SPECIAL_CHARACTERS.sub('_', headline).lower() if not headline_id: return icon = 'link' anchor = f'{icon}' html = html.replace('', f' {anchor}', 1) element.content = html @staticmethod def _add_dots() -> None: with ui.row().classes('gap-1').style('transform: translate(-6px, -6px)'): ui.icon('circle').style('font-size: 75%').classes('text-red-400') ui.icon('circle').style('font-size: 75%').classes('text-yellow-400') ui.icon('circle').style('font-size: 75%').classes('text-green-400')