Пример
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…
sha256:fe3c29ae9cd4ff1fa9203d040133804b1057836934a88d30aab4c109c86f7647
Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла.
Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди.
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
Контракт
- 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
- assert Zeitwerk::Inflector#camelize is plain underscore camelization, so http_client.rb owes HttpClient and not HTTPClient, with no special case for acronyms
- 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
- 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
- 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
- assert an inflector override replaces the derived name outright so APIGateway autoloads, ApiGateway is never registered, and eager_load then passes
- assert a file that defines no constant at all fails with the same Zeitwerk::NameError after its body has already run
- 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
- assert all_expected_cpaths returns the whole path to expected constant map for the tree in one call without loading anything
- 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
- 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