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')