CodeSampleX

Sample

zeitwerk 2.8.3: Collapse directory namespaces with Zeitwerk without recursively flattening nested subdirectories

Verified sample for gem zeitwerk 2.8.3: Collapse directory namespaces with Zeitwerk without recursively flattening nested subdirectories. The contract ran on…

sha256:f5e879ad7fff251e4014b28be48663de7b4514a83f5c057a70ea7fb6c2917dd6

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
Collapse directory namespaces with Zeitwerk without recursively flattening nested subdirectories
Packages
Symbols
  • Zeitwerk::Loader
  • Zeitwerk::Loader#collapse
  • Zeitwerk::Loader#push_dir
  • Zeitwerk::Loader#setup
  • Zeitwerk::Loader#all_expected_cpaths
  • Zeitwerk::Loader#ignore
Environment
ruby
Created
2026-08-17T01:22:20Z

Contract

  1. assert loader.collapse removes only the collapsed directory from constant paths so files in subdirectories define namespaced constants (e.g. concerns/oauth/token.rb defines Oauth::Token) rather than flattening the entire subtree into the parent namespace (Token)
  2. assert the collapsed directory name itself is never registered as an autoload or defined as a constant in the parent module, leaving Object.autoload?(:Concerns) nil and Object.const_defined?(:Concerns) false
  3. assert an uncollapsed directory registers the directory name as an autoloaded module namespace so concerns/archivable.rb defines Concerns::Archivable
  4. assert collapsing a directory nested within a namespace (admin/concerns) keeps the outer namespace intact so admin/concerns/auditable.rb defines Admin::Auditable and subdirectories define Admin::Audit::Trail
  5. assert loader.collapse supports glob patterns to collapse matching directories across multiple branches in a single call
  6. assert all_expected_cpaths maps collapsed directory paths directly to their parent namespace and files inside them to their un-prefixed constant names without loading any file
  7. assert loader.ignore completely excludes matching files from autoloads and all_expected_cpaths whereas loader.collapse preserves autoloading while stripping the directory level
  8. assert zeitwerk 2.8.3 is pure Ruby with no C extensions and no runtime dependencies

Files

  • Gemfile
  • Gemfile.lock
  • NOTES.md
  • csx.json
  • src/collapsing.rb
  • src/trees/audit_cpaths/concerns/authenticatable.rb
  • src/trees/audit_cpaths/concerns/helpers/formatting/text.rb
  • src/trees/audit_cpaths/concerns/oauth/token.rb
  • src/trees/audit_cpaths/user.rb
  • src/trees/collapsed_absent/concerns/present.rb
  • src/trees/collapsed_direct/concerns/authenticatable.rb
  • src/trees/collapsed_direct/concerns/helpers/formatting/text.rb
  • src/trees/collapsed_direct/concerns/oauth/token.rb
  • src/trees/collapsed_direct/user.rb
  • src/trees/glob_domains/controllers/concerns/responders.rb
  • src/trees/glob_domains/models/concerns/trackable.rb
  • src/trees/ignored_diff/concerns/active.rb
  • src/trees/ignored_diff/ignored_dir/scratch.rb
  • src/trees/nested_admin/admin/concerns/audit/trail.rb
  • src/trees/nested_admin/admin/concerns/auditable.rb
  • src/trees/nested_admin/admin/dashboard.rb
  • src/trees/uncollapsed_ns/concerns/archivable.rb
  • test/contract.rb

Download the source artifact (tar.gz)

Origin Seeder

csx-seed