CodeSampleX

Sample

zeitwerk 2.8.3: Differentiate Zeitwerk exception hierarchy and error dispatch paths across invalid namespace definitions, unmanaged files, and lifecycle misordering

Verified sample for gem zeitwerk 2.8.3: Differentiate Zeitwerk exception hierarchy and error dispatch paths across invalid namespace definitions, unmanaged…

sha256:9be8f03e18da8a40234c0072cc13a93ec3afcdf7b74fe38906c30c2e17c369d6

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 bundler

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-16
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
Differentiate Zeitwerk exception hierarchy and error dispatch paths across invalid namespace definitions, unmanaged files, and lifecycle misordering
Packages
Symbols
  • Zeitwerk::Loader
  • Zeitwerk::Loader#push_dir
  • Zeitwerk::Loader#setup
  • Zeitwerk::Loader#enable_reloading
  • Zeitwerk::Loader#reload
  • Zeitwerk::Loader#eager_load
  • Zeitwerk::Loader#load_file
  • Zeitwerk::Loader#nsfile=
  • Zeitwerk::ConstAdded#const_added
  • Zeitwerk::Error
  • Zeitwerk::ReloadingDisabledError
  • Zeitwerk::SetupRequired
  • Zeitwerk::ConflictingNamespaceDefinitionError
Environment
ruby
Created
2026-08-16T17:17:19Z

Contract

  1. assert assigning a non-module object in an explicit namespace file immediately raises Zeitwerk::Error from const_added during autoload, escaping rescue NameError and rescue TypeError
  2. assert push_dir rejects Symbol and String namespace arguments with Zeitwerk::Error rather than TypeError or ArgumentError
  3. assert push_dir rejects anonymous modules with Zeitwerk::Error stating root namespaces cannot be anonymous
  4. assert calling reload without enabling reloading raises Zeitwerk::ReloadingDisabledError while calling enable_reloading after setup raises base Zeitwerk::Error
  5. assert calling eager_load before setup raises Zeitwerk::SetupRequired rather than RuntimeError or ArgumentError
  6. assert load_file normalizes missing files, non-Ruby files, ignored files, hidden files, and unmanaged files to Zeitwerk::Error instead of LoadError or Errno::ENOENT
  7. assert conflicting explicit namespace file and nsfile definitions raise Zeitwerk::ConflictingNamespaceDefinitionError identifying both file paths

Files

  • Gemfile
  • Gemfile.lock
  • NOTES.md
  • csx.json
  • src/error_paths.rb
  • src/trees/anonymous_ns/dummy.rb
  • src/trees/conflicting_ns/accounts.rb
  • src/trees/conflicting_ns/accounts/ns.rb
  • src/trees/eager_unsetup/dummy.rb
  • src/trees/file_inputs/.hidden.rb
  • src/trees/file_inputs/doc.txt
  • src/trees/file_inputs/entry.rb
  • src/trees/file_inputs/ignored.rb
  • src/trees/invalid_namespace/router.rb
  • src/trees/invalid_namespace/router/route.rb
  • src/trees/non_module_ns/dummy.rb
  • src/trees/reloading/item.rb
  • test/contract.rb

Download the source artifact (tar.gz)

Origin Seeder

csx-seed