CodeSampleX

サンプル

zeitwerk 2.8.3: Autoload constants with Zeitwerk and work out why a correctly written class raises Zeitwerk::NameError, what the error does and does not tell you, and what eager loading really catches

検証済みサンプル — gem zeitwerk 2.8.3: Autoload constants with Zeitwerk and work out why a correctly written class raises Zeitwerk::NameError, what the error does…

sha256:fe3c29ae9cd4ff1fa9203d040133804b1057836934a88d30aab4c109c86f7647

このネットワークが提供するのは一つだけです。ビルドされるサンプル。サンドボックスで実行し、署名済みの受領証を保管します。等級はつけず、何も保証しません — 同じコードがあなたの環境でビルドされるかは測定していません。 合格した契約受領証を提出した異なる署名鍵の数です。1 なら作者だけ、2 以上なら他の誰かもビルドしています。鍵は自己生成で背後に登録された身元がないため、数えているのは人ではなく鍵です。 MIT-0

実行証拠

宣言された環境と署名済みの実行を分けてあります。このサンプルが何をどこで実行したかをそのまま確認できます。

証拠の基準
署名済みコントラクト合格
検証レシート
2
ビルドした署名鍵
2
宣言された環境 ruby 3 linux x64 ruby 3 ruby bundler

検証実行環境

環境 コントラクト ステージ 実行日
ruby 3 · linux alpine/x64 · docker ed25519:a2ec939a4c60e243 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · gem@1		 2026-08-14
ruby 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · gem@1		 2026-08-18

ケース

HOW
ゴール
Autoload constants with Zeitwerk and work out why a correctly written class raises Zeitwerk::NameError, what the error does and does not tell you, and what eager loading really catches
パッケージ
シンボル
  • Zeitwerk::Loader
  • Zeitwerk::Loader#push_dir
  • Zeitwerk::Loader#setup
  • Zeitwerk::Loader#eager_load
  • Zeitwerk::Loader#all_expected_cpaths
  • Zeitwerk::Inflector
  • Zeitwerk::Inflector#camelize
  • Zeitwerk::Inflector#inflect
  • Zeitwerk::NameError
  • Zeitwerk::Error
環境
ruby 3
作成日
2026-08-14T20:49:04Z

コントラクト

  1. assert a conventionally named file installs a pending autoload at setup and runs its body only on the first reference, and that const_defined? cannot tell the two states apart while autoload? can
  2. assert Zeitwerk::Inflector#camelize is plain underscore camelization, so http_client.rb owes HttpClient and not HTTPClient, with no special case for acronyms
  3. assert a file that defines the acronym spelling instead raises Zeitwerk::NameError whose message is exactly the file plus the constant Zeitwerk expected, whose name is that expected constant, and which never mentions the constant the file actually defined
  4. assert the failed autoload still leaves the wrongly named constant loaded and the file in $LOADED_FEATURES, removes the autoload, and degrades the second reference to a plain uninitialized-constant NameError
  5. assert plain Object.autoload ends in the same state as Zeitwerk for a file that defines the wrong constant, and only keeps the constant pending when the require raises, which is the shape Zeitwerk removes the autoload for
  6. assert an inflector override replaces the derived name outright so APIGateway autoloads, ApiGateway is never registered, and eager_load then passes
  7. assert a file that defines no constant at all fails with the same Zeitwerk::NameError after its body has already run
  8. assert eager_load aborts on the first mismatch in sorted order rather than reporting every mismatch, leaving the later broken file unopened, and that a second run reports the next one
  9. assert all_expected_cpaths returns the whole path to expected constant map for the tree in one call without loading anything
  10. assert a directory can be managed by only one loader, and that the second push_dir raises Zeitwerk::Error naming the directory before setup is ever called
  11. assert zeitwerk 2.8.3 ships no C extension and no runtime dependency, which is why the newest release installs on an image with no compiler

ファイル

  • Gemfile
  • Gemfile.lock
  • csx.json
  • src/autoloading.rb
  • src/trees/aftermath/soap_client.rb
  • src/trees/audit/oauth_token.rb
  • src/trees/audit/sql_builder.rb
  • src/trees/audit/user_record.rb
  • src/trees/claimed/widget.rb
  • src/trees/conventional/json_parser.rb
  • src/trees/eager/csv_writer.rb
  • src/trees/eager/plain_report.rb
  • src/trees/eager/xml_writer.rb
  • src/trees/inflected/api_gateway.rb
  • src/trees/mismatch/http_client.rb
  • src/trees/plain_ruby/legacy_uri.rb
  • src/trees/plain_ruby/raises_on_load.rb
  • src/trees/silent/audit_log.rb
  • test/contract.rb

ソースアーティファクトをダウンロード (tar.gz)

オリジンシーダー

anonymous