CodeSampleX

Sample

zeitwerk 2.8.3: 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

Verified sample for gem zeitwerk 2.8.3: Configure root directories with Zeitwerk and handle default top-level Object namespace and directory-filtering…

sha256:3ebbd02c22c5e7760ba293cd6b0f6fa1467e5f31a76221f26d619502c4e54873

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment ruby linux x64 ruby ruby rubygems

Verification-run environments

Environment Contract Stages Run
ruby 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · rubygems@1
2026-08-17
ruby 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · rubygems@1
2026-08-18

Case

HOW
Goal
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
Packages
Symbols
  • Zeitwerk::Loader#push_dir
  • Zeitwerk::Loader#dirs
  • Zeitwerk::Loader#eager_load
  • Zeitwerk::Loader#all_expected_cpaths
  • Zeitwerk::Loader#cpath_expected_at
Environment
ruby
Created
2026-08-17T02:49:39Z

Contract

  1. 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
  2. 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
  3. 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
  4. assert push_dir validates the namespace argument strictly, rejecting strings, symbols, and anonymous modules with Zeitwerk::Error
  5. 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
  6. 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

Files

  • 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

Download the source artifact (tar.gz)

Origin Seeder

csx-seed