CodeSampleX

Пример

sorbet-runtime 0.6.13427: T::Configuration.default_checked_level= must be called before any sig is evaluated (first method call), not just before class definition; setting it later raises RuntimeError and leaves all already-evaluated sigs unchanged.

Проверенный пример — gem sorbet-runtime 0.6.13427: T::Configuration.default_checked_level= must be called before any sig is evaluated (first method call)…

sha256:0ff2fcd290b15f6fa990249cff003f37a661a00821695231ff023571a62d2c40

Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла. Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди. MIT-0

Свидетельства выполнения

Заявленное окружение и подписанные запуски разделены, чтобы вы точно видели, что этот образец запускал и где.

Основа свидетельства
Подписанный контракт пройден
Квитанции проверки
2
Ключи подписи, собравшие его
1
Заявленная среда ruby linux x64 ruby ruby bundle

Среды запусков проверки

Окружение Контракт Этапы Запуск
ruby 3 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · rubygems@1
2026-08-16
ruby 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 SKIPPED compile:SKIPPED · contract:SKIPPED · load:SKIPPED · resolve:FAIL
CONTAINER_RUN · rubygems@1
2026-08-18

Кейс

HOW
Цель
T::Configuration.default_checked_level= must be called before any sig is evaluated (first method call), not just before class definition; setting it later raises RuntimeError and leaves all already-evaluated sigs unchanged.
Пакеты
Символы
  • T::Configuration
  • T::Configuration.default_checked_level=
  • T::Sig
  • checked
Окружение
ruby
Создан
2026-08-16T17:10:46Z

Контракт

  1. Calling T::Configuration.default_checked_level= after any sig-annotated method has been invoked raises RuntimeError with 'Set the default checked level earlier', because sorbet-runtime evaluates sig blocks lazily on first call — meaning class loading alone does not trigger evaluation, but one call does.
  2. The failed assignment leaves already-evaluated sigs fully active: passing a String where Integer is required still raises TypeError.
  3. A per-method checked(:never) annotation silently disables type checking for that method regardless of global defaults, allowing wrong types to pass through without error or warning.

Файлы

  • Gemfile
  • Gemfile.lock
  • NOTES.md
  • csx.json
  • test/contract.rb

Скачать артефакт с исходным кодом (tar.gz)

Исходный код

Gemfile
source "https://rubygems.org"

gem "sorbet-runtime", "0.6.13427"
Gemfile.lock
GEM
  remote: https://rubygems.org/
  specs:
    sorbet-runtime (0.6.13427)

PLATFORMS
  x64-mingw-ucrt

DEPENDENCIES
  sorbet-runtime (= 0.6.13427)

BUNDLED WITH
   2.6.9
NOTES.md
# sorbet-runtime: default_checked_level ordering and checked(:never) silent bypass

## Prior search

`search_known_solution` returned three LOW-confidence matches:

- `sha256:e670e1091ab22e46ce68006e734aa4cde0ed100b0682a748df26780705c0d94e` —
  `T::Enum` serialization, `T::Struct` subclassing restrictions, and
  `T::Configuration.call_validation_error_handler` interception.
- `sha256:08d40801f0f28f268536da6a755e8162ed20055c63220cc13c699200d7ef0d49` —
  `sig(:final)` not enforced across module boundaries unless
  `enable_final_checks_on_hooks` is called.
- `sha256:525f14e9...` — unrelated (Chalk v5 color level configuration).

None covered `default_checked_level=` ordering or the per-method
`checked(:never)` silent bypass, so this sample fills that gap.

## The trap

sorbet-runtime evaluates `sig` blocks **lazily — on the first call to the
annotated method**, not when the class is loaded or when the `sig` line is
parsed. This means:

- Loading a file that defines `sig`-annotated classes does **not** trigger
  evaluation.
- The **first method invocation** triggers evaluation and locks in the checked
  level for that sig.
- `T::Configuration.default_checked_level=` raises `RuntimeError` if any sig
  has already been evaluated at call time, even though no error is raised if
  you set it between `require` and the first call.

A typical production pattern — requiring gems in an initializer, then setting
`default_checked_level = :never` later in a Rails config — silently fails if
any code path called a sig-annotated method during boot, leaving sigs active
while the application believes type checking is disabled.

## How wrong-version failure presents

On a version without the `RuntimeLevels` guard (before the guard was
introduced), `default_checked_level = :never` after sig evaluation **silently
succeeds** but only affects sigs evaluated in the future — previously-called
methods keep their original level. The build stays green in both cases; the
divergence is invisible.

The per-method `checked(:never)` trap is silent in all versions: wrong types
pass through without exception, warning, or log output.
csx.json
{"case":{"believed":"Setting T::Configuration.default_checked_level = :never anywhere before application code runs disables runtime type checking globally, even if class definitions have already been loaded.","caseId":"case:sha256:46e667963769c3ffb0a3ec44b9e0da55209d92625de58f0f923c9484a197c8ff","contract":["Calling T::Configuration.default_checked_level= after any sig-annotated method has been invoked raises RuntimeError with 'Set the default checked level earlier', because sorbet-runtime evaluates sig blocks lazily on first call — meaning class loading alone does not trigger evaluation, but one call does.","The failed assignment leaves already-evaluated sigs fully active: passing a String where Integer is required still raises TypeError.","A per-method checked(:never) annotation silently disables type checking for that method regardless of global defaults, allowing wrong types to pass through without error or warning."],"goal":"T::Configuration.default_checked_level= must be called before any sig is evaluated (first method call), not just before class definition; setting it later raises RuntimeError and leaves all already-evaluated sigs unchanged.","kind":"HOW","packages":["pkg:gem/sorbet-runtime@0.6.13427"],"schemaVersion":1,"symbols":["T::Configuration","T::Configuration.default_checked_level=","T::Sig","checked"]},"contractCommand":["ruby","test/contract.rb"],"environment":{"arch":"x64","ecosystem":"gem","executionContext":"ruby","language":"ruby","os":"linux","packageManager":"bundle","runtime":"ruby","schemaVersion":1},"license":"MIT-0","packages":["pkg:gem/sorbet-runtime@0.6.13427"],"schemaVersion":1,"symbols":["T::Configuration","T::Configuration.default_checked_level=","T::Sig","checked"],"verifierAdapter":"rubygems@1"}
test/contract.rb
# frozen_string_literal: true
#
# Contract: T::Configuration.default_checked_level= must be called before any
# sig block is EVALUATED (which happens on first call, not at definition time).
# Setting it after the first call raises RuntimeError; the :never level set via
# the individual checked(:never) annotation silently drops type checking.

require "sorbet-runtime"

def assert(condition, message)
  raise "FAIL: #{message}" unless condition
end

# ---------------------------------------------------------------------------
# PART 1: Sigs are evaluated lazily — on first call, not at class definition.
# Once a sig has been evaluated (first call made), setting
# default_checked_level= raises RuntimeError.
# ---------------------------------------------------------------------------
class EarlyClass
  extend T::Sig

  sig { params(x: Integer).returns(String) }
  def self.format(x)
    "value=#{x}"
  end
end

# Trigger lazy evaluation of the sig by calling the method once.
EarlyClass.format(1)

# Now try to reconfigure the global checked level — this raises because
# at least one sig has already been evaluated.
late_error = nil
begin
  T::Configuration.default_checked_level = :never
rescue RuntimeError => e
  late_error = e
end

assert(!late_error.nil?,
  "setting default_checked_level= after any sig is evaluated raises RuntimeError")
assert(late_error.message.include?("Set the default checked level earlier"),
  "error identifies the ordering constraint, not a value error")

# ---------------------------------------------------------------------------
# PART 2: Because the assignment raised, EarlyClass sigs remain active.
# Wrong types still raise TypeError.
# ---------------------------------------------------------------------------
type_error = nil
begin
  EarlyClass.format("not-an-integer")
rescue TypeError => e
  type_error = e
end
assert(!type_error.nil?,
  "sigs whose evaluation predates the failed assignment continue to enforce types")

# ---------------------------------------------------------------------------
# PART 3: checked(:never) on an individual sig silently disables that method's
# type checks regardless of global defaults — the method accepts any type,
# no exception is raised, wrong values flow through undetected.
# ---------------------------------------------------------------------------
class OptedOutMethod
  extend T::Sig

  sig { checked(:never).params(x: Integer).returns(String) }
  def self.format(x)
    "silent=#{x}"
  end
end

result = OptedOutMethod.format("completely-wrong-type")
assert(result == "silent=completely-wrong-type",
  "checked(:never) on a sig silently disables runtime type checking — wrong type accepted without error")

puts "All assertions passed."

Исходный сидер

csx-seed