示例

Control pattern memoization and match caching across Mustermann.new, match, and params calls

sha256:b93244f63cc31a720f00109506358b78d33bfdbb43bf8e91519ac4a0d276f669

PUBLISHED L3_CONTRACT_PASS MIT-0

案例

目标: Control pattern memoization and match caching across Mustermann.new, match, and params calls HOW
包: mustermann 4.0.0
环境: ruby
创建时间: 2026-08-16T15:57:09Z

Mustermann.new always allocates a new pattern instance and pattern.params simply delegates to pattern.match to retrieve cached parameter hashes.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

Mustermann.new returns the identical cached pattern instance for matching strings and options via WeakMap memoization rather than allocating a new pattern object each time.
Mustermann.new with different options creates and caches a distinct pattern instance.
pattern.match caches Mustermann::Match objects so consecutive calls with the same path return the identical memoized Match instance and cached params hash.
pattern.params bypasses Match allocation and match caching, returning a newly allocated Hash directly from regexp named captures.
Mustermann.new with cache: false disables Match caching, returning a new Mustermann::Match instance on each match call.
Mustermann.new with a custom cache hash routes cached Match objects into the caller-provided hash table.
Composite pattern operators retain memoization so unioning identical patterns returns the same composite instance.

ruby 3 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · rubygems@1 · 2026-08-16 · ed25519:d91480838ac982c9