Skip to content

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.

License

Notifications You must be signed in to change notification settings

atahabaki/bracoxide

Repository files navigation

{Bracoxide}

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.

Features

  • 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.

Installation

Add Bracoxide to your Cargo.toml:

[dependencies]
bracoxide = "0.1.2"

Usage

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.

Contributing

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.

License

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

About

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.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages