">
... use item ...
% #endfor
You can use named cycles to prevent clashes in nested loops. You'll
have to reset the inner cycle, manually::
% for item in items:
|
% for value in item.values:
'">
item
% #endfor
<% reset_cycle("colors") %>
|
% #endfor
i i t namet defaults railshelpers.cyclesR R ( t lent getR t environt
setdefaultR t next( t argst kargsR R t cyclesR ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyR , s &
R
c C s/ y t ƒ i d | =Wn t j
o n Xd S( sŒ
Reset a cycle.
Resets the cycle so that it starts from the first element in the
array the next time it is used.
s railshelpers.cyclesN( R R
t KeyError( R ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt reset_cycle_ s i c C sF t ƒ i i d h ƒ } d „ } | i | | | | ƒ ƒ } | i ƒ S( s Return the next cardinal in a sequence.
Every time ``counter`` is called, the value returned will be the next
counting number in that sequence. This is reset to ``start`` on every
request, but can also be reset by calling ``reset_counter()``.
You can optionally specify the number you want to start at by passing
in the ``start`` argument (defaults to 1).
You can also optionally specify the step size you want by passing in
the ``step`` argument (defaults to 1).
Sequences will increase monotonically by ``step`` each time it is
called, until the heat death of the universe or python explodes.
This can be used to count rows in a table::
# In Myghty
% for item in items:
| <% h.counter() %> |
% #endfor
You can use named counters to prevent clashes in nested loops.
You'll have to reset the inner cycle manually though. See the
documentation for ``webhelpers.text.cycle()`` for a similar
example.
s railshelpers.countersc s s" x t o | V| | 7} q Wd S( N( t True( t startt step( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt
do_counterŽ s ( R R
R R ( R R R t countersR t counter( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyR l s c C s/ y t ƒ i d | =Wn t j
o n Xd S( sŠ Reset a counter.
Resets the counter so that it starts from the ``start`` cardinal in
the sequence next time it is used.
s railshelpers.countersN( R R
R ( R ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt
reset_counter— s i s ...c C sD | p d S| t | ƒ } t | ƒ | j o
| | | S| Sd S( sx
Truncate ``text`` with replacement characters.
``length``
The maximum length of ``text`` before replacement
``truncate_string``
If ``text`` exceeds the ``length``, this string will replace
the end of the string
Example::
>>> truncate('Once upon a time in a world far far away', 14)
'Once upon a...'
t N( R ( t textt lengtht truncate_stringt new_len( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt truncate£ s
s% \1c C sq | d j o t i d t d ƒ | } n | p | o | St i d t i | ƒ t i ƒ } | i | | ƒ 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'
ss The highlight function's hilight keyword argument is deprecated: Please use the highlight keyword argument instead.i s (%s)N( t Nonet warningst warnt DeprecationWarningt ret compilet escapet It sub( R t phraset highlightert hilightert highlight_re( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt highlight» s
"id c C s¼ | p | o | St i d | t i | ƒ | f t i ƒ } | i | ƒ } | p d S| i d ƒ } | i d ƒ d j o | | } n | i d ƒ t | ƒ j o | | } n | S( sx
Extract an excerpt from the ``text``, or '' if the phrase isn't found.
``phrase``
Phrase to excerpt from ``text``
``radius``
How many surrounding characters to include
``excerpt_string``
Characters surrounding entire excerpt
Example::
>>> excerpt("hello my world", "my", 3)
'...lo my wo...'
s (.{0,%s}%s.{0,%s})R s \1i i ( R& R' R( R) t searcht expandR t endR ( R R+ t radiust excerpt_stringt patt matcht excerpt( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyR7 Ý s + iP c C s# t i d t d ƒ t i | | ƒ S( s
Wrap ``text`` into lines of at most ``line_width`` width. Deprecated.
This is deprecated: Use python's builtin textwrap.fill instead.
This function breaks on the first whitespace character that does not
exceed ``line_width``.
s` The word_wrap function has been deprecated: Use python's builtin textwrap.fill function instead.i ( R# R$ R% t textwrapt fill( R t
line_width( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt word_wrapü s
c C sŸ | d j o
d } n t i d d | ƒ } t i d d | ƒ } t i d d | ƒ } t i d d | ƒ } t d
| ƒ i d d ƒ } t i d
d | ƒ } | S( sZ
Return ``text`` transformed into HTML using simple formatting rules.
Two or more consecutive newlines(``\n\n``) are considered as a
paragraph and wrapped in ```` tags. One newline (``\n``) is
considered a linebreak and a ``
`` tag is appended. This method
does not remove the newlines from the text.
R s (\r\n|\n|\r)s \ns \n\n+s \n\ns (\n\n)s
\1s ([^\n])(\n)(?=[^\n])s
\1\2
t ps
s s s
\nN( R" R& R* R t replace( R ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt
simple_format
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")
'Go to http://www.planetpython.com and say hello to guido@python.org'
R R? t email_addressesN( t auto_link_urlst auto_link_email_addresses( R t linkt href_options( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt auto_link s
c s. t | ‰ ‡ f d † } t i t | | ƒ S( Nc s‰ | i ƒ } | i d d d d ƒ \ } } } } t i d | t i ƒ o | S| | } | d j o
d } n d | | | ˆ | | f S( Ni i i i s %s%s( t groupR& R6 R) ( t matchobjR? t at bt ct dR ( t
extra_options( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt handle_match7 s $
( R R& R* t AUTO_LINK_RE( R RD RM ( ( RL s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyRA 5 s c C s t i d d | ƒ S( Ns4 ([\w\.!#\$%\-+.]+@[A-Za-z0-9\-]+(\.[A-Za-z0-9\-]+)+)s \1( R& R* ( R ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyRB B s c C s, 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'
s (.*?)<\/a>s \1( R& R' R) t MR* ( R t strip_re( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt strip_linksF s
c C s t i | ƒ } | i d | ƒ S( s- Format the text with Textile formatting.
This function uses the `PyTextile library `_
which is included with WebHelpers.
Additionally, the output can be sanitized which will fix tags like
![]()
,
and
for proper XHTML output.
t sanitize( t textilet Textilert process( R RR t texer( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt textilizeS s
c K s t i | | S( sÐ Format the text with MarkDown formatting.
This function uses the `Python MarkDown library
`_
which is included with WebHelpers.
( t _markdownt markdown( R t kwargs( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyRY ` s R R R R R! R/ R7 R; R> RE RQ RW RY ($ t __doc__R R& R8 R# t webhelpers.textileRS t webhelpers.markdownRY RX t routesR t webhelpers.rails.tagsR R R' t XRN R R R R R R! R" R/ R7 R; R> RE RA RB RQ t FalseRW t __all__( ( ( s9 /usr/lib/python2.6/site-packages/webhelpers/rails/text.pyt s: 3
+ !