sec_id 8.0.0 → 8.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 070e9688322c11aee220661a15bdc3a6feffeeda6a4d5859620e1e49ef948d0e
-  data.tar.gz: 218328185fb31b121fc9fa36cbb2f0d20d7f81542e41e0cab9a453b4e66f366a
+  metadata.gz: d50c9163daf21728a883a7c9ae03215677c655ef2c8590b917b58306ab31efb1
+  data.tar.gz: 2a9ad832edc6be71a8bb4659909d1adfc6740e804aea2acad909b8373575a017
 SHA512:
-  metadata.gz: 027535125c743f70d1748956f39530df76f9c537de9b2547d800c55e34ded2d8125c5a3b067edf16016c1aa88eca73ea7cb9567372f1a1875868549969fb620f
-  data.tar.gz: 8f3345512540d6a5bfd2edbe436a44948e5c4a45a87a7637462467642b4fcacb590c4f37f675c71d8a38bf8f96f054af9191c2ff84c8798bc0bceff8b8d4a295
+  metadata.gz: 4a6b95868dd3d59b5bc3d48f6e7ce4b44b50d1c24389906505e5708cf4b6add66b6facc667dfe72348203a9c5e0fe35be9ef57978ed9600a4bfe9f53f5a9658a
+  data.tar.gz: 7592379ce4c9915548aa4e732f2065f41d455e6099e37b3a0a1dfeb48e36b3552c6f4b01bd089d4e505f7e5b73be940b832f965a8c8cc7060ed10e67171ed88f

data/CHANGELOG.md

@@ -8,8 +8,23 @@ and [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
 
 ## [Unreleased]
 
+## [8.0.1] - 2026-10-30
+
+This patch release contains a breaking API change as an explicit exception to Semantic Versioning. The v7 bridge removal was scheduled for 8.0.0 but was omitted.
+
+### Removed
+
+- **BREAKING:** Remove deprecated instance methods `check_digit` and `calculate_check_digit`, and class methods `check_digit` and `has_check_digit?`. Use `checksum`, `calculate_checksum`, and `has_checksum?`.
+- **BREAKING:** Remove the `SecID::InvalidCheckDigitError` alias. Rescue `SecID::InvalidChecksumError` instead.
+- **BREAKING:** Remove the `:check_digit` key from `to_h`, `as_json`, and pattern matching. Use `:checksum`.
+- Remove the unused `SecID::Deprecation` warning helper and the bridge's RBS declarations.
+
 ## [8.0.0] - 2026-10-30
 
+Ruby 3.3 or later is now required. Dropping Ruby 3.2 support is the breaking change that requires this major release.
+
+The deprecated v7 check-digit methods, error alias, and component key remain available in 8.0.0.
+
 ### Added
 
 - Lefthook Git hooks for staged secret scanning, Ruby autocorrection, whitespace, commit messages, tests, types, and documentation coverage.
@@ -17,13 +32,12 @@ and [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
 
 ### Changed
 
+- **BREAKING:** Drop support for Ruby 3.2 and require Ruby 3.3 or later.
 - Reduce detector allocations by sorting candidate types once and stopping parsing at the first valid match. Unsupported input lengths no longer grow the detector cache.
 - Reduce LEI and IBAN checksum allocations by reusing decimal expansions and preserving IBAN numeric characters.
 - Reduce scanner allocations by sorting candidate types once, stopping at the first valid type, and reusing the validated instance.
 - Reduce temporary allocations in ISIN, CUSIP, CEI, and FIGI checksum calculations by processing ASCII bytes directly.
 - Refresh development dependencies, all four lockfiles, and GitHub Actions for frozen CI installs.
-
-- **BREAKING:** Minimum Ruby version raised from 3.2 to 3.3 (Ruby 3.2 reached EOL on 2026-03-31)
 - RBS: `SecID::CFI::AttributeSet#to_h` and `#as_json` are now typed `Hash[Symbol, Hash[Symbol, untyped]]` instead of `Hash[untyped, untyped]` (Steep 2.1 tuple inference)
 
 ## [7.1.1] - 2026-07-31
@@ -303,7 +317,8 @@ Gem metadata only: corrected the gemspec description and README wording. No libr
 
 - ISIN numbers support: `SecID::ISIN`
 
-[Unreleased]: https://github.com/svyatov/sec_id/compare/v8.0.0...HEAD
+[Unreleased]: https://github.com/svyatov/sec_id/compare/v8.0.1...HEAD
+[8.0.1]: https://github.com/svyatov/sec_id/compare/v8.0.0...v8.0.1
 [8.0.0]: https://github.com/svyatov/sec_id/compare/v7.1.1...v8.0.0
 [7.1.1]: https://github.com/svyatov/sec_id/compare/v7.1.0...v7.1.1
 [7.1.0]: https://github.com/svyatov/sec_id/compare/v7.0.0...v7.1.0

data/MIGRATION.md

@@ -1,4 +1,23 @@
-# Upgrading to SecID 7.0
+# Migration guide
+
+## Upgrading to SecID 8.0.1
+
+Version 8.0.1 removes the deprecated v7 bridge that remained in 8.0.0. This is an explicit exception to Semantic Versioning: the patch release contains a breaking API change.
+
+Replace these names before upgrading:
+
+| Removed | Replacement |
+|---|---|
+| Instance `check_digit` | `checksum` |
+| Instance `calculate_check_digit` | `calculate_checksum` |
+| Class `check_digit(id)` | `checksum(id)` |
+| Class `has_check_digit?` | `has_checksum?` |
+| `SecID::InvalidCheckDigitError` | `SecID::InvalidChecksumError` |
+| `:check_digit` in `to_h`, `as_json`, and pattern matching | `:checksum` |
+
+The `SecID::Deprecation` warning helper is also removed. The canonical checksum API, `restore`, `restore!`, and checksum calculations are unchanged.
+
+## Upgrading to SecID 7.0
 
 This guide covers all breaking changes when upgrading from SecID 6.x to 7.0. They are all one
 mechanical rename: the **check-digit** concept became **checksum** across the public API —
@@ -25,7 +44,7 @@ deprecation warnings changed.
 `restore` / `restore!` and the `Checkable` concern name are unchanged.
 
 **Bridge:** the old method names, the `InvalidCheckDigitError` constant, and the `:check_digit`
-components key all keep working through v7 (the methods warn on use); they are removed in v8.
+components key all keep working through v7 and 8.0.0 (the methods warn on use); they are removed in 8.0.1.
 **The one exception is the error code** — `:invalid_check_digit` flips hard to `:invalid_checksum`
 at v7 with no bridge, so an error-code matcher must be updated immediately.
 
@@ -56,7 +75,7 @@ SecID::ISIN.has_checksum?
 ```
 
 The old names still work through v7 but emit a deprecation warning on every call and are removed
-in v8. See step 6 to silence them if you cannot migrate every call site yet.
+in 8.0.1. See step 6 to silence them on older releases if you cannot migrate every call site yet.
 
 ### 3. Rename the rescued error class
 
@@ -70,7 +89,7 @@ rescue SecID::InvalidChecksumError => e
 
 `SecID::InvalidCheckDigitError` remains as a constant alias of `SecID::InvalidChecksumError`
 through v7 (it is the *same class object*, so `rescue` under either name catches the same error),
-and is removed in v8.
+and is removed in 8.0.1.
 
 The constant alias emits **no** deprecation warning at runtime (it is a plain constant, not a
 warned method), so `-W` output won't reveal your rescue sites — find them statically:
@@ -100,15 +119,15 @@ SecID.explain('US5949181040', types: [:isin])[:candidates].first[:errors]
 If you use the opt-in ActiveModel/Rails validator with `details: true`, the surfaced reason
 follows the same flip: an invalid checksum now reports `:invalid_checksum`.
 
-### 5. Migrate pattern matches and `to_h` readers before v8
+### 5. Migrate pattern matches and `to_h` readers before 8.0.1
 
 `components` (and therefore `to_h` and `deconstruct_keys`) carries **both** `:checksum` and the
 deprecated `:check_digit` key through v7, so existing pattern matches keep working. The
-`:check_digit` key is removed in v8 — migrate to `:checksum` before then.
+`:check_digit` key is removed in 8.0.1. Migrate to `:checksum` before then.
 
 ```ruby
 # Both work through v7, binding the same value:
-isin => { check_digit: }   # deprecated, removed in v8
+isin => { check_digit: }   # deprecated, removed in 8.0.1
 isin => { checksum: }      # canonical
 
 isin.to_h[:components]

data/README.md

@@ -52,6 +52,8 @@ A Ruby toolkit for securities identifiers: validate, parse, normalize, detect, c
 
 Ruby 3.3+ is required.
 
+Version 8.0.1 removes the deprecated check-digit aliases retained in 8.0.0. This patch release contains a breaking API change; see the [migration guide](MIGRATION.md#upgrading-to-secid-801).
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/sec_id/base.rb

@@ -95,14 +95,6 @@ module SecID
 
         @has_checksum = ancestors.include?(SecID::Checkable)
       end
-
-      # @deprecated Use {.has_checksum?}. Kept as a v7 bridge; removed in v8.
-      #
-      # @return [Boolean]
-      def has_check_digit?
-        SecID::Deprecation.warn(old: 'has_check_digit?', new: 'has_checksum?')
-        has_checksum?
-      end
     end
 
     # @api private
@@ -142,7 +134,7 @@ module SecID
         full_id: full_id,
         normalized: valid? ? normalized : nil,
         valid: valid?,
-        components: components_with_deprecation_bridge
+        components: components
       }
     end
 
@@ -165,7 +157,7 @@ module SecID
     #   in SecID::ISIN[country_code:, nsin:] then [country_code, nsin]
     #   in nil then :invalid
     #   end #=> ['US', '594918104']
-    def deconstruct_keys(_keys) = components_with_deprecation_bridge
+    def deconstruct_keys(_keys) = components
 
     protected
 
@@ -176,17 +168,6 @@ module SecID
 
     private
 
-    # Mirrors the canonical `:checksum` components key onto the deprecated `:check_digit`
-    # key for the v7 bridge, when a checksum is present. The mirror reads `:checksum`, so the
-    # deprecated `check_digit` reader never fires internally. Removed in v8 (revert `to_h` and
-    # `deconstruct_keys` to call `components` directly).
-    #
-    # @return [Hash] the parsed components, with `:check_digit` added when `:checksum` is present
-    def components_with_deprecation_bridge
-      parsed = components
-      parsed.key?(:checksum) ? parsed.merge(check_digit: parsed[:checksum]) : parsed
-    end
-
     # @return [Hash]
     def components
       {}

data/lib/sec_id/concerns/checkable.rb

@@ -87,16 +87,6 @@ module SecID
       def checksum(id)
         new(id).calculate_checksum
       end
-
-      # @deprecated Use {.checksum}. Kept as a v7 bridge; removed in v8.
-      #
-      # @param id [String] the identifier to calculate the checksum for
-      # @return [Integer, String] the calculated checksum
-      # @raise [InvalidFormatError] if the identifier format is invalid
-      def check_digit(id)
-        SecID::Deprecation.warn(old: 'check_digit', new: 'checksum')
-        checksum(id)
-      end
     end
 
     # Validates format and checksum.
@@ -138,23 +128,6 @@ module SecID
       "#{identifier}#{checksum&.to_s&.rjust(checksum_width, '0')}"
     end
 
-    # @deprecated Use {#checksum}. Kept as a v7 bridge; removed in v8.
-    #
-    # @return [Integer, String]
-    def check_digit
-      SecID::Deprecation.warn(old: 'check_digit', new: 'checksum')
-      checksum
-    end
-
-    # @deprecated Use {#calculate_checksum}. Kept as a v7 bridge; removed in v8.
-    #
-    # @return [Integer, String]
-    # @raise [InvalidFormatError] if the identifier format is invalid
-    def calculate_check_digit
-      SecID::Deprecation.warn(old: 'calculate_check_digit', new: 'calculate_checksum')
-      calculate_checksum
-    end
-
     private
 
     # CUSIP/CEI double the rightmost body character; FIGI starts one position left.

data/lib/sec_id/version.rb

@@ -2,5 +2,5 @@
 
 module SecID
   # Current gem version.
-  VERSION = '8.0.0'
+  VERSION = '8.0.1'
 end

data/lib/sec_id.rb

@@ -17,10 +17,6 @@ module SecID
   # Raised when the checksum does not match the calculated value.
   class InvalidChecksumError < Error; end
 
-  # @deprecated Use {InvalidChecksumError}. Kept as a v7 bridge (same class object,
-  #   so `rescue` under either name keeps working); removed in v8.
-  InvalidCheckDigitError = InvalidChecksumError
-
   # Raised for type-specific structural errors (invalid prefix, category, group, BBAN, or date).
   class InvalidStructureError < Error; end
 
@@ -233,7 +229,6 @@ module SecID
   end
 end
 
-require 'sec_id/deprecation'
 require 'sec_id/deep_freeze'
 require 'sec_id/errors'
 require 'sec_id/concerns/normalizable'

data/sig/sec_id/base.rbs

@@ -47,9 +47,6 @@ module SecID
     # module-level `SecID.suggest` can call it on any registered class object.
     def self.suggest: (SecID::input str) -> Array[Suggestion]
 
-    # @deprecated v7 bridge alias for `has_checksum?`; removed in v8.
-    def self.has_check_digit?: () -> bool
-
     def self.inherited: (singleton(Base) subclass) -> void
 
     def initialize: (SecID::input _sec_id_number) -> void
@@ -75,7 +72,6 @@ module SecID
 
     private
 
-    def components_with_deprecation_bridge: () -> Hash[Symbol, untyped]
     def components: () -> Hash[Symbol, untyped]
     def parse: (SecID::input sec_id_number) -> (::MatchData | ::Hash[Symbol, untyped])
 

data/sig/sec_id/cei.rbs

@@ -17,10 +17,6 @@ module SecID
     def initialize: (SecID::input cei) -> void
     def calculate_checksum: () -> Integer
     def self.checksum: (SecID::input id) -> Integer
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> Integer
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
 
     private

data/sig/sec_id/concerns/checkable.rbs

@@ -17,8 +17,6 @@ module SecID
       def restore!: (SecID::input id_without_checksum) -> Base
       def checksum: (SecID::input id) -> (Integer | String)
 
-      # @deprecated v7 bridge alias for `checksum`; removed in v8.
-      def check_digit: (SecID::input id) -> (Integer | String)
     end
 
     def valid?: () -> bool
@@ -27,12 +25,6 @@ module SecID
     def calculate_checksum: () -> (Integer | String)
     def to_s: () -> String
 
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def check_digit: () -> (Integer | String)?
-
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> (Integer | String)
-
     private
 
     # Readers are nilable before validation. The callers validate first; local

data/sig/sec_id/cusip.rbs

@@ -18,10 +18,6 @@ module SecID
     def to_pretty_s: () -> String?
     def calculate_checksum: () -> Integer
     def self.checksum: (SecID::input id) -> Integer
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> Integer
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
     def to_isin: (String country_code) -> ISIN
     def cins?: () -> bool

data/sig/sec_id/dti.rbs

@@ -17,10 +17,6 @@ module SecID
     def initialize: (SecID::input dti) -> void
     def calculate_checksum: () -> String
     def self.checksum: (SecID::input id) -> String
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> String
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> String
     private def self.generate_body: (Random random) -> String
 
     private

data/sig/sec_id/figi.rbs

@@ -19,10 +19,6 @@ module SecID
     def to_pretty_s: () -> String?
     def calculate_checksum: () -> Integer
     def self.checksum: (SecID::input id) -> Integer
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> Integer
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
 
     private

data/sig/sec_id/iban.rbs

@@ -28,10 +28,6 @@ module SecID
     def restore: () -> String
     def calculate_checksum: () -> Integer
     def self.checksum: (SecID::input id) -> Integer
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> Integer
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
     def valid_bban_format?: () -> bool
     def country_rule: () -> rule?

data/sig/sec_id/isin.rbs

@@ -21,10 +21,6 @@ module SecID
     def to_pretty_s: () -> String?
     def calculate_checksum: () -> Integer
     def self.checksum: (SecID::input id) -> Integer
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> Integer
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
     def to_cusip: () -> CUSIP
     def cgs?: () -> bool

data/sig/sec_id/lei.rbs

@@ -22,10 +22,6 @@ module SecID
     def to_pretty_s: () -> String?
     def calculate_checksum: () -> Integer
     def self.checksum: (SecID::input id) -> Integer
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> Integer
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
 
     private

data/sig/sec_id/sedol.rbs

@@ -21,10 +21,6 @@ module SecID
     def to_isin: (?String country_code) -> ISIN
     def calculate_checksum: () -> Integer
     def self.checksum: (SecID::input id) -> Integer
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> Integer
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
 
     private

data/sig/sec_id/upi.rbs

@@ -16,10 +16,6 @@ module SecID
     def initialize: (SecID::input upi) -> void
     def calculate_checksum: () -> String
     def self.checksum: (SecID::input id) -> String
-    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
-    def calculate_check_digit: () -> String
-    # @deprecated v7 bridge alias for `checksum`; removed in v8.
-    def self.check_digit: (SecID::input id) -> String
     private def self.generate_body: (Random random) -> String
 
     private

data/sig/sec_id.rbs

@@ -11,9 +11,6 @@ module SecID
   class InvalidChecksumError < Error
   end
 
-  # @deprecated v7 bridge constant alias for `InvalidChecksumError` (same class object); removed in v8.
-  InvalidCheckDigitError: singleton(InvalidChecksumError)
-
   # Raised for type-specific structural errors.
   class InvalidStructureError < Error
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sec_id
 version: !ruby/object:Gem::Version
-  version: 8.0.0
+  version: 8.0.1
 platform: ruby
 authors:
 - Leonid Svyatov
@@ -46,7 +46,6 @@ files:
 - lib/sec_id/concerns/validatable.rb
 - lib/sec_id/cusip.rb
 - lib/sec_id/deep_freeze.rb
-- lib/sec_id/deprecation.rb
 - lib/sec_id/detector.rb
 - lib/sec_id/dti.rb
 - lib/sec_id/errors.rb
@@ -85,7 +84,6 @@ files:
 - sig/sec_id/concerns/validatable.rbs
 - sig/sec_id/cusip.rbs
 - sig/sec_id/deep_freeze.rbs
-- sig/sec_id/deprecation.rbs
 - sig/sec_id/detector.rbs
 - sig/sec_id/dti.rbs
 - sig/sec_id/errors.rbs

data/lib/sec_id/deprecation.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-module SecID
-  # 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.
-  module Deprecation
-    # Emits a standardized deprecation warning for a renamed API name.
-    #
-    # @param old [String] the deprecated name
-    # @param new [String] the canonical replacement name
-    # @param removed_in [String] the version that removes the deprecated name
-    # @return [void]
-    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
-  end
-end

data/sig/sec_id/deprecation.rbs

@@ -1,6 +0,0 @@
-module SecID
-  # Emits standardized, silenceable deprecation warnings for the v7 → v8 rename bridge.
-  module Deprecation
-    def self.warn: (old: String, new: String, ?removed_in: String) -> void
-  end
-end