iev 0.4.4 → 0.4.6

data/lib/iev.rb

@@ -1,14 +1,10 @@
 # frozen_string_literal: true
 
 require "iev/version"
-require "iev/config"
-require "iev/data_source"
-
-require "yaml"
 
 # plurimath and unitsml both depend on mml, which has a transitive
 # dependency version mismatch with lutaml-model in some environments.
-# Load them when available; the DataSource APIs work without them.
+# Load them when available; the DataSource/Db APIs work without them.
 begin
   require "plurimath"
 rescue LoadError
@@ -22,6 +18,9 @@ rescue LoadError
 end
 
 module Iev
+  # IEV dataset URN — single source of truth for all concept references.
+  IEV_SOURCE = "urn:iec:std:iec:60050"
+
   autoload :Cli, "iev/cli"
   autoload :Config, "iev/config"
   autoload :Converter, "iev/converter"
@@ -29,11 +28,14 @@ module Iev
   autoload :DataSource, "iev/data_source"
   autoload :DbWriter, "iev/db_writer"
   autoload :Exporter, "iev/exporter"
+  autoload :IevCode, "iev/iev_code"
   autoload :Iso639Code, "iev/iso_639_code"
   autoload :Profiler, "iev/profiler"
   autoload :RelatonDb, "iev/relaton_db"
   autoload :Scraper, "iev/scraper"
+  autoload :Section, "iev/section"
   autoload :SourceParser, "iev/source_parser"
+  autoload :SubjectArea, "iev/subject_area"
   autoload :SubjectAreas, "iev/subject_areas"
   autoload :SubjectAreaConcepts, "iev/subject_area_concepts"
   autoload :SupersessionParser, "iev/supersession_parser"
@@ -41,6 +43,26 @@ module Iev
   autoload :TermBuilder, "iev/term_builder"
   autoload :Utilities, "iev/utilities"
 
+  # --- Configuration ---
+
+  # @return [Config]
+  def self.config
+    @config ||= Config.new
+  end
+
+  # Yield the config object for initialization.
+  # @yield [Config]
+  def self.configure
+    yield(config) if block_given?
+  end
+
+  # Reset config (useful in tests).
+  def self.reset_config!
+    @config = nil
+  end
+
+  # --- Data fetching ---
+
   # Fetch term designation from IEV data.
   #
   # @param [String] code for example "103-01-02"
@@ -48,7 +70,6 @@ module Iev
   #
   # @return [String, nil] if found then term,
   #   if code or language not found then nil.
-  #
   def self.get(code, lang)
     DataSource.fetch_term_designation(code, lang)
   rescue DataSource::NotFoundError
@@ -74,6 +95,8 @@ module Iev
     DataSource.fetch_term(code, lang)
   end
 
+  # --- Scraping ---
+
   # Scrape concept data from Electropedia for a given IEV code.
   # Uses Ferrum (headless Chrome) to handle AWS WAF challenge.
   #
@@ -83,37 +106,46 @@ module Iev
     Scraper.new.fetch_concept(code)
   end
 
+  # --- Subject area / section queries ---
+
   # Return all IEV subject areas with their sections (from bundled data).
-  # @return [Array<Hash>]
+  # @return [Array<SubjectArea>]
   def self.subject_areas
     SubjectAreas.all
   end
 
   # Find a subject area by code.
   # @param code [String, Integer] e.g. "102"
-  # @return [Hash, nil]
+  # @return [SubjectArea, nil]
   def self.find_subject_area(code)
     SubjectAreas.find_area(code)
   end
 
   # Find a section by its section code.
   # @param section_code [String] e.g. "102-01"
-  # @return [Hash, nil]
+  # @return [Section, nil]
   def self.find_section(section_code)
     SubjectAreas.find_section(section_code)
   end
 
   # Return sections for a given area code.
   # @param code [String, Integer] e.g. "102"
-  # @return [Array<Hash>]
+  # @return [Array<Section>]
   def self.sections_for(code)
     SubjectAreas.sections_for(code)
   end
 
   # Return the parent subject area for a given section code.
   # @param section_code [String] e.g. "102-01"
-  # @return [Hash, nil]
+  # @return [SubjectArea, nil]
   def self.area_for_section(section_code)
     SubjectAreas.area_for_section(section_code)
   end
+
+  # Parse an IEV code into its structural components.
+  # @param code [String] e.g. "103-01-02"
+  # @return [IevCode, nil] nil if the code is blank
+  def self.parse_code(code)
+    IevCode.parse(code)
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iev
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.6
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-13 00:00:00.000000000 Z
+date: 2026-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: creek
@@ -24,34 +24,48 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: ferrum
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
 - !ruby/object:Gem::Dependency
   name: glossarist
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 2.8.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: 2.8.2
 - !ruby/object:Gem::Dependency
-  name: ferrum
+  name: lutaml-model
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: 0.8.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: 0.8.0
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -80,20 +94,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: lutaml-model
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.8.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.8.0
 - !ruby/object:Gem::Dependency
   name: relaton
   requirement: !ruby/object:Gem::Requirement
@@ -206,6 +206,7 @@ files:
 - lib/iev/data_source.rb
 - lib/iev/db_writer.rb
 - lib/iev/exporter.rb
+- lib/iev/iev_code.rb
 - lib/iev/iso_639_2.yaml
 - lib/iev/iso_639_code.rb
 - lib/iev/profiler.rb
@@ -213,7 +214,9 @@ files:
 - lib/iev/scraper.rb
 - lib/iev/scraper/browser.rb
 - lib/iev/scraper/page_parser.rb
+- lib/iev/section.rb
 - lib/iev/source_parser.rb
+- lib/iev/subject_area.rb
 - lib/iev/subject_area_concepts.rb
 - lib/iev/subject_areas.rb
 - lib/iev/supersession_parser.rb
@@ -224,7 +227,8 @@ files:
 homepage: https://github.com/glossarist/iev
 licenses:
 - BSD-2-Clause
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths: