示例

Configure root directories with Zeitwerk and handle default top-level Object namespace and directory-filtering defaults in push_dir and dirs without name collisions or missing constant errors

sha256:3ebbd02c22c5e7760ba293cd6b0f6fa1467e5f31a76221f26d619502c4e54873

案例

目标

Configure root directories with Zeitwerk and handle default top-level Object namespace and directory-filtering defaults in push_dir and dirs without name collisions or missing constant errors HOW

包

zeitwerk 2.8.3

环境

ruby

创建时间

2026-08-17T02:49:39Z

常见的想当然

push_dir without an explicit namespace parameter scopes autoloaded constants under a module matching the directory name.

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

契约

• assert push_dir with namespace left unset defaults the root namespace to Object rather than inferring a namespace from the directory name, mapping the directory to Object in all_expected_cpaths and expecting unprefixed top-level constants
• assert a file that defines its class nested inside a directory-named module raises Zeitwerk::NameError under default push_dir because Zeitwerk expects the unprefixed top-level constant name
• assert scoping files under a custom parent module requires explicitly passing namespace: Module to push_dir, which expects prefixed constant paths and autovivifies subdirectories under that module
• assert push_dir validates the namespace argument strictly, rejecting strings, symbols, and anonymous modules with Zeitwerk::Error
• assert loader.dirs with default arguments returns an Array of paths and silently filters out ignored root directories, while passing namespaces: true returns a Hash of dir to Module and ignored: true includes ignored roots
• assert loader.eager_load with default force: false skips files configured with do_not_eager_load leaving their autoloads pending, whereas force: true forces them to load while still ignoring paths in loader.ignore

文件

• Gemfile
• Gemfile.lock
• NOTES.md
• csx.json
• src/loader_defaults.rb
• src/trees/custom_namespace/gateways/stripe.rb
• src/trees/custom_namespace/invoice.rb
• src/trees/default_root/gateways/stripe.rb
• src/trees/default_root/invoice.rb
• src/trees/eager_exclusions/eager_excluded.rb
• src/trees/eager_exclusions/eager_ignored.rb
• src/trees/eager_exclusions/eager_normal.rb
• src/trees/ignored_root/dummy.rb
• src/trees/mismatch_namespace/invoice.rb
• test/contract.rb

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

原始种子者

csx-seed

验证回执

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