unlocodes 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b94b2f3a3a7f5b4968db10f04c5dac3c3745c318025c81a09ed5f49e82f4727e
-  data.tar.gz: 61eeac2c2f2836b9abcd9fdce8b9142a217b0af48efe0abe4f5f374c9d2a931e
+  metadata.gz: a4c9de4b3b24e90847e45242a5199691e8d5284377e8f6476f6fb01b653a729d
+  data.tar.gz: 4903c23bdc9d3336471da5afc6ec1c0e1c711d75824ce822e6a089dbb54970b2
 SHA512:
-  metadata.gz: 0e2e189ebbdea9c82a990961b52b952f9b31826603a9ef99e2113f81cb868dc744e21b7ac1708d65acb63c51130c361a45183fa5354b3014d9563976c3f00522
-  data.tar.gz: 2924a2a74d14cb06dcdb5250e4adaa574812a52a16c0432cc11482519f0230e2473894f82ba879dada0f9bb69e6764d6cd85a936ce21258610938c1c10af889e
+  metadata.gz: 2938d6ba840b7b93731afd97081478dce93cbd5b82357eb56032a943c000728a9d484b9fec9a5deffaa30916b99ba4588d33add5ce64e9489cd671d9a2ad0994
+  data.tar.gz: 76333326f2218ed42eebe6c729b05609c3e14b874854c9171dac3260d022c521a52e23e4e290a26565432936a837f548b6ff1a464c064258059741ad2c9ada01

data/README.adoc

@@ -14,21 +14,21 @@ Add to your Gemfile:
 
 [source,ruby]
 ----
-gem 'unlocode'
+gem 'unlocodes'
 ----
 
 == Usage
 
 [source,ruby]
 ----
-require 'unlocode'
-
-Unlocode.find('CNSHA')                          # => #<Unlocode::Entry code="CNSHA" ...>
-Unlocode.find('NLRTM').functions.map(&:code)    # => ["B", "R", "T", "A", "P"]
-Unlocode.where(country: 'CN').count             # => 1670
-Unlocode.where(function: 'B').count             # => 17912  (sea ports)
-Unlocode.where(function: 'A').count             # => 9009   (airports)
-Unlocode.find('CNPDG').coordinates              # => #<Coordinates lat=31.2333 lon=121.5000>
+require 'unlocodes'
+
+Unlocodes.find('CNSHA')                          # => #<Unlocodes::Entry code="CNSHA" ...>
+Unlocodes.find('NLRTM').functions.map(&:code)    # => ["B", "R", "T", "A", "P"]
+Unlocodes.where(country: 'CN').count             # => 1670
+Unlocodes.where(function: 'B').count             # => 17912  (sea ports)
+Unlocodes.where(function: 'A').count             # => 9009   (airports)
+Unlocodes.find('CNPDG').coordinates              # => #<Coordinates lat=31.2333 lon=121.5000>
 ----
 
 === Function codes
@@ -53,16 +53,16 @@ Use the letters in `where(function: ...)`:
 
 [source,ruby]
 ----
-Unlocode.where(function: 'B').count             # sea ports
-Unlocode.where(function: %w[B A]).count         # entries that are both port and airport
+Unlocodes.where(function: 'B').count             # sea ports
+Unlocodes.where(function: %w[B A]).count         # entries that are both port and airport
 ----
 
 === Distances
 
 [source,ruby]
 ----
-shanghai = Unlocode.find('CNPDG').coordinates
-rotterdam = Unlocode.find('NLRTM').coordinates
+shanghai = Unlocodes.find('CNPDG').coordinates
+rotterdam = Unlocodes.find('NLRTM').coordinates
 shanghai.distance_to(rotterdam)                 # => 8922.0 (km, great-circle)
 ----
 

data/lib/{unlocode → unlocodes}/coordinates.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Unlocode
+module Unlocodes
   # Geographic coordinates (WGS-84) for a LOCODE entry.
   #
   # Parsed from the LOCODE coordinate string ("DDMM[H]DDDMM[H]" where H is one

data/lib/{unlocode → unlocodes}/data/fetcher.rb

@@ -4,7 +4,7 @@ require 'net/http'
 require 'uri'
 require 'fileutils'
 
-module Unlocode
+module Unlocodes
   module Data
     # Downloads the UNCEFACT UN/LOCODE vocabulary from the upstream GitLab
     # repository and stores it as `lib/unlocode/data/locode.jsonld`.

data/lib/{unlocode → unlocodes}/data.rb

@@ -3,8 +3,8 @@
 # Bundled UN/LOCODE dataset.
 #
 # `locode.jsonld` is populated by `rake unlocode:fetch` and is the source
-# loaded by `Unlocode::Registry.load_default`.
-module Unlocode
+# loaded by `Unlocodes::Registry.load_default`.
+module Unlocodes
   module Data
     autoload :Fetcher, "#{__dir__}/data/fetcher"
   end

data/lib/{unlocode → unlocodes}/entry.rb

@@ -5,7 +5,7 @@ require_relative 'status'
 require_relative 'function'
 require_relative 'coordinates'
 
-module Unlocode
+module Unlocodes
   # A single UN/LOCODE entry.
   #
   # Stores wire-level fields as `lutaml-model` attributes and exposes typed

data/lib/{unlocode → unlocodes}/function.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Unlocode
+module Unlocodes
   # UN/LOCODE function classifier.
   #
   # Single-letter codes identifying the transport function a LOCODE serves.

data/lib/{unlocode → unlocodes}/loader.rb

@@ -3,7 +3,7 @@
 require 'json'
 require_relative 'entry'
 
-module Unlocode
+module Unlocodes
   # Parses a UN/LOCODE JSON-LD vocabulary file into {Entry} instances.
   #
   # The UNCEFACT vocabulary (`vocab/unlocode.jsonld`) is a single JSON-LD
@@ -39,21 +39,21 @@ module Unlocode
     class << self
       # Load entries from a file path on disk.
       # @param path [String] absolute or relative path to a JSON-LD file
-      # @return [Array<Unlocode::Entry>]
+      # @return [Array<Unlocodes::Entry>]
       def load_file(path)
         load_json(File.read(path))
       end
 
       # Load entries from a JSON-LD string.
       # @param json [String] a JSON-LD document
-      # @return [Array<Unlocode::Entry>]
+      # @return [Array<Unlocodes::Entry>]
       def load_json(json)
         parse(JSON.parse(json, symbolize_names: false))
       end
 
       # Load entries from a pre-parsed JSON-LD hash.
       # @param data [Hash] parsed JSON-LD
-      # @return [Array<Unlocode::Entry>]
+      # @return [Array<Unlocodes::Entry>]
       def parse(data)
         extract_graph(data).filter_map { |node| build_entry(node) if unlocode_node?(node) }
       end

data/lib/{unlocode → unlocodes}/registry.rb

@@ -3,7 +3,7 @@
 require 'forwardable'
 require_relative 'loader'
 
-module Unlocode
+module Unlocodes
   # In-memory, lazily-indexed registry over a set of {Entry} instances.
   #
   # The default registry is loaded from the vendored dataset bundled with the
@@ -50,7 +50,7 @@ module Unlocode
       end
 
       # Build a registry from an existing list of entries.
-      # @param entries [Array<Unlocode::Entry>]
+      # @param entries [Array<Unlocodes::Entry>]
       # @return [Registry]
       def from_entries(entries)
         new(entries)
@@ -65,7 +65,7 @@ module Unlocode
 
     # Exact-code lookup.
     # @param code [String] 5-char LOCODE (case-insensitive)
-    # @return [Unlocode::Entry, nil]
+    # @return [Unlocodes::Entry, nil]
     def find(code)
       return nil if code.nil?
 
@@ -83,7 +83,7 @@ module Unlocode
     #   registry.where(country: %w[CN HK], function: 'B')
     #   registry.where(name: /shanghai/i)
     #
-    # @return [Array<Unlocode::Entry>]
+    # @return [Array<Unlocodes::Entry>]
     def where(filters)
       filters.reduce(entries) { |scope, (key, value)| apply_filter(scope, key, value) }
     end

data/lib/{unlocode → unlocodes}/status.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Unlocode
+module Unlocodes
   # UN/LOCODE status (change indicator).
   #
   # Two-letter codes documenting how a LOCODE entry was last amended relative

data/lib/unlocodes/version.rb

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

data/lib/{unlocode.rb → unlocodes.rb}

@@ -4,19 +4,19 @@ require 'forwardable'
 require 'lutaml/model'
 require 'json'
 
-require_relative 'unlocode/version'
+require_relative 'unlocodes/version'
 
 # Vendored UN/LOCODE dataset as a queryable Ruby registry.
 #
 # The dataset is sourced from the UNECE/UNCEFACT LOCODE vocabulary published at
 # https://service.unece.org/trade/locode/ and distributed by this gem as a
 # bundled, offline JSON-LD representation. The registry loads once per process
-# and exposes a typed query API over `Unlocode::Entry` instances.
-module Unlocode
+# and exposes a typed query API over `Unlocodes::Entry` instances.
+module Unlocodes
   extend SingleForwardable
 
   class << self
-    # @return [Unlocode::Registry] the process-wide registry, loaded lazily
+    # @return [Unlocodes::Registry] the process-wide registry, loaded lazily
     def registry
       @registry ||= Registry.load_default
     end
@@ -29,11 +29,11 @@ module Unlocode
 
   def_delegators :registry, :find, :where, :each, :size, :count, :countries
 
-  autoload :Status, 'unlocode/status'
-  autoload :Function, 'unlocode/function'
-  autoload :Coordinates, 'unlocode/coordinates'
-  autoload :Entry, 'unlocode/entry'
-  autoload :Loader, 'unlocode/loader'
-  autoload :Registry, 'unlocode/registry'
-  autoload :Data, 'unlocode/data'
+  autoload :Status, 'unlocodes/status'
+  autoload :Function, 'unlocodes/function'
+  autoload :Coordinates, 'unlocodes/coordinates'
+  autoload :Entry, 'unlocodes/entry'
+  autoload :Loader, 'unlocodes/loader'
+  autoload :Registry, 'unlocodes/registry'
+  autoload :Data, 'unlocodes/data'
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unlocodes
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - Ribose Inc.
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -50,18 +51,18 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.adoc
-- lib/unlocode.rb
-- lib/unlocode/coordinates.rb
-- lib/unlocode/data.rb
-- lib/unlocode/data/README.adoc
-- lib/unlocode/data/fetcher.rb
-- lib/unlocode/data/locode.jsonld
-- lib/unlocode/entry.rb
-- lib/unlocode/function.rb
-- lib/unlocode/loader.rb
-- lib/unlocode/registry.rb
-- lib/unlocode/status.rb
-- lib/unlocode/version.rb
+- lib/unlocodes.rb
+- lib/unlocodes/coordinates.rb
+- lib/unlocodes/data.rb
+- lib/unlocodes/data/README.adoc
+- lib/unlocodes/data/fetcher.rb
+- lib/unlocodes/data/locode.jsonld
+- lib/unlocodes/entry.rb
+- lib/unlocodes/function.rb
+- lib/unlocodes/loader.rb
+- lib/unlocodes/registry.rb
+- lib/unlocodes/status.rb
+- lib/unlocodes/version.rb
 homepage: https://github.com/metanorma/unlocode
 licenses:
 - BSD-2-Clause
@@ -70,6 +71,7 @@ metadata:
   source_code_uri: https://github.com/metanorma/unlocode
   bug_tracker_uri: https://github.com/metanorma/unlocode/issues
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -84,7 +86,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: UN/LOCODE dataset as a queryable Ruby registry
 test_files: []

data/lib/unlocode/version.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-module Unlocode
-  VERSION = '0.1.0'
-end