4 releases (2 breaking)

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

#308 in Rust patterns

Download history 781/week @ 2025-01-06 942/week @ 2025-01-13 804/week @ 2025-01-20 679/week @ 2025-01-27 869/week @ 2025-02-03 914/week @ 2025-02-10 1073/week @ 2025-02-17 1262/week @ 2025-02-24 923/week @ 2025-03-03 789/week @ 2025-03-10 1192/week @ 2025-03-17 1013/week @ 2025-03-24 748/week @ 2025-03-31 949/week @ 2025-04-07 768/week @ 2025-04-14 830/week @ 2025-04-21

3,377 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.6–4MB
~65K SLoC