4 releases (2 breaking)

new 0.3.0 Mar 21, 2025
0.2.0 Jan 29, 2022
0.1.1 Sep 9, 2020
0.1.0 Aug 31, 2020

#300 in Rust patterns

Download history 959/week @ 2024-12-01 593/week @ 2024-12-08 697/week @ 2024-12-15 345/week @ 2024-12-22 436/week @ 2024-12-29 756/week @ 2025-01-05 963/week @ 2025-01-12 814/week @ 2025-01-19 720/week @ 2025-01-26 793/week @ 2025-02-02 967/week @ 2025-02-09 1047/week @ 2025-02-16 1268/week @ 2025-02-23 893/week @ 2025-03-02 811/week @ 2025-03-09 1159/week @ 2025-03-16

4,248 downloads per month
Used in 30 crates (26 directly)

MIT/Apache

8KB

regex-macro

Crates.io Version Docs.rs Latest Build Status

This crate contains a little macro to generate a lazy Regex and remove some boilerplate when compiling regex expressions.

Usage

Since it is an anti-pattern to compile the same regular expression in a loop this means for most regex expressions you need to store them in a LazyLock in a static. But this can get a bit tiresome with many regex expressions. This crate provides a regex! macro that will store the compiled regex in a global static and return a reference to it.

Before

use std::sync::LazyLock;
use regex::Regex;

// only compiled once, by storing in a static
static HEX_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
   Regex::new("[0-9a-f]+").expect("invalid regex")
});

for item in my_iter {
    if HEX_PATTERN.is_match(item) {
       // frobnicate
    }
}

After

use regex_macro::regex;

for item in my_iter {
    // this is still only compiled once!
    if regex!("[0-9a-f]+").is_match(item) {
       // frobnicate
    }
}

Isn’t that much nicer?

License

This project is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.

Dependencies

~2.7–4MB
~67K SLoC