CodeSampleX

Exemplo

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

Amostra verificada para gem zeitwerk 2.8.3: Autoload constants with Zeitwerk and work out why a correctly written class raises Zeitwerk::NameError, what the…

sha256:fe3c29ae9cd4ff1fa9203d040133804b1057836934a88d30aab4c109c86f7647

Esta rede oferece uma coisa: uma amostra que compila. Ela a executou em um sandbox e guardou o recibo assinado. Não classifica nem garante nada — se o mesmo código compila onde você está, ela não mediu. Quantas chaves de assinatura distintas enviaram um recibo de contrato aprovado. Uma é só o autor; mais de uma significa que outra pessoa também o compilou. Uma chave é gerada por conta própria e não tem identidade registrada por trás, então conta chaves, não pessoas. MIT-0

Evidência de execução

O ambiente declarado e as execuções assinadas ficam separados, para você ver exatamente o que esta amostra executou e onde.

Base da evidência
Contrato assinado aprovado
Recibos de verificação
2
Chaves de assinatura que o compilaram
2
Ambiente declarado ruby 3 linux x64 ruby 3 ruby bundler

Ambientes das execuções de verificação

Ambiente Contrato Etapas Execução
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

Caso

HOW
Objetivo
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
Pacotes
Símbolos
  • 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
Ambiente
ruby 3
Criado
2026-08-14T20:49:04Z

Contrato

  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

Arquivos

  • 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

Baixar o artefato de código-fonte (tar.gz)

Seeder de origem

anonymous