sphc · PyPI

Simple Pythonic HTML Creator

Project description

Ultra simple and works

Compatible with Python3/ 2.x
Pythonic
>>> adiv = tf.DIV("Hello World!", id="header_1", Class="header")
>>> print (adiv)
<DIV id="header_1" class="header">Hello World</DIV>

Examples

Hello World!

>>> import sphc
>>> tf = sphc.TagFactory()
>>> header = tf.H1("Hello World!")
>>> print(header)
<H1>Hello World</H1>

Constructing a page

>>> doc = tf.HTML()
>>> doc.body = tf.BODY()
>>> doc.body.content = tf.H1("The content")
>>> print(doc)
<HTML>
    <BODY>
        <H1>The content</H1>
    </BODY>
</HTML>

Using list of Tag objects

Especially usefule for constructing tables and select options:

>>> data = [('One', '1'), ('Two', '2'), ('Three', '3')]
>>> atable = tf.TABLE()
>>> for element in data:
>>>     row = tf.TR()
>>>     row.cells = [tf.TD(element[0]), tf.TD(element[1])]
>>>     atable.row = row

Wrapping

>>> block1 = tf.DIV(tf.DIV("content", Class="inner"), Class="outer")
>>> block2 = tf.DIV([tf.DIV(), tf.DIV()], Class="outer")
>>> content = tf.DIV([block1, block2])

Chaining

set_required method below sets required property on Tag object AND returns Tag object:

>>> form = tf.FORM()
>>> form.username = tf.INPUT(name="username").set_required()
>>> print(form)
<FORM>
    <INPUT name="username" required/>
</FORM>

Properties with no value required

>>> c = tf.INPUT(nv_attrs=['checked'], type='checkbox', value='foo')
>>> print(c)
<INPUT checked type="checkbox", value="foo"/>

Escaping

>>> print(tf.C(' >> ')) # Default
>>> <C> &gt;&gt; </C>

>>> print(tf.C(' >> ', escape=False))
>>> <C> >> </C>

Well since you reached here time to show some experimental stuff.

Hello sphc.more

(loosely based on html5boilerplate.com templates):

>>> import sphc.more
>>> tf = sphc.TagFactory()
>>> class MyPage(sphc.more.HTML5Page):
        def footer(self):
            return tf.FOOTER("Footer text")
>>> my_page = MyPage()
>>> my_page.render()

This will return a string that would contain html exactly like what you have expected

Building a form

>>> import sphc
>>> import sphc.more
>>>
>>> tf = sphc.TagFactory()
>>>
>>> form = sphc.more.Form(classes=['vform'])
>>> form.add_field('Username', tf.INPUT(type="TEXT", id='username', name="username").set_required())
>>> form.add_field('Password', tf.INPUT(type="password", id='password', name="password"))
>>> form.add_buttons(tf.BUTTON("Log In", id='login-btn', type='button'))
>>> print form.build()

<FORM method="POST" Class="vform">
    <DIV Class="field">
        <DIV Class="field-label"> <LABEL For="username">Username</LABEL></DIV>
        <DIV Class="field-input">
            <INPUT required type="TEXT" name="username" id="username"></INPUT><C>*</C>
        </DIV>
    </DIV>
    <DIV Class="field">
        <DIV Class="field-label"> <LABEL For="password">Password</LABEL></DIV>
        <DIV Class="field-input">
            <INPUT type="password" name="password" id="password"></INPUT>
        </DIV>
    </DIV>
    <DIV Class="action-status"></DIV>
    <DIV Class="buttons">
        <BUTTON type="button" id="login-btn">Log In</BUTTON>
    </DIV>
</FORM>

Form with fieldsets

>>> form = sphc.more.Form()
>>>
>>> about = form.add(sphc.more.Fieldset())
>>> about.add(sphc.tf.LEGEND('About'))
>>> about.add_field('Name', sphc.tf.INPUT(name='name', type='text'))
>>>
>>> contact = form.add(sphc.more.Fieldset())
>>> contact.add(sphc.tf.LEGEND('About'))
>>> contact.add_field('Name', sphc.tf.INPUT(name='name', type='text'))

Finally

Source: https://github.com/shon/sphc

Any suggestions/issues | https://github.com/shon/sphc/issues

Critisism or if you feel such thing already implemented feel free to write Authour.

Similar packages

http://shpaml.webfactional.com/ # Just awesome

http://pypi.python.org/pypi/html # Inspiration. It uses __getattr__ trick whereas this package is mostly a __setattr__ trick, aiming sharing of blocks.

http://karrigell.sourceforge.net/en/htmltags.html

TODO

To add more tests

A document class ?

Project details

Release history Release notifications | RSS feed

1.0a pre-release

Sep 23, 2014

This version

0.9.4

Nov 5, 2012

0.9.3

Apr 13, 2012

0.9.2

Dec 28, 2011

0.9.1

Nov 28, 2011

0.9.0

Nov 23, 2011

0.8.8

Oct 23, 2011

0.8.7

Oct 23, 2011

0.8.6

Oct 19, 2011

0.8.5

Oct 17, 2011

0.8.3

Oct 16, 2011

0.8.2

Sep 27, 2011

0.8.1

Sep 17, 2011

0.7.5

Sep 9, 2011

0.7.4

Sep 5, 2011

0.7.3

Sep 2, 2011

0.7.1

Aug 8, 2011

0.5.9

Aug 5, 2011

0.5.7

Aug 5, 2011

0.5.6

Aug 5, 2011

0.5.5

Aug 5, 2011

0.5.4

Aug 5, 2011

0.5.3

Aug 5, 2011

0.5.2

Aug 3, 2011

0.5.1

Aug 3, 2011

0.3.2

Jul 2, 2011

0.3.1

Jul 2, 2011

0.3.0

Jul 2, 2011

0.2.1

Jul 1, 2011

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphc-0.9.4.tar.gz (7.2 kB view details)

Uploaded Nov 5, 2012 Source

File details

Details for the file sphc-0.9.4.tar.gz.

File metadata

Download URL: sphc-0.9.4.tar.gz
Upload date: Nov 5, 2012
Size: 7.2 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for sphc-0.9.4.tar.gz
Algorithm	Hash digest
SHA256	`75fddd0c6f07ab39a8a263a57b52e4fd6d1df61937ffa85e3c9b2429fc07a8aa`
MD5	`578f35e2521eeb2468f440d536149269`
BLAKE2b-256	`c30d816f069e3c28735d4b77e2141ea9b3d3198f3055f814e6d40af46a8e1926`