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 and…

sha256:fe3c29ae9cd4ff1fa9203d040133804b1057836934a88d30aab4c109c86f7647

本网络只提供一件事：能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建，它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者；大于 1 表示还有其他人构建过。密钥是自行生成的，背后没有注册身份，因此计的是密钥而非人。 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