示例
mustermann 4.0.0: Distinguish Mustermann error hierarchy and exception types raised for malformed pattern syntax, invalid capture identifiers, anchored regexps, unsupported types, and missing expand parameters
已验证示例 — gem mustermann 4.0.0: Distinguish Mustermann error hierarchy and exception types raised for malformed pattern syntax, invalid capture identifiers…
sha256:aaa0dba8bc057cb87c4fc9aba644a736d975024736c643655c77f03ab87944e3
本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。
提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。
MIT-0
执行证据
声明的环境与签名的运行分开呈现,你可以看到这个样本究竟运行了什么、在哪里运行。
- 证据依据
- 签名契约通过
- 验证回执
- 2
- 构建过它的签名密钥
- 1
声明的环境
ruby linux x64 ruby ruby rubygems
验证运行环境
| 环境 | 契约 | 阶段 | 运行日期 |
|---|---|---|---|
| ruby 3 · linux alpine/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · rubygems@1 |
2026-08-16 |
| ruby 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 | SKIPPED | compile:SKIPPED · contract:SKIPPED · load:SKIPPED · resolve:FAIL CONTAINER_RUN · rubygems@1 |
2026-08-18 |
案例
HOW- 目标
- Distinguish Mustermann error hierarchy and exception types raised for malformed pattern syntax, invalid capture identifiers, anchored regexps, unsupported types, and missing expand parameters
- 符号
-
- Mustermann.new
- Mustermann::Error
- Mustermann::CompileError
- Mustermann::ParseError
- Mustermann::ExpandError
- Mustermann::Pattern#expand
- Mustermann::Pattern#params
- 环境
- ruby
- 创建时间
- 2026-08-16T15:54:28Z
契约
- Mustermann raises Mustermann::CompileError rather than Mustermann::ParseError when a pattern contains malformed capture names such as empty captures or leading digits, while unclosed groupings raise Mustermann::ParseError and expand with :ignore still raises Mustermann::ExpandError when required keys are missing.
- assert Mustermann.new('/foo/:') and Mustermann.new('/foo/:123') raise Mustermann::CompileError instead of Mustermann::ParseError
- assert Mustermann.new('/foo/(bar') and Mustermann.new('/foo/{bar') raise Mustermann::ParseError with unexpected token messages
- assert Mustermann.new('^/foo', type: :regexp) raises Mustermann::CompileError when anchor characters are present in regular expressions
- assert Mustermann.new('/foo', type: :unsupported_custom_type) raises ArgumentError rather than Mustermann::Error
- assert pattern.expand(:ignore, {}) raises Mustermann::ExpandError when required captures are missing because :ignore only applies to extra keys
- assert pattern.expand(:invalid_behavior, id: 1) raises ArgumentError rather than Mustermann::ExpandError
- assert Mustermann::CompileError, Mustermann::ParseError, and Mustermann::ExpandError all inherit from Mustermann::Error < StandardError
文件
- Gemfile
- NOTES.md
- csx.json
- test/contract.rb
源代码
source "https://rubygems.org"
gem "mustermann", "4.0.0"
gem "minitest", "5.27.0"
# Mustermann Error Handling and Exception Boundaries
`search_known_solution` returned low-confidence compatible results pointing to unrelated crates and packages (`sha256:37c7408540f30c3e0ea78c7a69f7ddb967574c1c9fbfebcf11fbf25d3bbe07d5` for winnow error handling, `sha256:175897b84668b354a5c39ba16574961f62a504460d7259ed94746eae6b9bf866` for anyhow error downcasting, and `sha256:c4176f13ba0e8f85f39a4eab0dbbeb9630be1dd5d0d6d9d8d7223193eca43a14` for php-parser v5).
The wrong version fails loudly with an unhandled exception or failed assertion when assuming malformed capture names raise `Mustermann::ParseError` instead of `Mustermann::CompileError`, or when expecting `expand(:ignore, ...)` to suppress missing capture errors.
{"case":{"believed":"Malformed route pattern strings raise Mustermann::ParseError on invalid capture syntax, while :ignore expansion suppresses missing parameter errors.","caseId":"case:sha256:d6af2c1f26b14ed64630e83feaf7898f232c1612485fc7ea487d999dfb3222f2","contract":["Mustermann raises Mustermann::CompileError rather than Mustermann::ParseError when a pattern contains malformed capture names such as empty captures or leading digits, while unclosed groupings raise Mustermann::ParseError and expand with :ignore still raises Mustermann::ExpandError when required keys are missing.","assert Mustermann.new('/foo/:') and Mustermann.new('/foo/:123') raise Mustermann::CompileError instead of Mustermann::ParseError","assert Mustermann.new('/foo/(bar') and Mustermann.new('/foo/{bar') raise Mustermann::ParseError with unexpected token messages","assert Mustermann.new('^/foo', type: :regexp) raises Mustermann::CompileError when anchor characters are present in regular expressions","assert Mustermann.new('/foo', type: :unsupported_custom_type) raises ArgumentError rather than Mustermann::Error","assert pattern.expand(:ignore, {}) raises Mustermann::ExpandError when required captures are missing because :ignore only applies to extra keys","assert pattern.expand(:invalid_behavior, id: 1) raises ArgumentError rather than Mustermann::ExpandError","assert Mustermann::CompileError, Mustermann::ParseError, and Mustermann::ExpandError all inherit from Mustermann::Error \u003c StandardError"],"goal":"Distinguish Mustermann error hierarchy and exception types raised for malformed pattern syntax, invalid capture identifiers, anchored regexps, unsupported types, and missing expand parameters","kind":"HOW","packages":["pkg:gem/mustermann@4.0.0"],"schemaVersion":1,"symbols":["Mustermann.new","Mustermann::Error","Mustermann::CompileError","Mustermann::ParseError","Mustermann::ExpandError","Mustermann::Pattern#expand","Mustermann::Pattern#params"]},"contractCommand":["ruby","test/contract.rb"],"environment":{"arch":"x64","ecosystem":"gem","executionContext":"ruby","language":"ruby","os":"linux","packageManager":"rubygems","runtime":"ruby","schemaVersion":1},"license":"MIT-0","packages":["pkg:gem/mustermann@4.0.0"],"schemaVersion":1,"symbols":["Mustermann.new","Mustermann::Error","Mustermann::CompileError","Mustermann::ParseError","Mustermann::ExpandError","Mustermann::Pattern#expand","Mustermann::Pattern#params"],"verifierAdapter":"rubygems@1"}
# frozen_string_literal: true
require 'minitest/autorun'
require 'mustermann'
class MustermannErrorHandlingContractTest < Minitest::Test
def test_error_hierarchy_inherits_from_mustermann_error_and_standard_error
assert_operator Mustermann::Error, :<, StandardError
assert_operator Mustermann::CompileError, :<, Mustermann::Error
assert_operator Mustermann::ParseError, :<, Mustermann::Error
assert_operator Mustermann::ExpandError, :<, Mustermann::Error
assert_operator Mustermann::TrieError, :<, Mustermann::CompileError
end
def test_malformed_capture_names_raise_compile_error_rather_than_parse_error
# Empty capture name (/:) raises CompileError, not ParseError
empty_err = assert_raises(Mustermann::CompileError) do
Mustermann.new('/foo/:')
end
assert_includes empty_err.message, "capture name can't be empty"
refute empty_err.is_a?(Mustermann::ParseError)
# Invalid capture name starting with digit (/:123) raises CompileError, not ParseError
digit_err = assert_raises(Mustermann::CompileError) do
Mustermann.new('/foo/:123')
end
assert_includes digit_err.message, "capture name must start with underscore or lower case letter"
refute digit_err.is_a?(Mustermann::ParseError)
# Forbidden capture name in named splat (/*captures) raises CompileError
splat_err = assert_raises(Mustermann::CompileError) do
Mustermann.new('/foo/*captures')
end
assert_includes splat_err.message, "capture name can't be captures"
refute splat_err.is_a?(Mustermann::ParseError)
end
def test_unclosed_groups_and_brackets_raise_parse_error
# Unclosed parentheses
paren_err = assert_raises(Mustermann::ParseError) do
Mustermann.new('/foo/(bar')
end
assert_includes paren_err.message, 'unexpected end of string while parsing'
# Unclosed braces
brace_err = assert_raises(Mustermann::ParseError) do
Mustermann.new('/foo/{bar')
end
assert_includes brace_err.message, 'unexpected end of string while parsing'
# Trailing escape backslash
escape_err = assert_raises(Mustermann::ParseError) do
Mustermann.new('/foo\\')
end
assert_includes escape_err.message, 'unexpected end of string while parsing'
end
def test_anchor_in_regexp_pattern_raises_compile_error
anchor_err = assert_raises(Mustermann::CompileError) do
Mustermann.new('^/foo', type: :regexp)
end
assert_includes anchor_err.message, 'regular expression should not contain ^'
end
def test_unsupported_pattern_type_raises_argument_error_not_mustermann_error
arg_err = assert_raises(ArgumentError) do
Mustermann.new('/foo', type: :unsupported_custom_type)
end
assert_includes arg_err.message, 'unsupported type :unsupported_custom_type'
refute arg_err.is_a?(Mustermann::Error)
end
def test_expand_missing_required_keys_raises_expand_error_even_with_ignore_behavior
pattern = Mustermann.new('/users/:id')
# Missing required keys raise ExpandError across all behaviors
assert_raises(Mustermann::ExpandError) do
pattern.expand(:raise, {})
end
assert_raises(Mustermann::ExpandError) do
pattern.expand(:ignore, {})
end
assert_raises(Mustermann::ExpandError) do
pattern.expand(:append, {})
end
# Extra keys: :raise fails, :ignore drops, :append adds query params
raise_err = assert_raises(Mustermann::ExpandError) do
pattern.expand(:raise, id: 10, extra: 'val')
end
assert_includes raise_err.message, 'cannot expand with keys'
assert_equal '/users/10', pattern.expand(:ignore, id: 10, extra: 'val')
assert_equal '/users/10?extra=val', pattern.expand(:append, id: 10, extra: 'val')
# Unknown expand behavior raises ArgumentError, not ExpandError
behavior_err = assert_raises(ArgumentError) do
pattern.expand(:invalid_behavior, id: 10)
end
assert_includes behavior_err.message, 'unknown behavior :invalid_behavior'
refute behavior_err.is_a?(Mustermann::ExpandError)
end
def test_non_matching_and_invalid_param_inputs
pattern = Mustermann.new('/users/:id')
# Non-matching path returns nil for params and false for ===
assert_nil pattern.params('/other/path')
refute pattern === '/other/path'
# Non-string input to params raises TypeError
assert_raises(TypeError) do
pattern.params(12345)
end
end
end