Sample

Show that Zeitwerk reload support is opt-in before setup and that `unload` is intentionally ineffective until then.

sha256:2a90ce3c040d689d13a78f69612cc42ce3d1451ba0e44e9418dd497a657ab283

Case

Goal

Show that Zeitwerk reload support is opt-in before setup and that `unload` is intentionally ineffective until then. HOW

Packages

zeitwerk 2.8.3

Environment

ruby

Created

2026-08-17T02:49:45Z

Commonly assumed

Calling reload and unload-like operations is enough to refresh or remove constants, so explicit pre-setup reloading configuration should not matter.

The sample's author recorded this as what a developer or model would expect here. The contract below is what actually ran.

Contract

• assert a loader without `enable_reloading` raises `Zeitwerk::ReloadingDisabledError` on `reload` after `setup`, and then `unload` keeps a previously loaded constant in place
• assert enabling reloading after `setup` raises `Zeitwerk::Error` and leaves `reloading_enabled?` false
• assert enabling reloading before `setup` makes `unload` remove a loaded constant so that the next reference is a `NameError`

Files

• Gemfile
• Gemfile.lock
• NOTES.md
• csx.json
• fixtures/noreload/no_reload_widget.rb
• fixtures/reload_after/reload_after_widget.rb
• fixtures/reload_enabled/reload_enabled_widget.rb
• fixtures/reloadable/with_reload_widget.rb
• test/contract.rb

Download the verified artifact (tar.gz) — the exact bytes the contract ran against

Origin Seeder

csx-seed

Verification receipts

• ruby 3 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · rubygems@1 · 2026-08-17 · ed25519:d91480838ac982c9