babel.util

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']

Parameters
iterable	the iterable collection providing the data

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)

Parse the compiler flags by __future__ from the given Python code.

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('./foo/**.py', 'foo/bar/baz.py')
True
>>> pathmatch('./foo/**.py', 'bar/baz.py')
False

>>> pathmatch('^foo/**.py', 'foo/bar/baz.py')
True
>>> pathmatch('^foo/**.py', 'bar/baz.py')
False

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

Parameters
pattern	the glob pattern
filename	the path name of the file to match against

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

Parameters
text	the text to wrap
width	the maximum line width
initial​_indent	string that will be prepended to the first line of wrapped output
subsequent​_indent	string that will be prepended to all lines save the first of wrapped output