Ńň
Ş5Hc
@ sŢ d Z d d k Z d d k Z d d k l Z l Z l Z l Z d d k l Z d d d d d g Z
e i d
e i Z
d d Z d d d d d d d d d
Z d d Z d d Z d Z d Z d Z d S( sŠ HTML helpers that are more than just simple tags.
There are no helpers to prettify HTML or canonicalize whitespace because
BeautifulSoup and HTMLTidy handle this well.
i˙˙˙˙N( t HTMLt literalt lit_subt escape( t convert_boolean_attrst button_tot mail_tot highlightt strip_linkst auto_links/
( # leading text
<\w+.*?>| # leading HTML tag, or
[^=!:'"/]| # leading punctuation, or
^ # beginning of line
)
(
(?:https?://)| # protocol spec, or
(?:www\.) # www.*
)
(
[-\w]+ # subdomain or domain
(?:\.[-\w]+)* # remaining subdomains or domain
(?::\d+)? # port
(?:/(?:(?:[~\w\+%-]|(?:[,.;:][^\s$]))+)?)* # path
(?:\?[\w\+%&=.;-]+)? # query string
(?:\#[\w\-]*)? # trailing anchor
)
([\.,"'?!;:]|\s|<|$) # trailing text
t c K s@ | o t | d g n d } | i d d } | i d j o( t i d d d d d
d d | } n | i d j o | p d
} | | p | } } | i d } | i d } | d j o% | o | | d <| i d | n d | d <| | d > button_to("Edit", url(action='edit', id=3))
Example 2::
>> button_to("Destroy", url(action='destroy', id=3),
.. method='DELETE')
Example 3::
# Button as an image.
>> button_to("Edit", url(action='edit', id=3), type='image',
.. src='icon_delete.gif')
.. note::
This method generates HTML code that represents a form. Forms
are "block" content, which means that you should not try to
insert them into your HTML where only inline content is
expected. For example, you can legally insert a form inside of
a ``div`` or ``td`` element or in between ``p`` elements, but
not in the middle of a run of text, nor can you place a form
within another form.
(Bottom line: Always validate your HTML before going public.)
t disabledR
t methodt PUTt DELETEt typet hiddent idt _methodt name_t valuet GETt POSTt srct imaget altt submitt actiont class_s button-tot c( R
R ( R t popt upperR t inputt gett
setdefaultt formt div( t namet urlt html_optionst
method_tagR t form_methodt submit_typet
img_source( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyR , s$ C
c K sľ g }
x~ d | f d | f d | f d | f f D]R } | d } | o; t | t p | d t | f } n |
i | q1 q1 Wt i |
i d d }
d } | } | o | i d
| } n | o | i d | } n | d j oô t i d
i g } | D] } | d t | q ~ } t i d
i g } | D] } | d t | qI~ } t
i d } g } xF | D]> } | i | o | i d t | q| i | qWt i d
i | } n t i | | } |
o | t i d |
7} n | | d >> mail_to("me@domain.com", "My email", encode = "javascript")
literal(u'')
>>> mail_to("me@domain.com", "My email", encode = "hex")
literal(u'My email')
You can also specify the cc address, bcc address, subject, and body
parts of the message header to create a complex e-mail using the
corresponding ``cc``, ``bcc``, ``subject``, and ``body`` keyword
arguments. Each of these options are URI escaped and then appended
to the ``email_address`` before being output. **Be aware that
javascript keywords will not be escaped and may break this feature
when encoding with javascript.**
Examples::
>>> mail_to("me@domain.com", "My email", cc="ccaddress@domain.com", bcc="bccaddress@domain.com", subject="This is an example email", body= "This is the body of the message.")
literal(u'My email')
t cct bcct subjectt bodyi i t +s %20s mailto:t @t .t hexR
s &#%d;s \ws %%%xt ?t hreft
javascripts document.write('%s');s(
//
R s text/javascriptN( t
isinstanceR R t appendt urllibt urlencodet replaceR t joint ordt ret compilet matcht at script( t
email_addressR% R, R- R. R/ t
replace_att replace_dott encodeR' t extrast itemt optiont
options_queryt protocolt email_address_obfuscatedt _[1]t xt _[2]t word_ret
encoded_partsR& t tagt tmpt _[3]t string( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyR sR "+
1=
4s% \1c C sr | p | o | St i d t i | t i } t | d o t | i | | S| i | | Sd S( sŁ Highlight the ``phrase`` where it is found in the ``text``.
The highlighted phrase will be surrounded by the highlighter,
by default::
I'm a highlight phrase
``highlighter``
Defines the highlighting phrase. This argument should be a
single-quoted string with ``\1`` where the phrase is supposed
to be inserted.
Note: The ``phrase`` is sanitized to include only letters, digits,
and spaces before use.
Example::
>>> highlight('You searched for: Pylons', 'Pylons')
'You searched for: Pylons'
s (%s)t __html__N( R> R? R t It hasattrR t sub( t textt phraset highlightert highlight_re( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyR Ü s "t allc K sV | p d S| d j o t t | | S| d j o t | St | | Sd S( sÚ
Turn all urls and email addresses into clickable links.
``link``
Used to determine what to link. Options are "all",
"email_addresses", or "urls"
Example::
>>> auto_link("Go to http://www.planetpython.com and say hello to guido@python.org")
literal(u'Go to http://www.planetpython.com and say hello to guido@python.org')
u R^ t email_addressesN( t _auto_link_urlst _auto_link_email_addresses( RZ t linkt href_options( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyR ü s
c s( f d } t t i t | | S( Nc sš | i } | i d d d d \ } } } } t i d | t i o | St | | } | d j o
d } n t } t | | | d R@ RW R t dictR RA ( t matchobjR^ t beforet prefixRb t afterRZ t a_options( Rc ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyt handle_match s $
( R R> RY t AUTO_LINK_RE( RZ Rc Rk ( ( Rc s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyR` s c C s t d d | S( Ns4 ([\w\.!#\$%\-+.]+@[A-Za-z0-9\-]+(\.[A-Za-z0-9\-]+)+)s \1( R ( RZ ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyRa ! s c C sU t | t o
t } n
d } t i d t i t i B } | | i d | S( sŹ
Strip link tags from ``text`` leaving just the link label.
Example::
>>> strip_links('else')
'else'
c S s | S( ( ( RN ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyt 2 s s (.*?)<\/a>s \1( R7 R R> R? RW t MRY ( RZ t litt strip_re( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyR % s
( t __doc__R> R9 t webhelpers.htmlR R R R t webhelpers.html.tagsR t __all__R? t XRl R t NoneR R R R` Ra R ( ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/html/tools.pyt s& " ] S