Rust Advanced String Generator

This project provides a powerful and flexible string generator based on regex-like patterns, with support for features such as character classes, custom repeats, array-based string selection, incremental values, and more. The application can be compiled and used both as a native Rust library and in a WebAssembly (WASM) context.

Demo

Demo for this project below https://igarashi.net/rust-advanced-string-generator/

Features

• Character Classes: Supports \d, \w, \s, \D, \W, \S, etc.
• Custom Repeats: Generate strings with patterns like \d{2,4}.
• Character Ranges: Use ranges like [a-z], [A-Z], [0-9] to specify sets of characters.
• Negation in Ranges: Specify characters not to be included with patterns like [^a-z].
• Incremental Values: Automatically increment values using patterns like \i+ for ascending and \i- for descending.
• Array-Based Selection: Choose from an array of strings using patterns like \a, \a+, and \a-.
• Group Capturing and Backreferences: Capture groups of characters and reference them later in the pattern.
• WASM Support: Compile the project to WebAssembly and use it in a web environment.

Installation

1. Clone the repository:

   git clone https://github.com/your-repo/regex_generator.git
   

2. Navigate to the project directory:

   cd regex_generator
   

3. Build the project:

   cargo build --release
   

For WebAssembly

1. Ensure you have wasm-pack installed:

cargo install wasm-pack

2. Build the project targeting WebAssembly:

wasm-pack build --target web --features wasm

3. Use the generated WebAssembly module in your web project.

Usage

regex_generator [OPTIONS] PATTERN [INCREMENT] [ARRAY]

Examples

1. Generate a string with an incrementing value with leading zeros:

   ./target/release/regex_generator -p '\\i{:10}' -i 43
   

2. Generate a random string from an array:

   ./target/release/regex_generator -p '[A-Za-z]{5}' -a 'apple,banana,grape'
   

3. Use a combination of patterns:

   ./target/release/regex_generator -p '\\w{3}-\\d{2:5}-\\i{:6}' -i 100 -a 'cat,dog,mouse'
   

WASM Example

import init, { WasmRegexGenerator } from './pkg/regex_generator_wasm.js';

async function run() {
    await init();

    const generator = new WasmRegexGenerator("\\i+\\d\\d", "1299", ["apple", "banana", "cherry"]);
    console.log(generator.generate()); // Outputs: 1300
    console.log(generator.generate()); // Outputs: 1301
}

run();

Options

Supported Patterns

Testing

Native Rust

To run the tests in a native Rust environment, execute:

cargo test

WebAssembly

To build and test the WebAssembly version, follow these steps:

1. Build the WASM module:

   wasm-pack build --target web --features wasm
   

2. Create an HTML file to load and test the WASM module.

3. Serve the HTML file locally using a server like Python's http.server:

   python3 -m http.server
   

Help

To get help information, run:

./target/release/regex_generator -h

Version

To check the version of the tool, run:

./target/release/regex_generator -v

License

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

Contributing

Contributions are welcome! Please submit a pull request or create an issue to report bugs or suggest features.