Пример

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