Performance

formatparse is designed to be fast on hot paths: pattern compilation is cached, type conversion is optimized in Rust, and batch APIs reduce repeated work.

Benchmarks depend on pattern complexity, field types, and input size. For reproducible numbers on your machine, use the scripts in the repository:

• scripts/benchmark.py — general comparisons.

• scripts/benchmark_optimizations.py and scripts/compare_benchmarks.py — optimization-focused runs.

Treat headline speedup figures in marketing material as order-of-magnitude guides, not guarantees for every workload.

When profiling your own app:

• Prefer compile() (or parse() which shares the same cache) when the same pattern is used many times.

• Use parse_batch() when parsing many strings with one compiled parser.

• Use findall_iter() when you want incremental matches without building a full list up front.