unitsdb 2.2.1 → 2.2.4

data/lib/unitsdb.rb

@@ -3,51 +3,122 @@
 require "lutaml/model"
 
 module Unitsdb
-  autoload :Cli, "unitsdb/cli"
+  # All model constants are autoloaded from their respective files.
+  # Config.build_registry triggers `eager_load_models!` so the type
+  # registry is complete before iteration — otherwise autoload would
+  # leave unreferenced models (Scale, Qudt*, Ucum*) unregistered.
+
   autoload :Config, "unitsdb/config"
-  autoload :Commands, "unitsdb/commands"
-  autoload :Database, "unitsdb/database"
-  autoload :Dimension, "unitsdb/dimension"
-  autoload :DimensionDetails, "unitsdb/dimension_details"
-  autoload :DimensionReference, "unitsdb/dimension_reference"
-  autoload :Dimensions, "unitsdb/dimensions"
   autoload :Errors, "unitsdb/errors"
-  autoload :ExternalReference, "unitsdb/external_reference"
+  autoload :Utils, "unitsdb/utils"
+  autoload :Database, "unitsdb/database"
+
+  # Leaf models
   autoload :Identifier, "unitsdb/identifier"
   autoload :LocalizedString, "unitsdb/localized_string"
-  autoload :Prefix, "unitsdb/prefix"
+  autoload :SymbolPresentations, "unitsdb/symbol_presentations"
+  autoload :ScaleProperties, "unitsdb/scale_properties"
+
+  # Reference models
+  autoload :UnitReference, "unitsdb/unit_reference"
   autoload :PrefixReference, "unitsdb/prefix_reference"
+  autoload :QuantityReference, "unitsdb/quantity_reference"
+  autoload :DimensionReference, "unitsdb/dimension_reference"
+  autoload :UnitSystemReference, "unitsdb/unit_system_reference"
+  autoload :ScaleReference, "unitsdb/scale_reference"
+  autoload :ExternalReference, "unitsdb/external_reference"
+  autoload :RootUnitReference, "unitsdb/root_unit_reference"
+  autoload :SiDerivedBase, "unitsdb/si_derived_base"
+  autoload :DimensionDetails, "unitsdb/dimension_details"
+
+  # Entity models
+  autoload :Dimension, "unitsdb/dimension"
+  autoload :Prefix, "unitsdb/prefix"
+  autoload :UnitSystem, "unitsdb/unit_system"
+  autoload :Quantity, "unitsdb/quantity"
+  autoload :Scale, "unitsdb/scale"
+  autoload :Unit, "unitsdb/unit"
+
+  # Collection container models
+  autoload :Dimensions, "unitsdb/dimensions"
   autoload :Prefixes, "unitsdb/prefixes"
   autoload :Quantities, "unitsdb/quantities"
-  autoload :Quantity, "unitsdb/quantity"
-  autoload :QuantityReference, "unitsdb/quantity_reference"
+  autoload :Scales, "unitsdb/scales"
+  autoload :UnitSystems, "unitsdb/unit_systems"
+  autoload :Units, "unitsdb/units"
+
+  # QUDT vocabulary models — all defined in unitsdb/qudt.rb
   autoload :QudtUnit, "unitsdb/qudt"
   autoload :QudtQuantityKind, "unitsdb/qudt"
   autoload :QudtDimensionVector, "unitsdb/qudt"
   autoload :QudtSystemOfUnits, "unitsdb/qudt"
   autoload :QudtPrefix, "unitsdb/qudt"
   autoload :QudtVocabularies, "unitsdb/qudt"
-  autoload :RootUnitReference, "unitsdb/root_unit_reference"
-  autoload :Scale, "unitsdb/scale"
-  autoload :ScaleProperties, "unitsdb/scale_properties"
-  autoload :ScaleReference, "unitsdb/scale_reference"
-  autoload :Scales, "unitsdb/scales"
-  autoload :SiDerivedBase, "unitsdb/si_derived_base"
-  autoload :SymbolPresentations, "unitsdb/symbol_presentations"
+
+  # UCUM XML models — all defined in unitsdb/ucum.rb
   autoload :UcumBaseUnit, "unitsdb/ucum"
   autoload :UcumPrefixValue, "unitsdb/ucum"
   autoload :UcumPrefix, "unitsdb/ucum"
   autoload :UcumUnitValueFunction, "unitsdb/ucum"
   autoload :UcumUnitValue, "unitsdb/ucum"
   autoload :UcumUnit, "unitsdb/ucum"
+  autoload :UcumNamespace, "unitsdb/ucum"
   autoload :UcumFile, "unitsdb/ucum"
-  autoload :Unit, "unitsdb/unit"
-  autoload :UnitReference, "unitsdb/unit_reference"
-  autoload :UnitSystem, "unitsdb/unit_system"
-  autoload :UnitSystemReference, "unitsdb/unit_system_reference"
-  autoload :UnitSystems, "unitsdb/unit_systems"
-  autoload :Units, "unitsdb/units"
-  autoload :Utils, "unitsdb/utils"
+
+  # CLI and Commands pull in Thor, which doesn't run under Opal.
+  unless RUBY_ENGINE == "opal"
+    autoload :Cli, "unitsdb/cli"
+    autoload :Commands, "unitsdb/commands"
+  end
+
+  # Constants eagerly loaded so Lutaml::Model type registrations are
+  # complete before Config.build_registry iterates them. Listed
+  # explicitly so unreferenced models (Scale, Qudt*, Ucum*) still
+  # register themselves via their file-bottom `Config.register_model`
+  # calls.
+  MODELS = %i[
+    Identifier
+    LocalizedString
+    SymbolPresentations
+    ScaleProperties
+    UnitReference
+    PrefixReference
+    QuantityReference
+    DimensionReference
+    UnitSystemReference
+    ScaleReference
+    ExternalReference
+    RootUnitReference
+    SiDerivedBase
+    DimensionDetails
+    Dimension
+    Prefix
+    UnitSystem
+    Quantity
+    Scale
+    Unit
+    Dimensions
+    Prefixes
+    Quantities
+    Scales
+    UnitSystems
+    Units
+    Database
+    QudtUnit
+    QudtQuantityKind
+    QudtDimensionVector
+    QudtSystemOfUnits
+    QudtPrefix
+    QudtVocabularies
+    UcumBaseUnit
+    UcumPrefixValue
+    UcumPrefix
+    UcumUnitValueFunction
+    UcumUnitValue
+    UcumUnit
+    UcumNamespace
+    UcumFile
+  ].freeze
 
   class << self
     # Returns the path to the bundled data directory containing YAML files
@@ -56,12 +127,48 @@ module Unitsdb
     end
 
     # Returns a pre-loaded Database instance from the bundled data
-    def database
-      @database ||= Database.from_db(data_dir)
+    def database(context: Config.context_id)
+      context_id = context.to_sym
+      Config.ensure_default_context! if context_id == Config.context_id
+      klass = Config.resolve_type(:database, context: context_id)
+      databases[context_id] ||= klass.from_db(data_dir, context: context_id)
+    end
+
+    # Drop the memoized Database instances so the next `database` call
+    # reloads from disk. Specs use this between examples.
+    def reset_database_cache!
+      @databases = nil
+    end
+
+    # Force every autoloaded model to load AND register itself with
+    # Config. The per-file `Config.register_model(Class, id: :foo)`
+    # calls at file-bottom run the first time a model loads, but
+    # `Config.capture_state` / `restore_state` can wipe those entries
+    # between tests. Re-registering here makes the registry
+    # self-healing across snapshot/restore cycles.
+    def eager_load_models!
+      MODELS.each do |sym|
+        klass = const_get(sym)
+        next unless klass.is_a?(Class) && klass < ::Lutaml::Model::Serializable
+
+        Config.register_model(klass, id: model_id_for(klass))
+      end
     end
 
     private
 
+    def model_id_for(klass)
+      klass.name.split("::").last
+        .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+        .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+        .downcase
+        .to_sym
+    end
+
+    def databases
+      @databases ||= {}
+    end
+
     def gem_dir
       @gem_dir ||= File.dirname(__dir__)
     end

data/unitsdb.gemspec

@@ -34,6 +34,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "fuzzy_match"
+  spec.add_dependency "logger"
   spec.add_dependency "lutaml-model", "~> 0.8.0"
   spec.add_dependency "rdf", "~> 3.1"
   spec.add_dependency "rdf-turtle", "~> 3.1"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unitsdb
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.2.4
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 2026-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fuzzy_match
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: lutaml-model
   requirement: !ruby/object:Gem::Requirement
@@ -118,6 +132,7 @@ extra_rdoc_files: []
 files:
 - ".github/workflows/dependent-repos.json"
 - ".github/workflows/depenedent-gems.yml"
+- ".github/workflows/opal.yml"
 - ".github/workflows/rake.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
@@ -156,6 +171,7 @@ files:
 - lib/unitsdb/commands/check_si/si_matcher.rb
 - lib/unitsdb/commands/check_si/si_ttl_parser.rb
 - lib/unitsdb/commands/check_si/si_updater.rb
+- lib/unitsdb/commands/entity_presenter.rb
 - lib/unitsdb/commands/get.rb
 - lib/unitsdb/commands/normalize.rb
 - lib/unitsdb/commands/qudt.rb
@@ -167,6 +183,7 @@ files:
 - lib/unitsdb/commands/qudt/updater.rb
 - lib/unitsdb/commands/release.rb
 - lib/unitsdb/commands/search.rb
+- lib/unitsdb/commands/thor.rb
 - lib/unitsdb/commands/ucum.rb
 - lib/unitsdb/commands/ucum/check.rb
 - lib/unitsdb/commands/ucum/formatter.rb
@@ -182,6 +199,9 @@ files:
 - lib/unitsdb/commands/validate/ucum_references.rb
 - lib/unitsdb/config.rb
 - lib/unitsdb/database.rb
+- lib/unitsdb/database/loader.rb
+- lib/unitsdb/database/reference_validator.rb
+- lib/unitsdb/database/uniqueness_validator.rb
 - lib/unitsdb/dimension.rb
 - lib/unitsdb/dimension_details.rb
 - lib/unitsdb/dimension_reference.rb
@@ -190,6 +210,7 @@ files:
 - lib/unitsdb/external_reference.rb
 - lib/unitsdb/identifier.rb
 - lib/unitsdb/localized_string.rb
+- lib/unitsdb/opal.rb
 - lib/unitsdb/prefix.rb
 - lib/unitsdb/prefix_reference.rb
 - lib/unitsdb/prefixes.rb