サンプル

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