py_microhtml

Минималистичный генератор HTML для Python 3.6+ с компактным синтаксисом

Безопасно построить допустимый HTML с кодом Python. Пример:

 from microhtml import *
print (
  ᑉhtml (
    ᑉhead ( ᑉtitle ( 'Test page' )),
    ᑉbody ( ᑉspan ( 'Simple example.' , class_ = 'example' ))). pretty ())

Это распечатывает действительный, отформатированный документ XHTML:

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
< html xmlns = " http://www.w3.org/1999/xhtml " >
  < head >
    < title >
      Test page
    </ title >
  </ head >
  < body >
    < span class = " example " >Simple example.</ span >
  </ body >
</ html >

Да, вам, вероятно, нужно скопировать символ Unicode, и да, вы захотите использовать современный редактор, но полученный синтаксис очень компактный и не будет столкнуться с вашими идентификаторами даже с import * .

Минимализм также распространяется на реализацию - он очень короткий (<80 строк в v0.3). Проверьте microhtml/__init__.py .

Более длинный пример с большим количеством функций, продемонстрированных:

 from microhtml import *

# Rendering a non-indented string (result: <p>Third <em>and last</em> paragraph</p>)
raw_html = str ( ᑉp ( "Third " , ᑉem ( "and last" ), ' paragraph' ))

# Writing a nicely formatted / tidied XHTML document to a file descriptor
print (
  ᑉhtml ( lang = 'en_US' )(
    ᑉhead ( ᑉtitle ( "Test page" )),
    ᑉbody (
        ᑉp ( "Hi!" , width = 123 ), # 123 becomes "123"
        ᑉhr ( class_ = 'someclass' ), # Reserved words like "class" can be written with a trailing underscore
        ᑉp ( 'Literal strings are safely <em>escaped</em> by default.' ),
        ᑉrawstr ( raw_html ), # Use ᑉrawstr() if you don't want escaping
        ᑉtag ( 'applet' , code = 'Bubbles.class' , width = 350 , height = 350 ),  # Tag with custom name
        ᑉdiv ( "custom" , data__custom = "abc" ), # '__' in attribute names is replaced with '-'
        ᑉdiv ( style = 'float: right' )(  # This is how you can type attributes on left and content on right
            ᑉdiv ( style = 'border: 1px solid black' )(
                ᑉa ( "Nested" , href = '#anchortest' ), '|' , 'link' )))). pretty ())

Это выводит:

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
< html lang = " en_US " xmlns = " http://www.w3.org/1999/xhtml " xml : lang = " en_US " >
  < head >
    < title >
      Test page
    </ title >
  </ head >
  < body >
    < p width = " 123 " >
      Hi!
    </ p >
    < hr class = " someclass " />
    < p >
      Literal strings are safely &lt; em &gt; escaped &lt; /em &gt; by default.
    </ p >
    < p >
      Third < em >and last</ em > paragraph
    </ p >< applet code = " Bubbles.class " width = " 350 " height = " 350 " >
      </ applet >
    < div data-custom = " abc " >
      custom
    </ div >
    < div style = " float: right " >
      < div style = " border: 1px solid black " >
        < a href = " #anchortest " >Nested</ a >|link
      </ div >
    </ div >
  </ body >
</ html >

Здание

Чтобы построить пакет PYPI, просто make . Он установит Venv, запустить тесты, генерировать .pyi (тип/синтаксис -заглушка) и создаст исходный пакет (SDIST). Используйте make clean , чтобы очистить.

Альтернативы и подтверждения

Если вы обнаружите, что символы Unicode в исходном коде ужасной мерзостью и не возражаете против бесконечных with выражений, вы можете предпочесть Яттаг.

Использует tidylib для красивой печати. Вдохновение, взятое из pyhtml Cenk Altı.

Авторское право

Copyright 2019 Jarno Elonen. Выпущено по лицензии MIT. Смотрите лицензию для деталей.