unitsdb 1.0.0 → 2.0.1

data/exe/unitsdb

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "unitsdb"
+require "unitsdb/cli"
+
+Unitsdb::CLI.start(ARGV)

data/lib/unitsdb/cli.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require "thor"
+require_relative "commands/base"
+require_relative "commands/validate"
+require_relative "commands/_modify"
+require_relative "commands/ucum"
+require "fileutils"
+
+module Unitsdb
+  class CLI < Thor
+    # Fix Thor deprecation warning
+    def self.exit_on_failure?
+      true
+    end
+
+    desc "ucum SUBCOMMAND", "UCUM-related commands"
+    subcommand "ucum", Commands::UcumCommand
+
+    desc "_modify SUBCOMMAND", "Commands that modify the database"
+    subcommand "_modify", Commands::ModifyCommand
+
+    desc "validate SUBCOMMAND", "Validate database files for different conditions"
+    subcommand "validate", Commands::ValidateCommand
+
+    desc "search QUERY", "Search for entities containing the given text"
+    option :type, type: :string, aliases: "-t",
+                  desc: "Entity type to search (units, prefixes, quantities, dimensions, unit_systems)"
+    option :id, type: :string, aliases: "-i",
+                desc: "Search for an entity with a specific identifier"
+    option :id_type, type: :string,
+                     desc: "Filter get_by_id search by identifier type"
+    option :format, type: :string, default: "text",
+                    desc: "Output format (text, json, yaml)"
+    option :database, type: :string, required: true, aliases: "-d",
+                      desc: "Path to UnitsDB database (required)"
+
+    def search(query)
+      require_relative "commands/search"
+      Commands::Search.new(options).run(query)
+    end
+
+    desc "get ID", "Get detailed information about an entity by ID"
+    option :id_type, type: :string,
+                     desc: "Filter by identifier type"
+    option :format, type: :string, default: "text",
+                    desc: "Output format (text, json, yaml)"
+    option :database, type: :string, required: true, aliases: "-d",
+                      desc: "Path to UnitsDB database (required)"
+    def get(id)
+      require_relative "commands/get"
+      Commands::Get.new(options).get(id)
+    end
+
+    desc "check_si", "Check and update SI digital framework references in UnitsDB"
+    option :entity_type, type: :string, aliases: "-e",
+                         desc: "Entity type to check (units, quantities, or prefixes). If not specified, all types are checked"
+    option :ttl_dir, type: :string, required: true, aliases: "-t",
+                     desc: "Path to the directory containing SI digital framework TTL files"
+    option :output_updated_database, type: :string, aliases: "-o",
+                                     desc: "Directory path to write updated YAML files with added SI references"
+    option :direction, type: :string, default: "both", aliases: "-r",
+                       desc: "Direction to check: 'to_si' (UnitsDB→TTL), 'from_si' (TTL→UnitsDB), or 'both'"
+    option :include_potential_matches, type: :boolean, default: false, aliases: "-p",
+                                       desc: "Include potential matches when updating references (default: false)"
+    option :database, type: :string, required: true, aliases: "-d",
+                      desc: "Path to UnitsDB database (required)"
+
+    def check_si
+      require_relative "commands/check_si"
+      Commands::CheckSi.new(options).run
+    end
+
+    desc "release", "Create release files (unified YAML and/or ZIP archive)"
+    option :format, type: :string, default: "all", aliases: "-f",
+                    desc: "Output format: 'yaml' (single file), 'zip' (archive), or 'all' (both)"
+    option :output_dir, type: :string, default: ".", aliases: "-o",
+                        desc: "Directory to output release files"
+    option :version, type: :string, aliases: "-v", required: true,
+                     desc: "Version number for the release (x.y.z)"
+    option :database, type: :string, required: true, aliases: "-d",
+                      desc: "Path to UnitsDB database (required)"
+    def release
+      require_relative "commands/release"
+      Commands::Release.new(options).run
+    end
+  end
+end

data/lib/unitsdb/commands/_modify.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module Unitsdb
+  module Commands
+    class ModifyCommand < Thor
+      desc "normalize [INPUT] [OUTPUT]", "Normalize a YAML file or all YAML files with --all"
+      method_option :sort, type: :string, default: "nist",
+                           desc: "Sort units by: 'short' (name), 'nist' (ID, default), 'unitsml' (ID), or 'none'"
+      method_option :database, type: :string, required: true, aliases: "-d",
+                               desc: "Path to UnitsDB database (required)"
+      method_option :all, type: :boolean, default: false, aliases: "-a",
+                          desc: "Process all YAML files in the repository"
+
+      def normalize(input = nil, output = nil)
+        require_relative "normalize"
+        Normalize.new(options).run(input, output)
+      end
+    end
+  end
+end

data/lib/unitsdb/commands/base.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "fileutils"
+
+module Unitsdb
+  module Commands
+    class Base
+      def initialize(options = {})
+        @options = options
+        puts "Database directory path: #{@options[:database]}" if @options[:database]
+      end
+
+      protected
+
+      def load_database(path = nil)
+        path ||= @options[:database]
+        raise Unitsdb::Errors::DatabaseError, "Database path not specified" unless path
+
+        Unitsdb::Database.from_db(path)
+      rescue StandardError => e
+        raise Unitsdb::Errors::DatabaseError, "Failed to load database: #{e.message}"
+      end
+    end
+  end
+end

data/lib/unitsdb/commands/check_si.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require_relative "../database"
+require_relative "../errors"
+require_relative "si_ttl_parser"
+require_relative "si_formatter"
+require_relative "si_matcher"
+require_relative "si_updater"
+
+module Unitsdb
+  module Commands
+    class CheckSi < Base
+      # Constants
+      ENTITY_TYPES = %w[units quantities prefixes].freeze
+
+      def run
+        # Get options
+        entity_type = @options[:entity_type]&.downcase
+        direction = @options[:direction]&.downcase || "both"
+        output_dir = @options[:output_updated_database]
+        include_potential = @options[:include_potential_matches] || false
+        database_path = @options[:database]
+        ttl_dir = @options[:ttl_dir]
+
+        # Validate parameters
+        validate_parameters(direction, ttl_dir)
+
+        # Use the path as-is without expansion
+        puts "Using database directory: #{database_path}"
+
+        @db = Unitsdb::Database.from_db(database_path)
+
+        puts "Using TTL directory: #{ttl_dir}"
+        puts "Include potential matches: #{include_potential ? "Yes" : "No"}"
+
+        # Parse TTL files
+        graph = SiTtlParser.parse_ttl_files(ttl_dir)
+
+        # Process entity types
+        process_entities(entity_type, graph, direction, output_dir, include_potential)
+      end
+
+      private
+
+      # Process all entity types or a specific one
+      def process_entities(entity_type, graph, direction, output_dir, include_potential)
+        if entity_type && ENTITY_TYPES.include?(entity_type)
+          process_entity_type(entity_type, graph, direction, output_dir, include_potential)
+        else
+          ENTITY_TYPES.each do |type|
+            process_entity_type(type, graph, direction, output_dir, include_potential)
+          end
+        end
+      end
+
+      # Process a specific entity type
+      def process_entity_type(entity_type, graph, direction, output_dir, include_potential = false)
+        puts "\n========== Processing #{entity_type.upcase} References ==========\n"
+
+        db_entities = @db.send(entity_type)
+        ttl_entities = SiTtlParser.extract_entities_from_ttl(entity_type, graph)
+
+        puts "Found #{ttl_entities.size} #{entity_type} in SI digital framework"
+        puts "Found #{db_entities.size} #{entity_type} in database"
+
+        check_from_si(entity_type, ttl_entities, db_entities, output_dir, include_potential) if %w[from_si
+                                                                                                   both].include?(direction)
+
+        return unless %w[to_si both].include?(direction)
+
+        check_to_si(entity_type, ttl_entities, db_entities, output_dir, include_potential)
+      end
+
+      # Validation helpers
+      def validate_parameters(direction, ttl_dir)
+        unless %w[to_si from_si both].include?(direction)
+          puts "Invalid direction: #{direction}. Must be one of: to_si, from_si, both"
+          exit(1)
+        end
+
+        return if Dir.exist?(ttl_dir)
+
+        puts "TTL directory not found: #{ttl_dir}"
+        exit(1)
+      end
+
+      # Direction handler: TTL → DB
+      def check_from_si(entity_type, ttl_entities, db_entities, output_dir, include_potential = false)
+        SiFormatter.print_direction_header("SI → UnitsDB")
+
+        matches, missing_matches, unmatched_ttl = SiMatcher.match_ttl_to_db(entity_type, ttl_entities, db_entities)
+
+        # Print results
+        SiFormatter.display_si_results(entity_type, matches, missing_matches, unmatched_ttl)
+
+        # Update references if needed
+        return unless output_dir && !missing_matches.empty?
+
+        output_file = File.join(output_dir, "#{entity_type}.yaml")
+        SiUpdater.update_references(entity_type, missing_matches, db_entities, output_file, include_potential,
+                                    database_path)
+        puts "\nUpdated references written to #{output_file}"
+      end
+
+      # Direction handler: DB → TTL
+      def check_to_si(entity_type, ttl_entities, db_entities, output_dir, include_potential = false)
+        SiFormatter.print_direction_header("UnitsDB → SI")
+
+        matches, missing_refs, unmatched_db = SiMatcher.match_db_to_ttl(entity_type, ttl_entities, db_entities)
+
+        # Print results
+        SiFormatter.display_db_results(entity_type, matches, missing_refs, unmatched_db)
+
+        # Update references if needed
+        return unless output_dir && !missing_refs.empty?
+
+        output_file = File.join(output_dir, "#{entity_type}.yaml")
+        SiUpdater.update_db_references(entity_type, missing_refs, output_file, include_potential, @options[:database])
+        puts "\nUpdated references written to #{output_file}"
+      end
+    end
+  end
+end

data/lib/unitsdb/commands/get.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require "json"
+require_relative "../errors"
+
+module Unitsdb
+  module Commands
+    class Get < Base
+      def get(id)
+        # Database path is guaranteed by Thor's global option
+        id_type = @options[:id_type]
+        format = @options[:format] || "text"
+
+        begin
+          database = load_database(@options[:database])
+
+          # Search by ID
+          entity = database.get_by_id(id: id, type: id_type)
+
+          unless entity
+            puts "No entity found with ID: '#{id}'"
+            return
+          end
+
+          # Output based on format
+          if %w[json yaml].include?(format.downcase)
+            begin
+              puts entity.send("to_#{format.downcase}")
+              return
+            rescue NoMethodError
+              puts "Error: Unable to convert entity to #{format} format"
+              exit(1)
+            end
+          end
+
+          # Default text output
+          print_entity_details(entity)
+        rescue Unitsdb::Errors::DatabaseError => e
+          puts "Error: #{e.message}"
+          exit(1)
+        rescue StandardError => e
+          puts "Error searching database: #{e.message}"
+          exit(1)
+        end
+      end
+
+      private
+
+      def print_entity_details(entity)
+        # Determine entity type
+        entity_type = get_entity_type(entity)
+
+        # Get name
+        name = get_entity_name(entity)
+
+        puts "Entity details:"
+        puts "  - Type: #{entity_type}"
+        puts "  - Name: #{name}"
+
+        # Print description if available
+        puts "  - Description: #{entity.short}" if entity.respond_to?(:short) && entity.short && entity.short != name
+
+        # Print all identifiers
+        if entity.identifiers&.any?
+          puts "  - Identifiers:"
+          entity.identifiers.each do |id|
+            puts "      - #{id.id} (Type: #{id.type || "N/A"})"
+          end
+        else
+          puts "  - Identifiers: None"
+        end
+
+        # Print additional properties based on entity type
+        case entity
+        when Unitsdb::Unit
+          puts "  - Symbols:" if entity.respond_to?(:symbols) && entity.symbols&.any?
+          entity.symbols.each { |s| puts "      - #{s}" } if entity.respond_to?(:symbols) && entity.symbols&.any?
+
+          puts "  - Definition: #{entity.definition}" if entity.respond_to?(:definition) && entity.definition
+
+          if entity.respond_to?(:dimensions) && entity.dimensions&.any?
+            puts "  - Dimensions:"
+            entity.dimensions.each { |d| puts "      - #{d}" }
+          end
+        when Unitsdb::Quantity
+          puts "  - Dimensions: #{entity.dimension}" if entity.respond_to?(:dimension) && entity.dimension
+        when Unitsdb::Prefix
+          puts "  - Value: #{entity.value}" if entity.respond_to?(:value) && entity.value
+          puts "  - Symbol: #{entity.symbol}" if entity.respond_to?(:symbol) && entity.symbol
+        when Unitsdb::Dimension
+          # Any dimension-specific properties
+        when Unitsdb::UnitSystem
+          puts "  - Organization: #{entity.organization}" if entity.respond_to?(:organization) && entity.organization
+        end
+
+        # Print references if available
+        return unless entity.respond_to?(:references) && entity.references&.any?
+
+        puts "  - References:"
+        entity.references.each do |ref|
+          puts "      - #{ref.type}: #{ref.uri}"
+        end
+      end
+
+      def get_entity_type(entity)
+        case entity
+        when Unitsdb::Unit
+          "Unit"
+        when Unitsdb::Prefix
+          "Prefix"
+        when Unitsdb::Quantity
+          "Quantity"
+        when Unitsdb::Dimension
+          "Dimension"
+        when Unitsdb::UnitSystem
+          "UnitSystem"
+        else
+          "Unknown"
+        end
+      end
+
+      def get_entity_name(entity)
+        # Using early returns is still preferable for simple conditions
+        return entity.names.first if entity.respond_to?(:names) && entity.names&.any?
+        return entity.name if entity.respond_to?(:name) && entity.name
+        return entity.short if entity.respond_to?(:short) && entity.short
+
+        "N/A" # Default if no name found
+      end
+    end
+  end
+end

data/lib/unitsdb/commands/normalize.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require "yaml"
+
+module Unitsdb
+  module Commands
+    class Normalize < Base
+      def run(input = nil, output = nil)
+        unless @options[:all] || (input && output)
+          puts "Error: INPUT and OUTPUT are required when not using --all"
+          exit(1)
+        end
+
+        if @options[:all]
+          Unitsdb::Utils::DEFAULT_YAML_FILES.each do |file|
+            path = File.join(@options[:database], file)
+            next unless File.exist?(path)
+
+            normalize_file(path, path)
+            puts "Normalized #{path}"
+          end
+          puts "All YAML files normalized successfully!"
+        end
+
+        return unless input && output
+
+        normalize_file(input, output)
+        puts "Normalized YAML written to #{output}"
+      end
+
+      private
+
+      def normalize_file(input, output)
+        # Load the original YAML to work with
+        yaml = YAML.safe_load(File.read(input))
+
+        # For schema 2.0.0, we need to handle the schema_version and the main collection key
+        if yaml.key?("schema_version") && yaml["schema_version"] == "2.0.0"
+          # Get the collection key (units, scales, etc.)
+          collection_key = (yaml.keys - ["schema_version"]).first
+
+          # Sort the collection items if requested
+          if @options[:sort] && @options[:sort] != "none" && collection_key
+            # Sort the collection items based on the sort option
+            case @options[:sort]
+            when "nist", "unitsml"
+              # Sort by ID (nist or unitsml)
+              id_type = @options[:sort]
+              yaml[collection_key] = sort_by_id_type(yaml[collection_key], id_type)
+            else # default to "short"
+              # Use the existing sort_yaml_keys method for default sorting
+              yaml[collection_key] = Unitsdb::Utils.sort_yaml_keys(yaml[collection_key])
+            end
+          end
+        elsif @options[:sort] && @options[:sort] != "none"
+          # For any other format, just sort all keys
+          yaml = Unitsdb::Utils.sort_yaml_keys(yaml)
+        end
+
+        # Write the normalized output
+        File.write(output, yaml.to_yaml)
+      end
+
+      # Sort collection items by a specific ID type (nist or unitsml)
+      def sort_by_id_type(collection, id_type)
+        return collection unless collection.is_a?(Array)
+
+        collection.sort_by do |item|
+          # Find the identifier of the specified type
+          identifier = if item.key?("identifiers") && item["identifiers"].is_a?(Array)
+                         item["identifiers"].find { |id| id["type"] == id_type }
+                       end
+
+          # Use the ID if found, otherwise use a placeholder to sort to the end
+          identifier ? identifier["id"].to_s : "zzzzz"
+        end.map { |item| Unitsdb::Utils.sort_yaml_keys(item) }
+      end
+    end
+  end
+end

data/lib/unitsdb/commands/release.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "zip"
+require "fileutils"
+
+module Unitsdb
+  module Commands
+    class Release < ::Unitsdb::Commands::Base
+      def run
+        # Load the database
+        db = load_database(@options[:database])
+        db.version = @options[:version]
+
+        # Create output directory if it doesn't exist
+        FileUtils.mkdir_p(@options[:output_dir])
+
+        # Generate release files based on format option
+        format = (@options[:format] || "all").downcase
+        case format
+        when "yaml"
+          create_unified_yaml(db)
+        when "zip"
+          create_zip_archive(db)
+        when "all"
+          create_unified_yaml(db)
+          create_zip_archive(db)
+        else
+          puts "Invalid format option: #{@options[:format]}"
+          puts "Valid options are: 'yaml', 'zip', or 'all'"
+          exit(1)
+        end
+
+        puts "Release files created successfully in #{@options[:output_dir]}"
+      rescue Unitsdb::Errors::DatabaseError => e
+        puts "Error: #{e.message}"
+        exit(1)
+      end
+
+      private
+
+      def create_unified_yaml(db)
+        # Create a unified YAML file with all database components
+        output_path = File.join(@options[:output_dir], "unitsdb-#{@options[:version]}.yaml")
+        File.write(output_path, db.to_yaml)
+        puts "Created unified YAML file: #{output_path}"
+      end
+
+      def create_zip_archive(db)
+        # Create a ZIP archive with individual YAML files
+        output_path = File.join(@options[:output_dir], "unitsdb-#{@options[:version]}.zip")
+
+        Zip::File.open(output_path, Zip::File::CREATE) do |zipfile|
+          {
+            dimensions: Unitsdb::Dimensions,
+            unit_systems: Unitsdb::UnitSystems,
+            units: Unitsdb::Units,
+            prefixes: Unitsdb::Prefixes,
+            quantities: Unitsdb::Quantities
+          }.each_pair do |access_method, collection_klass|
+            db.send(access_method).tap do |data|
+              collection = collection_klass.new(access_method => data)
+              collection.version = @options[:version]
+              zipfile.get_output_stream("#{access_method}.yaml") { |f| f.write(collection.to_yaml) }
+            end
+          end
+        end
+
+        puts "Created ZIP archive: #{output_path}"
+      end
+    end
+  end
+end