Bash-style brace expansion for Python
=====================================
|build-status-img| |PyPI|
Implements Brace Expansion as described in
`bash(1) <http://man7.org/linux/man-pages/man1/bash.1.html#EXPANSION>`__,
with the following limitations:
- A pattern containing unbalanced braces will raise an
``UnbalancedBracesError`` exception. In bash, unbalanced braces will
either be partly expanded or ignored.
- A mixed-case character range like ``'{Z..a}'`` or ``'{a..Z}'`` will
not include the characters :literal:`[]^_\`` between ``Z`` and ``a``.
``braceexpand`` is tested with Python 2.7, and 3.6+
Installation
------------
Install the ``braceexpand`` package from pypi:
::
$ pip install braceexpand
Examples
--------
The ``braceexpand`` function returns an iterator over the expansions
generated from a pattern.
.. code:: python
>>> from braceexpand import braceexpand
# Integer range
>>> list(braceexpand('item{1..3}'))
['item1', 'item2', 'item3']
# Character range
>>> list(braceexpand('{a..c}'))
['a', 'b', 'c']
# Sequence
>>> list(braceexpand('index.html{,.backup}'))
['index.html', 'index.html.backup']
# Nested patterns
>>> list(braceexpand('python{2.{5..7},3.{2,3}}'))
['python2.5', 'python2.6', 'python2.7', 'python3.2', 'python3.3']
# Prefixing an integer with zero causes all numbers to be padded to
# the same width.
>>> list(braceexpand('{07..10}'))
['07', '08', '09', '10']
# An optional increment can be specified for ranges.
>>> list(braceexpand('{a..g..2}'))
['a', 'c', 'e', 'g']
# Ranges can go in both directions.
>>> list(braceexpand('{4..1}'))
['4', '3', '2', '1']
# Numbers can be negative
>>> list(braceexpand('{2..-1}'))
['2', '1', '0', '-1']
# Unbalanced braces raise an exception.
>>> list(braceexpand('{1{2,3}'))
Traceback (most recent call last):
...
UnbalancedBracesError: Unbalanced braces: '{1{2,3}'
# By default, the backslash is the escape character.
>>> list(braceexpand(r'{1\{2,3}'))
['1{2', '3']
# Setting 'escape' to False disables backslash escaping.
>>> list(braceexpand(r'\{1,2}', escape=False))
['\\1', '\\2']
License
-------
braceexpand is licensed under the MIT License. See the included file
``LICENSE`` for details.
.. |build-status-img| image:: https://travis-ci.org/trendels/braceexpand.svg
:target: https://travis-ci.org/trendels/braceexpand
.. |PyPI| image:: https://img.shields.io/pypi/v/braceexpand
:target: https://pypi.python.org/pypi/braceexpand