unitsdb 2.2.6 → 2.2.7

data/data/dimensions.yaml

@@ -1862,3 +1862,13 @@ dimensions:
     authority: qudt
     uri: http://qudt.org/vocab/dimensionvector/A0E0L-2I0M0H0T0D0
   short: fuel_efficiency
+- identifiers:
+  - type: unitsml
+    id: d:currency
+  currency:
+    power: 1
+    symbol: C
+  names:
+  - value: currency
+    lang: en
+  short: currency

data/data/quantities.yaml

@@ -3713,3 +3713,14 @@ quantities:
     authority: qudt
     uri: http://qudt.org/vocab/quantitykind/RadialDistance
   short: radial_distance
+- dimension_reference:
+    type: unitsml
+    id: d:currency
+  identifiers:
+  - type: unitsml
+    id: q:monetary_value
+  names:
+  - value: monetary value
+    lang: en
+  quantity_type: base
+  short: monetary_value

data/data/schemas/currencies-schema.yaml

@@ -0,0 +1,111 @@
+# yaml-language-server: $schema=http://json-schema.org/draft-06/schema
+---
+$schema: "http://json-schema.org/draft-06/schema#"
+$id: "https://unitsml.org/schemas/currencies-schema.yaml"
+title: "Currencies Database Schema"
+description: "Schema for currencies.yaml - ISO 4217 currency codes as first-class entities"
+
+type: object
+required: ["schema_version", "currencies"]
+properties:
+  schema_version:
+    type: string
+    pattern: "^\\d+\\.\\d+\\.\\d+$"
+    description: "Semantic version of the schema"
+  currencies:
+    type: array
+    description: "Array of currency definitions"
+    items:
+      $ref: "#/definitions/Currency"
+
+definitions:
+  Currency:
+    type: object
+    required: ["identifiers", "names", "minor_unit_exponent", "status", "unit_system_reference", "quantity_references"]
+    properties:
+      identifiers:
+        type: array
+        description: "External identifiers for this currency (iso4217 + unitsml cur:)"
+        items:
+          $ref: "#/definitions/Identifier"
+      names:
+        type: array
+        description: "Multilingual names for this currency"
+        items:
+          $ref: "#/definitions/Name"
+      symbols:
+        type: array
+        description: "Symbol presentations (e.g. EUR carries the euro sign); the ascii form is always the ISO code"
+        items:
+          $ref: "#/definitions/SymbolPresentation"
+      minor_unit_exponent:
+        type: integer
+        minimum: 0
+        maximum: 4
+        description: "Decimal exponent of the minor unit (2 = cents, 0 = JPY/KRW class, 3 = BHD/KWD class, 4 = CLF class)"
+      status:
+        type: string
+        enum: ["active", "historic"]
+        description: "Whether the code is in the current ISO 4217 active list or withdrawn"
+      unit_system_reference:
+        type: array
+        description: "The ISO 4217 code list"
+        items:
+          $ref: "#/definitions/Reference"
+      quantity_references:
+        type: array
+        description: "The monetary-value quantity this currency denominates"
+        items:
+          $ref: "#/definitions/Reference"
+      notes:
+        type: string
+        description: "Provenance note for special codes (metals, funds, test/no-currency)"
+
+  Identifier:
+    type: object
+    required: ["type", "id"]
+    properties:
+      type:
+        type: string
+        enum: ["iso4217", "iso4217_numeric", "unitsml"]
+        description: "Type of identifier system"
+      id:
+        type: string
+        description: "Identifier value within the system (unitsml ids are cur:-prefixed; iso4217_numeric ids are the three-digit ISO numbers)"
+
+  Name:
+    type: object
+    required: ["value", "lang"]
+    properties:
+      value:
+        type: string
+        description: "Name in the specified language"
+      lang:
+        type: string
+        pattern: "^[a-z]{2}(-[A-Z]{2})?$"
+        description: "Language code (ISO 639-1, optionally with ISO 3166-1 country)"
+
+  SymbolPresentation:
+    type: object
+    required: ["unicode", "ascii", "id"]
+    properties:
+      unicode:
+        type: string
+        description: "Unicode symbol presentation"
+      ascii:
+        type: string
+        description: "ASCII presentation (the ISO code)"
+      id:
+        type: string
+        description: "Stable symbol id"
+
+  Reference:
+    type: object
+    required: ["type", "id"]
+    properties:
+      type:
+        type: string
+        description: "Type of the referenced entity"
+      id:
+        type: string
+        description: "Identifier of the referenced entity"

data/data/schemas/dimensions-schema.yaml

@@ -63,6 +63,9 @@ definitions:
       plane_angle:
         $ref: "#/definitions/DimensionComponent"
         description: "Plane angle dimension component"
+      currency:
+        $ref: "#/definitions/DimensionComponent"
+        description: "Currency dimension component (ISO 4217 monetary values)"
       references:
         type: array
         description: "External references and citations"

data/data/schemas/quantities-schema.yaml

@@ -79,7 +79,7 @@ definitions:
     properties:
       type:
         type: string
-        const: "nist"
+        enum: ["nist", "unitsml"]
         description: "Reference type indicator"
       id:
         type: string

data/data/schemas/unit_systems-schema.yaml

@@ -106,7 +106,7 @@ definitions:
       authority:
         type: string
         description: "Authoritative body or organization"
-        enum: ["si-digital-framework", "qudt", "ucum", "nist"]
+        enum: ["si-digital-framework", "qudt", "ucum", "nist", "iso"]
       uri:
         type: string
         format: "uri"

data/data/unit_systems.yaml

@@ -76,3 +76,15 @@ unit_systems:
   - value: non-SI and not acceptable
     lang: en
   short: nonsi-unacceptable
+- acceptable: false
+  identifiers:
+  - type: unitsml
+    id: us:iso-4217
+  names:
+  - value: ISO 4217 currency codes
+    lang: en
+  references:
+  - type: normative
+    authority: iso
+    uri: https://www.iso.org/iso-4217-currency-codes.html
+  short: iso-4217

data/lib/unitsdb/commands/entity_presenter.rb

@@ -26,9 +26,9 @@ module Unitsdb
 
       # Best-effort display name: first localized name value → short → "N/A".
       def display_name
-        name = @entity.names.first
+        name = @entity.names&.first
         return name.value.to_s if name&.value
-        return @entity.short.to_s if @entity.short
+        return entity_short.to_s if entity_short
 
         "N/A"
       end
@@ -38,7 +38,7 @@ module Unitsdb
         puts "Entity details:"
         puts "  - Type: #{type_name}"
         puts "  - Name: #{display_name}"
-        puts "  - Description: #{@entity.short}" if show_short?
+        puts "  - Description: #{entity_short}" if show_short?
         print_identifiers(header: "  - Identifiers:", item_indent: "      ")
         print_extras
         print_references
@@ -48,14 +48,20 @@ module Unitsdb
       def print_summary
         puts "  - #{type_name}: #{display_name}"
         print_identifiers(header: "    IDs:", item_indent: "      ")
-        puts "    Description: #{@entity.short}" if show_short?
+        puts "    Description: #{entity_short}" if show_short?
         puts ""
       end
 
       private
 
       def show_short?
-        @entity.short && @entity.short != display_name
+        entity_short && entity_short != display_name
+      end
+
+      # `short` is a UnitsDB description field some entities (Currency)
+      # do not carry.
+      def entity_short
+        @entity.short if @entity.respond_to?(:short)
       end
 
       def print_identifiers(header:, item_indent:)
@@ -79,20 +85,24 @@ module Unitsdb
       end
 
       def print_unit_symbols
-        return unless @entity.symbols.any?
+        return unless @entity.symbols.to_a.any?
 
         puts "  - Symbols:"
         @entity.symbols.each { |s| puts "      - #{s}" }
       end
 
       def print_references
-        return unless @entity.references.any?
+        return unless entity_references.to_a.any?
 
         puts "  - References:"
-        @entity.references.each do |ref|
+        entity_references.each do |ref|
           puts "      - #{ref.type}: #{ref.uri}"
         end
       end
+
+      def entity_references
+        @entity.references if @entity.respond_to?(:references)
+      end
     end
   end
 end

data/lib/unitsdb/commands/validate/qudt_references.rb

@@ -32,6 +32,8 @@ module Unitsdb
         def scan_collection(entities)
           by_uri = {}
           entities.each_with_index do |entity, index|
+            next unless entity.respond_to?(:references)
+
             refs = entity.references || []
             refs.each do |ref|
               next unless ref.authority == AUTHORITY

data/lib/unitsdb/currency.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Unitsdb
+  class Currency < Lutaml::Model::Serializable
+    attribute :identifiers, Identifier, collection: true
+    attribute :names, LocalizedString, collection: true
+    attribute :symbols, SymbolPresentations, collection: true
+    attribute :minor_unit_exponent, :integer
+    attribute :status, :string
+    attribute :unit_system_reference, UnitSystemReference, collection: true
+    attribute :quantity_references, QuantityReference, collection: true
+    attribute :notes, :string
+  end
+
+  Config.register_model(Currency, id: :currency)
+end

data/lib/unitsdb/database/loader.rb

@@ -10,7 +10,7 @@ module Unitsdb
     # Lutaml::Model deserialization. Knows nothing about contexts or
     # registers — that's `Database.from_db`'s job.
     class Loader
-      DATABASE_FILES = {
+      REQUIRED_DATABASE_FILES = {
         "prefixes" => "prefixes.yaml",
         "dimensions" => "dimensions.yaml",
         "units" => "units.yaml",
@@ -18,6 +18,15 @@ module Unitsdb
         "unit_systems" => "unit_systems.yaml",
       }.freeze
 
+      # Present in 2.0-era data onward; absent in older bundled data
+      # directories, which must keep loading. When present, the file
+      # participates in all validation like a required file.
+      OPTIONAL_DATABASE_FILES = {
+        "currencies" => "currencies.yaml",
+      }.freeze
+
+      DATABASE_FILES = REQUIRED_DATABASE_FILES.merge(OPTIONAL_DATABASE_FILES).freeze
+
       SUPPORTED_SCHEMA_VERSION = "2.0.0"
 
       def self.load(dir_path)
@@ -45,7 +54,7 @@ module Unitsdb
                 "Database directory not found: #{@dir_path}"
         end
 
-        missing = DATABASE_FILES.values.reject do |filename|
+        missing = REQUIRED_DATABASE_FILES.values.reject do |filename|
           File.exist?(File.join(@dir_path, filename))
         end
         return if missing.empty?
@@ -58,11 +67,13 @@ module Unitsdb
         if ENV["UNITSDB_DEBUG"]
           puts "[UnitsDB] Loading YAML files from directory: #{@dir_path}"
         end
-        DATABASE_FILES.transform_values do |filename|
+        DATABASE_FILES.filter_map do |collection_key, filename|
           path = File.join(@dir_path, filename)
+          next unless File.exist?(path)
+
           puts "  - #{path}" if ENV["UNITSDB_DEBUG"]
-          read_yaml(path, filename)
-        end
+          [collection_key, read_yaml(path, filename)]
+        end.to_h
       end
 
       def read_yaml(path, filename)
@@ -87,8 +98,8 @@ module Unitsdb
       end
 
       def validate_schema_versions!(documents)
-        versions = DATABASE_FILES.each_with_object({}) do |(collection_key, filename), result|
-          document = documents.fetch(collection_key)
+        versions = documents.each_with_object({}) do |(collection_key, document), result|
+          filename = DATABASE_FILES.fetch(collection_key)
           result[filename] = document.fetch("schema_version")
         rescue KeyError
           raise Errors::DatabaseFileInvalidError,
@@ -109,14 +120,17 @@ module Unitsdb
       end
 
       def build_database_hash(documents, schema_version)
-        {
+        hash = {
           "schema_version" => schema_version,
         }.merge(
-          DATABASE_FILES.keys.to_h do |collection_key|
-            document = documents.fetch(collection_key)
+          documents.to_h do |collection_key, document|
             [collection_key, fetch_collection!(document, collection_key)]
           end,
         )
+        # Absent optional collections normalize to empty arrays so
+        # Database accessors never return nil for legacy data dirs.
+        OPTIONAL_DATABASE_FILES.each_key { |key| hash[key] ||= [] }
+        hash
       end
 
       def fetch_collection!(document, collection_key)

data/lib/unitsdb/database.rb

@@ -11,6 +11,7 @@ module Unitsdb
     # Collections whose entities carry a `symbols` attribute.
     # Used by symbol-based search/match to narrow iteration.
     SYMBOL_COLLECTIONS = %i[units prefixes].freeze
+    SYMBOL_SEARCH_COLLECTIONS = (SYMBOL_COLLECTIONS + %i[currencies]).freeze
 
     attribute :schema_version, :string
     attribute :version, :string
@@ -19,6 +20,7 @@ module Unitsdb
     attribute :quantities, Quantity, collection: true
     attribute :dimensions, Dimension, collection: true
     attribute :unit_systems, UnitSystem, collection: true
+    attribute :currencies, Currency, collection: true
 
     # Resolve a collection name (String or Symbol) to its typed Array.
     # Validates against COLLECTIONS so caller-supplied names can never
@@ -54,7 +56,7 @@ module Unitsdb
       end
     end
 
-    # Find an entity by its specific identifier and type
+    # Find an entity by its identifier and type
     # @param id [String] the identifier value to search for
     # @param type [String, Symbol] the entity type (units, prefixes, quantities, etc.)
     # @return [Object, nil] the first entity with matching identifier or nil if not found
@@ -64,6 +66,34 @@ module Unitsdb
       end
     end
 
+    # Find a currency by its ISO 4217 alpha code (case-insensitive)
+    # @param code [String, Symbol] the alpha code (e.g. "EUR", :eur)
+    # @return [Currency, nil]
+    def find_by_code(code)
+      needle = code.to_s.upcase
+      currencies.find do |currency|
+        currency.identifiers.any? do |identifier|
+          identifier.type == "iso4217" && identifier.id == needle
+        end
+      end
+    end
+
+    # Find a currency by its ISO 4217 numeric identifier
+    # @param numeric [Integer, String] the numeric code (e.g. 978, "978")
+    # @return [Currency, nil]
+    def find_by_numeric(numeric)
+      # Base 10 explicitly: leading-zero codes ("036") are decimals, not
+      # octal.
+      needle = format("%03d", Integer(numeric.to_s, 10))
+      currencies.find do |currency|
+        currency.identifiers.any? do |identifier|
+          identifier.type == "iso4217_numeric" && identifier.id == needle
+        end
+      end
+    rescue ArgumentError
+      nil
+    end
+
     # Find an entity by its identifier id across all entity types
     # @param id [String] the identifier value to search for
     # @param type [String, nil] optional identifier type to match
@@ -103,23 +133,34 @@ module Unitsdb
 
     # Find entities by symbol
     # @param symbol [String] the symbol to search for (exact match, case-insensitive)
-    # @param entity_type [String, Symbol, nil] the entity type to search (units or prefixes)
+    # @param entity_type [String, Symbol, nil] the entity type to search
+    #   (units, prefixes, currencies)
     # @return [Array] entities with matching symbol
     def find_by_symbol(symbol, entity_type = nil)
       return [] unless symbol
 
       needle = symbol.downcase
-      scope = scope_for(entity_type, SYMBOL_COLLECTIONS)
+      scope = scope_for(entity_type, SYMBOL_SEARCH_COLLECTIONS)
 
       scope.each_with_object([]) do |name, results|
         collection(name).each do |entity|
-          results << entity if entity.symbols.any? do |sym|
-            sym.ascii.to_s.downcase == needle
+          results << entity if entity.symbols.to_a.any? do |sym|
+            symbol_match?(name, sym, symbol, needle)
           end
         end
       end
     end
 
+    # Currency symbols carry the sign in `unicode` (€, A$) and the alpha
+    # code in `ascii` (EUR, AUD); units and prefixes match on ascii only.
+    def symbol_match?(collection_name, sym, symbol, needle)
+      if collection_name == :currencies
+        sym.unicode.to_s == symbol || sym.ascii.to_s.downcase == needle
+      else
+        sym.ascii.to_s.downcase == needle
+      end
+    end
+
     # Match entities by name, short, or symbol with different match types
     # @param params [Hash] match parameters
     # @option params [String] :value The value to match against
@@ -175,11 +216,11 @@ module Unitsdb
     def matches_text?(entity, needle)
       entity.identifiers.any? { |i| i.id.to_s.downcase.include?(needle) } ||
         entity.names.any? { |n| n.value.to_s.downcase.include?(needle) } ||
-        entity.short.to_s.downcase.include?(needle)
+        (entity.respond_to?(:short) && entity.short.to_s.downcase.include?(needle))
     end
 
     def match_exact(entity, value, result)
-      if entity.short && entity.short.downcase == value.downcase
+      if entity.respond_to?(:short) && entity.short && entity.short.downcase == value.downcase
         result[:exact] << {
           entity: entity,
           match_desc: "short_to_name",

data/lib/unitsdb/dimension.rb

@@ -12,6 +12,7 @@ module Unitsdb
     attribute :amount_of_substance, DimensionDetails
     attribute :luminous_intensity, DimensionDetails
     attribute :plane_angle, DimensionDetails
+    attribute :currency, DimensionDetails
     attribute :short, :string
     attribute :names, LocalizedString, collection: true
     attribute :references, ExternalReference, collection: true

data/lib/unitsdb/opal.rb

@@ -26,6 +26,7 @@ require "unitsdb/si_derived_base"
 require "unitsdb/dimension_details"
 require "unitsdb/dimension"
 require "unitsdb/prefix"
+require "unitsdb/currency"
 require "unitsdb/unit_system"
 require "unitsdb/quantity"
 require "unitsdb/scale"

data/lib/unitsdb/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 module Unitsdb
-  VERSION = "2.2.6"
+  VERSION = "2.2.7"
 
   # The version of the bundled UnitsDB data (from the data/ submodule).
   # This version corresponds to a tag/commit in https://github.com/unitsml/unitsdb.
-  UNITS_DATA_VERSION = "2.0.0"
+  UNITS_DATA_VERSION = "2.0.1"
 end

data/lib/unitsdb.rb

@@ -34,6 +34,7 @@ module Unitsdb
   # Entity models
   autoload :Dimension, "unitsdb/dimension"
   autoload :Prefix, "unitsdb/prefix"
+  autoload :Currency, "unitsdb/currency"
   autoload :UnitSystem, "unitsdb/unit_system"
   autoload :Quantity, "unitsdb/quantity"
   autoload :Scale, "unitsdb/scale"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unitsdb
 version: !ruby/object:Gem::Version
-  version: 2.2.6
+  version: 2.2.7
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-18 00:00:00.000000000 Z
+date: 2026-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fuzzy_match
@@ -149,10 +149,12 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- data/currencies.yaml
 - data/dimensions.yaml
 - data/prefixes.yaml
 - data/quantities.yaml
 - data/scales.yaml
+- data/schemas/currencies-schema.yaml
 - data/schemas/dimensions-schema.yaml
 - data/schemas/prefixes-schema.yaml
 - data/schemas/quantities-schema.yaml
@@ -199,6 +201,7 @@ files:
 - lib/unitsdb/commands/validate/si_references.rb
 - lib/unitsdb/commands/validate/ucum_references.rb
 - lib/unitsdb/config.rb
+- lib/unitsdb/currency.rb
 - lib/unitsdb/database.rb
 - lib/unitsdb/database/loader.rb
 - lib/unitsdb/database/reference_validator.rb