Module: SecID::Deprecation

Defined in:
lib/sec_id/deprecation.rb

Overview

Emits standardized, silenceable deprecation warnings for the v7 → v8 rename bridge. Stateless: warns on every call with no per-call-site dedup, so the migration signal is never suppressed by default.

The warning is written via Kernel#warn at Ruby's default verbosity — it is visible unless the process runs with -W0 / $VERBOSE = nil. No category: is passed, because Warning[:deprecated] defaults to false and would hide the bridge warning the rename relies on.

Class Method Summary collapse

Class Method Details

.warn(old:, new:, removed_in: 'v8') ⇒ void

This method returns an undefined value.

Emits a standardized deprecation warning for a renamed API name.

Parameters:

  • old (String) —

    the deprecated name

  • new (String) —

    the canonical replacement name

  • removed_in (String) (defaults to: 'v8') —

    the version that removes the deprecated name



19
20
21
22
23
24
 
# File 'lib/sec_id/deprecation.rb', line 19

def self.warn(old:, new:, removed_in: 'v8')
  Kernel.warn(
    "SecID: `#{old}` is deprecated and will be removed in #{removed_in}; use `#{new}` instead.",
    uplevel: 2
  )
end