asciimath2unitsml 0.3.2 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f51b82e234fddaf66252f77a276a3acf68dae4356502a3c900253f5d4d4dffcf
-  data.tar.gz: 59dd18f009952329c1c07af2132ec06123c06dd3caea4ee7f22f17c0f4ec1cbc
+  metadata.gz: 25adab652658a50b2747ff9087cffa7c1c2fa864a701b253e393359ad3091ff0
+  data.tar.gz: 20d02312fcef3908ef823a59d18c45e6e03bc0c9d7c33b221c680048add583ca
 SHA512:
-  metadata.gz: 9a925e3db85d3086d676c07c101609e87674d620394f5fa0a536ab3652f3aa9c0cc6a74507d79264e0154bf51ea4121d47b7275a94212bc934b822b0392a9970
-  data.tar.gz: 59d98ebd629a20e8f03dc32a1870474e5808b9d38f51a87feec5eae9f0746535bed9dcf38b1faf3939319bb3989b1d926088e8d834388e48f045070e3749312a
+  metadata.gz: f82a936470d1e3ade5b48da9ea7a14825e7e0c82aaf14082b6c5dc44e7f09a04bede324875ed94879e2eeb2f483fc78aee4920075ced0ee528cf143a71424c5e
+  data.tar.gz: e3c5e9b073e51c4c8ae860c5c43cc6d2c39333f5b87f9eb6df8b10b77a293a910c6e46b5b7f260468be8be6b4ce8677e9cd49cd19e05eae34e5158d272ab0352

data/.github/workflows/rake.yml

@@ -16,21 +16,11 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: [ '2.7', '2.6', '2.5', '2.4' ]
+        ruby: [ '3.0', '2.7', '2.6', '2.5' ]
         os: [ ubuntu-latest, windows-latest, macos-latest ]
         experimental: [ false ]
-        include:
-          - ruby: '3.0'
-            os: 'ubuntu-latest'
-            experimental: true
-          - ruby: '3.0'
-            os: 'windows-latest'
-            experimental: true
-          - ruby: '3.0'
-            os: 'macos-latest'
-            experimental: true
     steps:
-      - uses: actions/checkout@master
+      - uses: actions/checkout@v2
         with:
           submodules: true
 
@@ -40,14 +30,3 @@ jobs:
           bundler-cache: true
 
       - run: bundle exec rake
-
-  tests-passed:
-    needs: rake
-    runs-on: ubuntu-latest
-    steps:
-      - uses: peter-evans/repository-dispatch@v1
-        with:
-          token: ${{ secrets.METANORMA_CI_PAT_TOKEN || secrets.GITHUB_TOKEN }}
-          repository: ${{ github.repository }}
-          event-type: notify
-          client-payload: '{"ref": "${{ github.ref }}", "sha": "${{ github.sha }}"}'

data/.hound.yml

@@ -0,0 +1,5 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+ruby:
+  enabled: true
+  config_file: .rubocop.yml

data/.rubocop.yml

@@ -1,14 +1,10 @@
-# This project follows the Ribose OSS style guide.
-# https://github.com/riboseinc/oss-guides
-# All project-specific additions and overrides should be specified in this file.
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
 inherit_from:
   - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
 
 # local repo-specific modifications
+# ...
 
 AllCops:
-  DisplayCopNames: false
-  StyleGuideCopsOnly: false
-  TargetRubyVersion: 2.4
-Rails:
-  Enabled: true
+  TargetRubyVersion: 2.5

data/Gemfile

@@ -1,4 +1,4 @@
 source "https://rubygems.org"
-  
+
 # Specify your gem's dependencies in ruby-vobject.gemspec
 gemspec

data/README.adoc

@@ -59,6 +59,24 @@ units. The options are an XML entity, or the values `space` or `nospace` (for wh
 Standalone prefixes can be recognised by replacing the unit with hyphen; so `unitsml(p-)` corresponds
 to the standalone prefix "pico" (and is rendered as "p").
 
+The gem also supports fundamental units, e.g. `unitsml(e)` for the atomic unit of charge, _e_,
+and symbols for dimensions. The latter are entered as `dim_XXX`, where `XXX` is their established symbol:
+
+|===
+|Symbol | Dimension
+
+|dim_L | Length
+|dim_M | Mass
+|dim_T | Time
+|dim_I | Electric Current
+|dim_Theta | Thermodynamic Temperature
+|dim_N | Amount of Substance
+|dim_J | Luminous Intensity
+|dim_phi | Plane Angle (dimensionless)
+|===
+
+e.g. `unitsml(dim_I)` for the dimension of electric current, 𝖨.
+
 == Rendering
 
 The output of the gem is MathML, with MathML unit expressions (expressed as `<mi>`, 
@@ -141,7 +159,7 @@ The converter is run as:
 [source,ruby]
 ----
 c = Asciimath2UnitsML::Conv.new()
-c.Asciimath2UnitsML(1 "unitsml(mm*s^-2)") # AsciiMath string containing UnitsML
+c.Asciimath2UnitsML('1 "unitsml(mm*s^-2)"') # AsciiMath string containing UnitsML
 c.MathML2UnitsML("<math xmlns='http://www.w3.org/1998/Math/MathML'><mn>7</mn>"\
   "<mtext>unitsml(kg^-2)</mtext></math>") # AsciiMath string containing <mtext>unitsml()</mtext>
 c.MathML2UnitsML(Nokogiri::XML("<math xmlns='http://www.w3.org/1998/Math/MathML'><mn>7</mn>"\

data/Rakefile

@@ -3,4 +3,4 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/asciimath2unitsml.gemspec

@@ -1,6 +1,6 @@
 # coding: utf-8
 
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path("lib", __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require "asciimath2unitsml/version"
 
@@ -22,44 +22,41 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.files         = `git ls-files`.split("\n")
   spec.test_files    = `git ls-files -- {spec}/*`.split("\n")
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
 
   # get an array of submodule dirs relatively to root repo
   `git config --file .gitmodules --get-regexp '\\.path$'`
     .split("\n")
     .map { |kv_str| kv_str.split(" ") }
     .each do |(_, submodule_path)|
+    # for each submodule, change working directory to that submodule
+    Dir.chdir(submodule_path) do
+      # issue git ls-files in submodule's directory
+      submodule_files = `git ls-files | grep -i '.yaml$'`.split($\)
 
-      # for each submodule, change working directory to that submodule
-      Dir.chdir(submodule_path) do
-
-        # issue git ls-files in submodule's directory
-        submodule_files = `git ls-files | grep -i '.yaml$'`.split($\)
-
-        submodule_files_paths = submodule_files.map do |filename|
-          File.join submodule_path, filename
-        end
-
-        # add relative paths to gem.files
-        spec.files += submodule_files_paths
+      submodule_files_paths = submodule_files.map do |filename|
+        File.join submodule_path, filename
       end
+
+      # add relative paths to gem.files
+      spec.files += submodule_files_paths
+    end
   end
 
   spec.add_dependency "asciimath"
   spec.add_dependency "htmlentities"
-  spec.add_dependency "nokogiri", "~> 1.10.4"
+  spec.add_dependency "nokogiri", "~> 1.12"
   spec.add_dependency "rsec", "~> 1.0.0"
 
   spec.add_development_dependency "bundler"
-  spec.add_development_dependency "byebug", "~> 9.1"
+  spec.add_development_dependency "debug"
   spec.add_development_dependency "equivalent-xml", "~> 0.6"
   spec.add_development_dependency "guard", "~> 2.14"
   spec.add_development_dependency "guard-rspec", "~> 4.7"
   spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rexml"
   spec.add_development_dependency "rspec", "~> 3.6"
   spec.add_development_dependency "rubocop", "~> 1.5.2"
   spec.add_development_dependency "simplecov", "~> 0.15"
   spec.add_development_dependency "timecop", "~> 0.9"
-  spec.add_development_dependency "rexml"
 end
-

data/bin/rspec

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
-  
+
 # This file was generated by Bundler.
 #
 # The application 'rspec' is installed as part of a gem, and
@@ -15,4 +15,3 @@ require "rubygems"
 require "bundler/setup"
 
 load Gem.bin_path("rspec-core", "rspec")
-

data/lib/asciimath2unitsml/conv.rb

@@ -3,6 +3,8 @@ require "nokogiri"
 require "htmlentities"
 require "yaml"
 require "rsec"
+require_relative "read"
+require_relative "dimensions"
 require_relative "string"
 require_relative "parse"
 require_relative "render"
@@ -19,6 +21,7 @@ module Asciimath2UnitsML
         .each_with_object({}) do |(k, v), m|
         m[k.to_s] = UnitsDB::Dimension.new(k, v)
       end
+      @dimensions = flip_name_and_symbols(@dimensions_id)
       @prefixes_id = read_yaml("../unitsdb/prefixes.yaml")
         .each_with_object({}) do |(k, v), m|
         m[k] = UnitsDB::Prefix.new(k, v)
@@ -33,10 +36,10 @@ module Asciimath2UnitsML
         m[k.to_s] = UnitsDB::Unit.new(k.to_s, v)
       end
       @units = flip_name_and_symbols(@units_id)
-      @symbols = @units.each_with_object({}) do |(_k, v), m|
+      @symbols = @units.merge(@dimensions).each_with_object({}) do |(_k, v), m|
         v.symbolids.each { |x| m[x] = v.symbols_hash[x] }
       end
-      @parser = parser
+      @parser, @dim_parser = parsers
       @multiplier = multiplier(options[:multiplier] || "\u22c5")
     end
 
@@ -46,7 +49,7 @@ module Asciimath2UnitsML
 
     def prefix(units)
       units.map { |u| u[:prefix] }.reject(&:nil?).uniq.map do |p|
-        <<~END
+        <<~XML
           <Prefix xmlns='#{UNITSML_NS}' prefixBase='#{@prefixes[p].base}'
                   prefixPower='#{@prefixes[p].power}' xml:id='#{@prefixes[p].id}'>
             <PrefixName xml:lang="en">#{@prefixes[p].name}</PrefixName>
@@ -55,74 +58,21 @@ module Asciimath2UnitsML
             <PrefixSymbol type="LaTeX">#{@prefixes[p].latex}</PrefixSymbol>
             <PrefixSymbol type="HTML">#{htmlent @prefixes[p].html}</PrefixSymbol>
           </Prefix>
-        END
+        XML
       end.join("\n")
     end
 
-    def dimension_components(dims)
-      return if dims.nil? || dims.empty?
-
-      <<~END
-        <Dimension xmlns='#{UNITSML_NS}' xml:id="#{dim_id(dims)}">
-        #{dims.map { |u| dimension1(u) }.join("\n")}
-        </Dimension>
-      END
-    end
-
-    U2D = {
-      "m" => { dimension: "Length", order: 1, symbol: "L" },
-      "g" => { dimension: "Mass", order: 2, symbol: "M" },
-      "kg" => { dimension: "Mass", order: 2, symbol: "M" },
-      "s" => { dimension: "Time", order: 3, symbol: "T" },
-      "A" => { dimension: "ElectricCurrent", order: 4, symbol: "I" },
-      "K" => { dimension: "ThermodynamicTemperature", order: 5,
-               symbol: "Theta" },
-      "degK" => { dimension: "ThermodynamicTemperature", order: 5,
-                  symbol: "Theta" },
-      "mol" => { dimension: "AmountOfSubstance", order: 6, symbol: "N" },
-      "cd" => { dimension: "LuminousIntensity", order: 7, symbol: "J" },
-      "deg" => { dimension: "PlaneAngle", order: 8, symbol: "Phi" },
-    }.freeze
-
-    def units2dimensions(units)
-      norm = decompose_units(units)
-      return if norm.any? do |u|
-        u[:unit] == "unknown" || u[:prefix] == "unknown" || u[:unit].nil?
-      end
-
-      norm.map do |u|
-        { dimension: U2D[u[:unit]][:dimension],
-          unit: u[:unit],
-          exponent: u[:exponent] || 1,
-          symbol: U2D[u[:unit]][:symbol] }
-      end.sort { |a, b| U2D[a[:unit]][:order] <=> U2D[b[:unit]][:order] }
-    end
-
-    def dimension1(u)
-      %(<#{u[:dimension]} symbol="#{u[:symbol]}"
-      powerNumerator="#{float_to_display(u[:exponent])}"/>)
-    end
-
-    def dim_id(dims)
-      return nil if dims.nil? || dims.empty?
-
-      dimhash = dims.each_with_object({}) { |h, m| m[h[:dimension]] = h }
-      dimsvector = %w(Length Mass Time ElectricCurrent ThermodynamicTemperature
-                      AmountOfSubstance LuminousIntensity PlaneAngle)
-        .map { |h| dimhash.dig(h, :exponent) }.join(":")
-      id = @dimensions_id&.values&.select { |d| d.vector == dimsvector }
-        &.first&.id and return id.to_s
-      "D_" + dims.map do |d|
-        U2D[d[:unit]][:symbol] +
-          (d[:exponent] == 1 ? "" : float_to_display(d[:exponent]))
-      end.join("")
-    end
-
     def decompose_units(units)
       gather_units(units_only(units).map { |u| decompose_unit(u) }.flatten)
     end
 
     def gather_units(units)
+      if units[0][:dim] then gather_dimensions(units)
+      else gather_units1(units)
+      end
+    end
+
+    def gather_units1(units)
       units.sort_by { |a| a[:unit] }.each_with_object([]) do |k, m|
         if m.empty? || m[-1][:unit] != k[:unit] then m << k
         else
@@ -138,12 +88,24 @@ module Asciimath2UnitsML
       end
     end
 
+    def gather_dimensions(units)
+      units.sort_by { |a| a[:dim] }.each_with_object([]) do |k, m| 
+        if m.empty? || m[-1][:dim] != k[:dim] then m << k
+        else
+          m[-1] = {
+            dim: m[-1][:dim],
+            exponent: (k[:exponent]&.to_f || 1) +
+              (m[-1][:exponent]&.to_f || 1),
+          }
+        end
+      end
+    end
+
     # treat g not kg as base unit: we have stripped the prefix k in parsing
     # reduce units down to basic units
     def decompose_unit(u)
-      if u[:unit].nil? then u
-      elsif u[:unit] == "g" then u
-      elsif @units[u[:unit]].system_type == "SI_base" then u
+      if u[:unit].nil? || u[:unit] == "g" ||
+          @units[u[:unit]].system_type == "SI_base" then u
       elsif !@units[u[:unit]].si_derived_bases
         { prefix: u[:prefix], unit: "unknown", exponent: u[:exponent] }
       else
@@ -188,41 +150,22 @@ module Asciimath2UnitsML
       id = quantity || @units[normtext].quantities.first
       @units[normtext]&.dimension and
         dim = %( dimensionURL="##{@units[normtext].dimension}")
-      <<~END
+      <<~XML
         <Quantity xmlns='#{UNITSML_NS}' xml:id="#{id}"#{dim} quantityType="base">
         #{quantityname(id)}
         </Quantity>
-      END
-    end
-
-    def dimid2dimensions(normtext)
-      @dimensions_id[normtext].keys.map do |k|
-        { dimension: k,
-          symbol: U2D.values.select { |v| v[:dimension] == k }.first[:symbol],
-          exponent: @dimensions_id[normtext].exponent(k) }
-      end
-    end
-
-    def dimension(normtext)
-      return unless @units[normtext]&.dimension
-
-      dims = dimid2dimensions(@units[normtext]&.dimension)
-      <<~END
-        <Dimension xmlns='#{UNITSML_NS}' xml:id="#{@units[normtext]&.dimension}">
-        #{dims.map { |u| dimension1(u) }.join("\n")}
-        </Dimension>
-      END
+      XML
     end
 
     def unitsml(units, origtext, normtext, quantity, name)
       dims = units2dimensions(units)
-      <<~END
+      <<~XML
         #{unit(units, origtext, normtext, dims, name)}
         #{prefix(units)}
         #{dimension(normtext)}
         #{dimension_components(dims)}
         #{quantity(normtext, quantity)}
-      END
+      XML
     end
   end
 end

data/lib/asciimath2unitsml/dimensions.rb

@@ -0,0 +1,117 @@
+module Asciimath2UnitsML
+  class Conv
+    def dimension_components(dims)
+      return if dims.nil? || dims.empty?
+
+      <<~XML
+        <Dimension xmlns='#{UNITSML_NS}' xml:id="#{dim_id(dims)}">
+        #{dims.map { |u| dimension1(u) }.join("\n")}
+        </Dimension>
+      XML
+    end
+
+    U2D = {
+      "m" => { dimension: "Length", order: 1, symbol: "L" },
+      "g" => { dimension: "Mass", order: 2, symbol: "M" },
+      "kg" => { dimension: "Mass", order: 2, symbol: "M" },
+      "s" => { dimension: "Time", order: 3, symbol: "T" },
+      "A" => { dimension: "ElectricCurrent", order: 4, symbol: "I" },
+      "K" => { dimension: "ThermodynamicTemperature", order: 5,
+               symbol: "Theta" },
+      "degK" => { dimension: "ThermodynamicTemperature", order: 5,
+                  symbol: "Theta" },
+      "mol" => { dimension: "AmountOfSubstance", order: 6, symbol: "N" },
+      "cd" => { dimension: "LuminousIntensity", order: 7, symbol: "J" },
+      "deg" => { dimension: "PlaneAngle", order: 8, symbol: "phi" },
+    }.freeze
+
+    Dim2D = {
+      "dim_L" => U2D["m"],
+      "dim_M" => U2D["g"],
+      "dim_T" => U2D["s"],
+      "dim_I" => U2D["A"],
+      "dim_Theta" => U2D["K"],
+      "dim_N" => U2D["mol"],
+      "dim_J" => U2D["cd"],
+      "dim_phi" => U2D["deg"],
+    }.freeze
+
+    def units2dimensions(units)
+      norm = decompose_units(units)
+      return units2dimensions_dim_input(norm) if norm[0][:dim]
+      return if norm.any? do |u|
+        u[:unit] == "unknown" || u[:prefix] == "unknown" || u[:unit].nil?
+      end
+
+      norm.map do |u|
+        { dimension: U2D[u[:unit]][:dimension],
+          unit: u[:unit],
+          exponent: u[:exponent] || 1,
+          symbol: U2D[u[:unit]][:symbol] }
+      end.sort { |a, b| U2D[a[:unit]][:order] <=> U2D[b[:unit]][:order] }
+    end
+
+    def units2dimensions_dim_input(norm)
+      norm.map do |u|
+        { dimension: Dim2D[u[:dim]][:dimension],
+          exponent: u[:exponent] || 1,
+          id: u[:dim],
+          symbol: Dim2D[u[:dim]][:symbol] }
+      end.sort { |a, b| Dim2D[a[:id]][:order] <=> Dim2D[b[:id]][:order] }
+    end
+
+    def dimension1(dim)
+      %(<#{dim[:dimension]} symbol="#{dim[:symbol]}"
+      powerNumerator="#{float_to_display(dim[:exponent])}"/>)
+    end
+
+    def dim_id(dims)
+      return nil if dims.nil? || dims.empty?
+
+      dimhash = dims.each_with_object({}) { |h, m| m[h[:dimension]] = h }
+      dimsvector = %w(Length Mass Time ElectricCurrent ThermodynamicTemperature
+                      AmountOfSubstance LuminousIntensity PlaneAngle)
+        .map { |h| dimhash.dig(h, :exponent) }.join(":")
+      id = @dimensions_id&.values&.select { |d| d.vector == dimsvector }
+        &.first&.id and return id.to_s
+      "D_" + dims.map do |d|
+        (U2D.dig(d[:unit], :symbol) || Dim2D.dig(d[:id], :symbol)) +
+          (d[:exponent] == 1 ? "" : float_to_display(d[:exponent]))
+      end.join("")
+    end
+
+    def decompose_units(units)
+      gather_units(units_only(units).map { |u| decompose_unit(u) }.flatten)
+    end
+
+    def dimid2dimensions(normtext)
+      @dimensions_id[normtext].keys.map do |k|
+        { dimension: k,
+          symbol: U2D.values.select { |v| v[:dimension] == k }.first[:symbol],
+          exponent: @dimensions_id[normtext].exponent(k) }
+      end
+    end
+
+    def dimension(normtext)
+      return unless @units[normtext]&.dimension
+
+      dims = dimid2dimensions(@units[normtext]&.dimension)
+      <<~XML
+        <Dimension xmlns='#{UNITSML_NS}' xml:id="#{@units[normtext]&.dimension}">
+        #{dims.map { |u| dimension1(u) }.join("\n")}
+        </Dimension>
+      XML
+    end
+
+    def unitsml(units, origtext, normtext, quantity, name)
+      dims = units2dimensions(units)
+      <<~XML
+        #{unit(units, origtext, normtext, dims, name)}
+        #{prefix(units)}
+        #{dimension(normtext)}
+        #{dimension_components(dims)}
+        #{quantity(normtext, quantity)}
+      XML
+    end
+  end
+end