示例

Differentiate Zeitwerk exception hierarchy and error dispatch paths across invalid namespace definitions, unmanaged files, and lifecycle misordering

sha256:9be8f03e18da8a40234c0072cc13a93ec3afcdf7b74fe38906c30c2e17c369d6

案例

目标

Differentiate Zeitwerk exception hierarchy and error dispatch paths across invalid namespace definitions, unmanaged files, and lifecycle misordering HOW

包

zeitwerk 2.8.3

环境

ruby

创建时间

2026-08-16T17:17:19Z

常见的想当然

Defining a non-module object in an explicit namespace file raises Ruby's standard TypeError on nested constant access or Zeitwerk::NameError during autoloading.

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

契约

• assert assigning a non-module object in an explicit namespace file immediately raises Zeitwerk::Error from const_added during autoload, escaping rescue NameError and rescue TypeError
• assert push_dir rejects Symbol and String namespace arguments with Zeitwerk::Error rather than TypeError or ArgumentError
• assert push_dir rejects anonymous modules with Zeitwerk::Error stating root namespaces cannot be anonymous
• assert calling reload without enabling reloading raises Zeitwerk::ReloadingDisabledError while calling enable_reloading after setup raises base Zeitwerk::Error
• assert calling eager_load before setup raises Zeitwerk::SetupRequired rather than RuntimeError or ArgumentError
• assert load_file normalizes missing files, non-Ruby files, ignored files, hidden files, and unmanaged files to Zeitwerk::Error instead of LoadError or Errno::ENOENT
• assert conflicting explicit namespace file and nsfile definitions raise Zeitwerk::ConflictingNamespaceDefinitionError identifying both file paths

文件

• Gemfile
• Gemfile.lock
• NOTES.md
• csx.json
• src/error_paths.rb
• src/trees/anonymous_ns/dummy.rb
• src/trees/conflicting_ns/accounts.rb
• src/trees/conflicting_ns/accounts/ns.rb
• src/trees/eager_unsetup/dummy.rb
• src/trees/file_inputs/.hidden.rb
• src/trees/file_inputs/doc.txt
• src/trees/file_inputs/entry.rb
• src/trees/file_inputs/ignored.rb
• src/trees/invalid_namespace/router.rb
• src/trees/invalid_namespace/router/route.rb
• src/trees/non_module_ns/dummy.rb
• src/trees/reloading/item.rb
• test/contract.rb

下载已验证的构件 (tar.gz) — 契约实际运行的那些字节

原始种子者

csx-seed

验证回执

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