#parser-combinator #permutation #combination #string #parser #brace-expansion


A feature-rich library for brace pattern combination, permutation generation, and error handling

4 releases

0.1.3 Sep 20, 2023
0.1.2 Aug 7, 2023
0.1.1 Jul 20, 2023
0.1.0 Jun 21, 2023

#334 in Parser implementations

Download history 2239/week @ 2023-12-15 1580/week @ 2023-12-22 1622/week @ 2023-12-29 2010/week @ 2024-01-05 2262/week @ 2024-01-12 2067/week @ 2024-01-19 2035/week @ 2024-01-26 2036/week @ 2024-02-02 1892/week @ 2024-02-09 2299/week @ 2024-02-16 2190/week @ 2024-02-23 2261/week @ 2024-03-01 2481/week @ 2024-03-08 1868/week @ 2024-03-15 2160/week @ 2024-03-22 1862/week @ 2024-03-29

8,817 downloads per month
Used in 14 crates (2 directly)

MIT license



Tests License: MIT Contributor Covenant Documentation Bracoxide Crate

Bracoxide is a powerful Rust library for handling and expanding brace expansions. It provides a simple and intuitive way to generate combinations and permutations from brace patterns.


  • Brace Expansion: Easily expand brace patterns into a list of all possible combinations.
  • Error Handling: Comprehensive error handling for invalid brace patterns or expansion failures.
  • MIT Licensed: Bracoxide is open-source and licensed under the MIT License.


Add Bracoxide to your Cargo.toml:

bracoxide = "0.1.2"


Import the bracoxide crate and start expanding brace patterns:

use bracoxide::explode;

fn main() {
    let content = "foo{1..3}bar";
    match explode(content) {
        Ok(expanded) => {
            // [`foo1bar`, `foo2bar`, `foo3bar`]
            println!("Expanded patterns: {:?}", expanded);
        Err(error) => {
            eprintln!("Error occurred: {:?}", error);

For more details and advanced usage, please refer to the API documentation.


match contribution {
    /// found a bug or encountered an issue
    Contribution::Issue => redirect!("https://github.com/atahabaki/bracoxide/issues"),
    /// propose any changes
    Contribution::Change => redirect!("https://github.com/atahabaki/bracoxide/pulls"),
    /// have a question or need help
    Contribution::Ask => redirect!("https://github.com/atahabaki/bracoxide/discussions"),

Contributions are welcome! If you would like to contribute to this project, here are a few ways you can get involved:

  • Report Issues: If you encounter any issues or bugs, please let us know by creating an issue. Provide a detailed description of the problem, including steps to reproduce it if possible.
  • Propose Changes: If you have ideas for improvements or new features, we encourage you to submit a pull request. We appreciate your contributions and will review and consider them.
  • Ask Questions: If you have any questions or need help with the project, feel free to start a discussion. We'll be happy to assist you.

Please review our contribution guidelines for more detailed information on how to contribute effectively.


This project is licensed under the MIT License - see the LICENSE file for details.

No runtime deps