Edgewall Software
Please note:

The documentation here is generated live, in a way that is neither comprehensive nor 100% correct. We strongly recommend using the HTML documentation included with the source tarballs instead.

  1. distinct
  2. parse_encoding
  3. pathmatch
  4. TextWrapper
    1. wraptext
    2. odict
      1. clear
      2. copy
      3. items
      4. iteritems
      5. keys
      6. pop
      7. popitem
      8. setdefault
      9. update
      10. values
      11. itervalues
    3. FixedOffsetTimezone
      1. utcoffset
      2. tzname
      3. dst
    4. LocalTimezone
      1. utcoffset
      2. dst
      3. tzname

babel.util

Various utility classes and functions.

distinct(iterable)

Yield all items in an iterable collection that are distinct.

Unlike when using sets for a similar effect, the original ordering of the items in the collection is preserved by this function.

>>> print list(distinct([1, 2, 1, 3, 4, 4]))
[1, 2, 3, 4]
>>> print list(distinct('foobar'))
['f', 'o', 'b', 'a', 'r']
param iterable:the iterable collection providing the data
return:the distinct items in the collection
rtype:iterator

parse_encoding(fp)

Deduce the encoding of a source file from magic comment.

It does this in the same way as the Python interpreter

The fp argument should be a seekable file object.

(From Jeff Dairiki)

pathmatch(pattern, filename)

Extended pathname pattern matching.

This function is similar to what is provided by the fnmatch module in the Python standard library, but:

  • can match complete (relative or absolute) path names, and not just file names, and
  • also supports a convenience pattern ("**") to match files at any directory level.

Examples:

>>> pathmatch('**.py', 'bar.py')
True
>>> pathmatch('**.py', 'foo/bar/baz.py')
True
>>> pathmatch('**.py', 'templates/index.html')
False

>>> pathmatch('**/templates/*.html', 'templates/index.html')
True
>>> pathmatch('**/templates/*.html', 'templates/foo/bar.html')
False
param pattern:the glob pattern
param filename:the path name of the file to match against
return:True if the path name matches the pattern, False otherwise
rtype:bool

TextWrapper

(Not documented)

wraptext(text, width=70, initial_indent='', subsequent_indent='')

Simple wrapper around the textwrap.wrap function in the standard library. This version does not wrap lines on hyphens in words.

param text:the text to wrap
param width:the maximum line width
param initial_indent:
 string that will be prepended to the first line of wrapped output
param subsequent_indent:
 string that will be prepended to all lines save the first of wrapped output
return:a list of lines
rtype:list

odict

Ordered dict implementation.

see:http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/107747

clear(self)

(Not documented)

copy(self)

(Not documented)

items(self)

(Not documented)

iteritems(self)

(Not documented)

keys(self)

(Not documented)

pop(self, key, default=missing)

(Not documented)

popitem(self, key)

(Not documented)

setdefault(self, key, failobj=None)

(Not documented)

update(self, dict)

(Not documented)

values(self)

(Not documented)

itervalues(self)

(Not documented)

FixedOffsetTimezone

Fixed offset in minutes east from UTC.

utcoffset(self, dt)

(Not documented)

tzname(self, dt)

(Not documented)

dst(self, dt)

(Not documented)

LocalTimezone

(Not documented)

utcoffset(self, dt)

(Not documented)

dst(self, dt)

(Not documented)

tzname(self, dt)

(Not documented)

See ApiDocs, Documentation