py_microhtml

Gerador HTML minimalista para Python 3.6+ com sintaxe compacta

Construa com segurança HTML válido com código Python. Exemplo:

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

Isso imprime um documento xhtml formatado válido:

<! 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 >

Sim, você provavelmente precisará copiar o símbolo Unicode e, sim, você deseja usar um editor moderno, mas a sintaxe resultante é muito compacta e não colide com seus identificadores, mesmo com a import * .

O minimalismo também se estende à implementação - é muito curto (<80 linhas na v0.3). Confira microhtml/__init__.py .

Exemplo mais longo com mais recursos exibidos:

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

Isso sai:

<! 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 >

Prédio

Para construir um pacote Pypi, basta emitir make . Ele instalará um VENV, executará testes, gerará um .pyi (stub de conclusão de sintaxe/tipo/sintaxe) e criará um pacote de origem (SDIST). Use make clean para limpar.

Alternativas e reconhecimentos

Se você encontrar caracteres unicode no código -fonte uma abominação horrenda e não se importar sem aninhados with expressões, você pode preferir Yattag.

Usa tidylib para impressão bonita. Inspiração extraída de pyhtml por Cenk Altı.

Direitos autorais

Copyright 2019 Jarno Elonen. Liberado sob a licença do MIT. Consulte a licença para obter detalhes.