Bash Style Brace Expander

2.6 · active · verified Sun Mar 29

Bracex is a Python library that provides Bash-style brace expansion, enabling the generation of arbitrary strings from patterns. It closely emulates Bash's brace processing, supporting comma-separated lists, numerical and alphabetical sequences (ranges), and optional step increments. The library is actively maintained, with version 2.6 being the latest, and releases occur regularly to ensure compatibility with newer Python versions and address minor fixes.

Warnings

breaking Bracex has progressively dropped support for older Python versions. Version 2.6 (current) requires Python 3.9 or higher. Previous versions dropped support for Python 3.8 (in 2.6), 3.7 (in 2.4), 3.6 (in 2.3), and 3.5 (in 2.1.0).
Fix: Upgrade your Python environment to 3.9 or newer before upgrading to bracex 2.6. Always check the `requires_python` field on PyPI for the desired `bracex` version.
gotcha The `expand()` and `iexpand()` functions include a `limit` parameter (defaulting to 1000) to prevent excessively large expansions, which could lead to performance issues or 'brace bombs'. If an expansion exceeds this limit, an error is raised.
Fix: For very large or potentially unbounded expansions, consider increasing the `limit` parameter (e.g., `bracex.expand(pattern, limit=5000)`) or setting `limit=0` to disable the limit entirely if you are certain of the pattern's safety and have sufficient memory. Using `iexpand()` can also help manage memory for large results.
gotcha While `bracex` closely mimics Bash's brace expansion, it is not a 1:1 implementation. It may deviate in certain edge cases, particularly regarding how Bash handles command-line inputs (e.g., backticks and quotes).
Fix: If migrating complex Bash scripts, thoroughly test patterns in `bracex` that rely on specific Bash shell behaviors beyond simple brace expansion. Refer to the official documentation for noted deviations.
deprecated The build backend for `bracex` switched from Setuptools to Hatch in version 2.3. While this primarily affects maintainers and packagers, it's a significant internal change.
Fix: Users consuming `bracex` via `pip install` are generally unaffected. If you are involved in packaging or contributing, be aware of the updated build system requirements and configuration (e.g., `pyproject.toml`).

Install

pip install bracex Install latest version

Imports

expand
```
import bracex
expanded_list = bracex.expand('file-{a,b}.txt')
```
The most common usage is to import the `bracex` module and call its functions directly.
iexpand
```
import bracex
expanded_generator = bracex.iexpand('file-{1..3}.jpg')
```
`iexpand` returns a generator for memory-efficient iteration, useful for very large expansions.

Quickstart

Demonstrates basic brace expansion for lists, nested patterns, numerical and alphabetical sequences, and the generator-based iteration using `iexpand`.

import bracex

# Basic list expansion
print(bracex.expand(r'file-{a,b,c}.txt'))

# Nested brace expansion
print(bracex.expand(r'path/to/{{foo,bar},baz}/file.txt'))

# Numerical sequence (range) expansion
print(bracex.expand(r'image{00..02}.png'))

# Numerical sequence with step
print(bracex.expand(r'item{1..10..3}.log'))

# Alphabetic sequence
print(bracex.expand(r'letter{A..D}.md'))

# Using the generator version
for item in bracex.iexpand(r'data-{1..5}.csv'):
    print(item)

view raw JSON →