unlocodes 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c49275437cb1ae79a0be87613f9c19d1fc3e55220eff15960a0e472f2142f706
-  data.tar.gz: 687ae112bbf72c14fdc636ed54470360fde096625b645e3b57afc3611bfeea84
+  metadata.gz: bdcf7832aa82394b568ce5aee3abc73c0ab626de0ad659370d2059a46ff51618
+  data.tar.gz: 90d0bd46c6568c49495a28c9fb384b157d84cc51d11b1f122de73c9152a5f29f
 SHA512:
-  metadata.gz: 548af19b13e7fe5d350556cb31f8afe7638327893eb18654a79cdccbde8c5b0dabdfa5f8b872fbfbfefe273fc22f570a83d8f3290e584c63f0f8b37e2a3b6c06
-  data.tar.gz: 278fd26249d2af1836f735b0007d57aab354b31f123db08d29d4855406ea0a7deb32b5108ea9c97aac30bf1097eabafe00d42edb6f6c615da83fa033025a0825
+  metadata.gz: aa8bde8252d008a32300ddea75681b8422fcbb5c042d861083b5836df04e5c1d30bb7e5ba8235d109bad6f043893f22441e51e8f8fb8cc936f0f980ef5732674
+  data.tar.gz: c19720ecc1157143488cd397f7fec4aeb956b136f0fb73e1ab58e722258ca190b55603428d64943e98da3cc61e57053f5fb5c3c647e0589dd9f475c274c38f13

data/README.adoc

@@ -75,8 +75,6 @@ registry = Unlocodes::Registry.load_file('path/to/custom.jsonld')
 registry = Unlocodes::Registry.from_entries([Unlocodes::Entry.new(code: 'CNSHA', ...)])
 ----
 
-NOTE: The module-level shortcuts `Unlocodes.find(...)`, `Unlocodes.where(...)`, etc. still work as of 0.2.0 but emit a deprecation warning and will be removed in 0.3.0. Migrate to holding your own `Registry` instance.
-
 === What's in an Entry
 
 Each `Unlocodes::Entry` exposes the fields the JSON-LD vocabulary populates:

data/lib/unlocodes/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Unlocodes
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/unlocodes.rb

@@ -12,28 +12,19 @@ require_relative 'unlocodes/version'
 # https://opensource.unicc.org/un/unece/uncefact/vocab-locode and distributed
 # by this gem as a bundled, offline JSON-LD representation.
 #
-# Each caller should construct and hold its own {Unlocodes::Registry}:
+# Each caller constructs and holds its own {Unlocodes::Registry}:
 #
 #   registry = Unlocodes::Registry.load_default
 #   registry.find('CNSHA')
 #
-# The module-level `Unlocodes.find` / `Unlocodes.where` / etc. shortcuts are
-# deprecated since 0.2.0 (they rely on a process-wide singleton). They still
-# work today but emit a `Kernel#warn` deprecation and will be removed in
-# 0.3.0.
-#
 # Which edition is bundled? See {.data_tag} (read from
 # `lib/unlocodes/data/SOURCE_TAG`).
 module Unlocodes
-  DEPRECATION_SUGGESTION = 'Use Unlocodes::Registry.load_default instead ' \
-                           '(or construct from a custom data source). ' \
-                           'Removal targeted for 0.3.0.'
-
   SOURCE_TAG_PATH = File.expand_path('unlocodes/data/SOURCE_TAG', __dir__)
 
   # The upstream UNCEFACT vocabulary tag bundled with this gem version
   # (e.g. "2025-1"). Read from `lib/unlocodes/data/SOURCE_TAG` at runtime.
-  # Pure function over a known file location — does not touch the registry.
+  # Pure function over a known file location — does not touch any registry.
   # @return [String, nil]
   def self.data_tag
     return @data_tag if defined?(@data_tag)
@@ -43,72 +34,6 @@ module Unlocodes
     nil
   end
 
-  class << self
-    # @deprecated Use `Unlocodes::Registry.load_default` and hold the
-    #   instance yourself. Removal targeted for 0.3.0.
-    def registry
-      warn "Unlocodes.registry is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      default_registry
-    end
-
-    # @deprecated Tests that swap the global registry should construct a
-    #   `Unlocodes::Registry` directly and inject it. Removal targeted for 0.3.0.
-    def reset_registry!
-      warn "Unlocodes.reset_registry! is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      @registry = nil
-    end
-
-    # @deprecated Forwarded to the global registry; construct your own and
-    #   call `registry.find(code)`. Removal targeted for 0.3.0.
-    def find(code)
-      warn "Unlocodes.find is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      default_registry.find(code)
-    end
-
-    # @deprecated Construct your own registry and call `registry.where(filters)`.
-    #   Removal targeted for 0.3.0.
-    def where(filters)
-      warn "Unlocodes.where is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      default_registry.where(filters)
-    end
-
-    # @deprecated Construct your own registry and call `registry.each`.
-    #   Removal targeted for 0.3.0.
-    def each(&)
-      warn "Unlocodes.each is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      default_registry.each(&)
-    end
-
-    # @deprecated Construct your own registry and call `registry.size`.
-    #   Removal targeted for 0.3.0.
-    def size
-      warn "Unlocodes.size is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      default_registry.size
-    end
-
-    # @deprecated Construct your own registry and call `registry.count`.
-    #   Removal targeted for 0.3.0.
-    def count
-      warn "Unlocodes.count is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      default_registry.count
-    end
-
-    # @deprecated Construct your own registry and call `registry.countries`.
-    #   Removal targeted for 0.3.0.
-    def countries
-      warn "Unlocodes.countries is deprecated. #{DEPRECATION_SUGGESTION}", category: :deprecated, uplevel: 1
-      default_registry.countries
-    end
-
-    private
-
-    # Internal memoised default registry. Used by the deprecated module-level
-    # shortcuts. Direct callers should construct their own Registry instead.
-    def default_registry
-      @default_registry ||= Registry.load_default
-    end
-  end
-
   autoload :Coordinates, 'unlocodes/coordinates'
   autoload :Entry, 'unlocodes/entry'
   autoload :Registry, 'unlocodes/registry'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: unlocodes
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ribose Inc.