샘플

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