latexmath 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e3ecc01756ec040a67e70289d15cf757b15c1b4b6f656a887ef991c15ae3852
-  data.tar.gz: 46341cdd12a8b4e84bbe14b69c1eae6b66eaa5e136c07bd55fae628fbcf028ac
+  metadata.gz: 1b0d3e40c0a302dcec54e7690c09cf45a4a96a1032b6ddae604e01ff7cc24fc8
+  data.tar.gz: ab2f29a511adf26da60f5141c25e61cd5f2acdbdc2978740c1a07777c3665a83
 SHA512:
-  metadata.gz: 2f67278c0fe3acbacd04e3ba8449fbcb77f75d46f36d5268db8dd42e971fadbf47dabeb4fe1197d0e2b50517e55b0c6db4d37916bdf6267e76bb7fa100dcd535
-  data.tar.gz: 845366028db2233749cc57f5a18fb5b842953c4426b12e80b416bc0701ec70e3127b030b27de7491f80ff2c9ad233af4407de208a4e92df69e7e2accf3e1e8e4
+  metadata.gz: 2b9d4f62bd5d9e50da58f62b659141ab76d8f71296eb6ef2b73cb4c1f3b471d06043de27343b8c3d41267e9258bd6a8124d4b33a27a5fdb69aec2c617c696661
+  data.tar.gz: 7114340479c2e338147a3324b748f7d66460e9fe119e2ab16e0e34d0f17ebca83da5de653cf36858dbed208589407c5a30278908b1b57bc76a138aae09ed8deb

data/.editorconfig

@@ -0,0 +1,14 @@
+# editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

data/.github/workflows/test.yml

@@ -0,0 +1,80 @@
+name: test
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+
+jobs:
+  build:
+    name: Run specs on ${{ matrix.os }} ruby ${{ matrix.ruby }}
+    runs-on: ${{ matrix.os }}
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        ruby: ['2.6', '2.5', '2.4']
+        experimental: [false]
+        include:
+          - ruby: '2.7'
+            os: ubuntu-latest
+            experimental: true
+          - ruby: '2.7'
+            os: macos-latest
+            experimental: true
+          - ruby: '2.7'
+            os: windows-latest
+            experimental: true
+
+    steps:
+      - name: Use Ruby
+        uses: actions/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      - uses: actions/checkout@master
+
+      - name: Install gems
+        run: |
+          gem install bundler -v "~> 2"
+          bundle install --jobs 4 --retry 5
+
+      - name: Install LaTeXML on Ubuntu
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo snap install latexml --edge
+          echo "::add-path::/snap/bin"
+
+      - name: Install LaTeXML on macOS
+        if: matrix.os == 'macos-latest'
+        run: |
+          brew install libxml2 cpanminus
+          env PATH=$(brew --prefix libxml2)/bin:$PATH \
+            cpanm --notest XML::LibXSLT@1.96 git://github.com/brucemiller/LaTeXML.git@9a0e7dc5
+
+      - name: Install LaTeXML on Windows
+        if: matrix.os == 'windows-latest'
+        shell: cmd
+        run: |
+          cinst -y latexml
+          refreshenv
+          set PATH=C:\Strawberry\c\bin;C:\Strawberry\perl\site\bin;C:\Strawberry\perl\bin;%PATH%
+          where latexmlmath
+
+      - name: Run RSpecs
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          bundle exec rake
+
+      - name: Run RSpecs
+        if: matrix.os == 'macos-latest'
+        run: |
+          env PATH=$(brew --prefix perl)/bin:$PATH bundle exec rake
+
+      - name: Run specs
+        if: matrix.os == 'windows-latest'
+        shell: pwsh
+        run: |
+          $env:Path = "C:\Strawberry\c\bin;C:\Strawberry\perl\site\bin;C:\Strawberry\perl\bin;$env:Path"
+          bundle exec rake

data/.gitignore

@@ -9,3 +9,13 @@
 
 # rspec failure tracking
 .rspec_status
+
+# ignore byebug history
+.byebug_history
+
+# ignore MacOS system file
+.DS_Store
+
+*.tex.html
+
+/dist/

data/.rubocop.yml

@@ -0,0 +1,132 @@
+Layout/EndAlignment:
+  Exclude:
+    - 'lib/latexmath/converter.rb'
+    - 'lib/latexmath/tokenizer.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowSafeAssignment.
+Lint/AssignmentInCondition:
+  Exclude:
+    - 'lib/latexmath/tokenizer.rb'
+
+# Offense count: 2
+Lint/ImplicitStringConcatenation:
+  Exclude:
+    - 'spec/tokenizer_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowKeywordBlockArguments.
+Lint/UnderscorePrefixedVariableName:
+  Exclude:
+    - 'lib/latexmath/converter.rb'
+
+# Offense count: 2
+Lint/UselessAssignment:
+  Exclude:
+    - 'lib/latexmath/converter.rb'
+
+# Offense count: 7
+# Configuration parameters: IgnoredMethods.
+Metrics/AbcSize:
+  Max: 32
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, ExcludedMethods.
+# ExcludedMethods: refine
+Metrics/BlockLength:
+  Max: 35
+
+# Offense count: 1
+# Configuration parameters: CountBlocks.
+Metrics/BlockNesting:
+  Max: 4
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 157
+
+# Offense count: 6
+# Configuration parameters: IgnoredMethods.
+Metrics/CyclomaticComplexity:
+  Max: 13
+
+# Offense count: 9
+# Configuration parameters: CountComments, CountAsOne, ExcludedMethods.
+Metrics/MethodLength:
+  Max: 39
+
+# Offense count: 6
+# Configuration parameters: IgnoredMethods.
+Metrics/PerceivedComplexity:
+  Max: 14
+
+# Offense count: 1
+Naming/ConstantName:
+  Exclude:
+    - 'lib/latexmath.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: AutoCorrect, EnforcedStyle.
+# SupportedStyles: nested, compact
+Style/ClassAndModuleChildren:
+  Exclude:
+    - 'lib/latexmath/xml/builder.rb'
+    - 'lib/latexmath/xml/element.rb'
+
+# Offense count: 7
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/latexmath.rb'
+    - 'lib/latexmath/aggregator.rb'
+    - 'lib/latexmath/converter.rb'
+    - 'lib/latexmath/equation.rb'
+    - 'lib/latexmath/latexml_requirement.rb'
+    - 'lib/latexmath/requirement.rb'
+    - 'lib/latexmath/tokenizer.rb'
+
+# Offense count: 18
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: always, always_true, never
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+# Offense count: 2
+# Configuration parameters: MinBodyLength.
+Style/GuardClause:
+  Exclude:
+    - 'lib/latexmath/aggregator.rb'
+
+# Offense count: 5
+Style/IdenticalConditionalBranches:
+  Exclude:
+    - 'lib/latexmath/converter.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/LineEndConcatenation:
+  Exclude:
+    - 'spec/tokenizer_spec.rb'
+
+# Offense count: 5
+# Cop supports --auto-correct.
+# Configuration parameters: AutoCorrect, EnforcedStyle, IgnoredMethods.
+# SupportedStyles: predicate, comparison
+Style/NumericPredicate:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/latexmath/aggregator.rb'
+    - 'lib/latexmath/converter.rb'
+    - 'lib/latexmath/latexml_requirement.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+Style/ZeroLengthPredicate:
+  Exclude:
+    - 'lib/latexmath/converter.rb'
+
+

data/Gemfile

@@ -1,7 +1,10 @@
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in latexmath.gemspec
 gemspec
 
-gem "rake", "~> 12.0"
-gem "rspec", "~> 3.0"
+gem 'byebug'
+gem 'pry'
+gem 'rake', '~> 12.0'
+gem 'rspec', '~> 3.0'
+gem 'rubocop'

data/Gemfile.lock

@@ -1,16 +1,39 @@
 PATH
   remote: .
   specs:
-    latexmath (0.1.0)
+    latexmath (0.1.1)
       htmlentities (~> 4.3)
-      unicode2latex (~> 0.0.1)
+      ox (~> 2.13)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    ast (2.4.1)
+    byebug (11.1.3)
+    coderay (1.1.3)
     diff-lcs (1.4.4)
+    equivalent-xml (0.6.0)
+      nokogiri (>= 1.4.3)
+    execjs (2.7.0)
     htmlentities (4.3.4)
+    method_source (1.0.0)
+    mini_portile2 (2.4.0)
+    nokogiri (1.10.10)
+      mini_portile2 (~> 2.4.0)
+    opal (1.0.3)
+      ast (>= 2.3.0)
+      parser (~> 2.6)
+    ox (2.13.3)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    rainbow (3.0.0)
     rake (12.3.3)
+    regexp_parser (1.7.1)
+    rexml (3.2.4)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
@@ -24,15 +47,33 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.9.0)
     rspec-support (3.9.3)
-    unicode2latex (0.0.4)
+    rubocop (0.89.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.1)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.7)
+      rexml
+      rubocop-ast (>= 0.3.0, < 1.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (0.3.0)
+      parser (>= 2.7.1.4)
+    ruby-progressbar (1.10.1)
+    unicode-display_width (1.7.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  byebug
+  equivalent-xml
+  execjs
   latexmath!
+  opal
+  pry
   rake (~> 12.0)
   rspec (~> 3.0)
+  rubocop
 
 BUNDLED WITH
    2.1.4

data/README.adoc

@@ -0,0 +1,28 @@
+= latexmath
+
+image:https://img.shields.io/gem/v/latexmath.svg["Gem Version", link="https://rubygems.org/gems/latexmath"]
+image:https://github.com/metanorma/latexmath/workflows/test/badge.svg["Build Status", link="https://github.com/metanorma/latexmath/actions?workflow=test"]
+image:https://codeclimate.com/github/metanorma/latexmath/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/metanorma/latexmath"]
+image:https://img.shields.io/github/issues-pr-raw/metanorma/latexmath.svg["Pull Requests", link="https://github.com/metanorma/latexmath/pulls"]
+image:https://img.shields.io/github/commits-since/metanorma/latexmath/latest.svg["Commits since latest",link="https://github.com/metanorma/latexmath/releases"]
+
+== Purpose
+
+Ruby gem to translate LaTeX math into MathML.
+The MathML is supposed to be compliant with output of LaTeXML.
+
+It also works in reverse by translating MathML into LaTeX code.
+
+The LaTeX math syntax supports `amsmath`, `array`, `split` and `pmatrix` packages.
+
+NOTE: Bolding, symbols like `\backepsilon`, equation alignment, are all supported.
+
+== Usage
+
+[source,ruby]
+-------------
+require "latexmath"
+
+latex = "$$f_i =  \sum_{j=1}^2 s_{ij} n_j \quad {\rm for} \quad i = 1,2$$"
+mathml = Latexmath.parse(latex).to_mathml
+-------------

data/Rakefile

@@ -1,6 +1,32 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task 'build-opal' do
+  require 'opal'
+  require 'erb'
+  require 'json'
+
+  b = Opal::Builder.new
+
+  b.append_paths __dir__ + '/lib'
+  b.append_paths __dir__ + '/opal'
+  b.use_gem 'htmlentities'
+
+  build = b.build('latexmath-opal').to_s
+  # This is a hack intended for ExecJS to work properly.
+  build = build.gsub('Object freezing is not supported by Opal', '')
+
+  FileUtils.mkdir_p 'dist'
+  File.write('dist/latexmath.js', build)
+end
+
+task 'spec-opal' => 'build-opal' do
+  ENV['TEST_OPAL'] = '1'
+  Rake::Task['spec'].execute
+  ENV.delete 'TEST_OPAL'
+end
+
+task default: [:spec, 'spec-opal']

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
-require "bundler/setup"
-require "latexmath"
+require 'bundler/setup'
+require 'latexmath'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +10,5 @@ require "latexmath"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/exe/latexmath

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+require_relative '../lib/latexmath'
+
+latex = File.read(ARGV[0])
+
+tokens = Latexmath::Tokenizer.new(latex).tokenize
+aggr = Latexmath::Aggregator.new(tokens).aggregate
+puts Latexmath::Converter.new(aggr).convert

data/latexmath.gemspec

@@ -1,31 +1,34 @@
 require_relative 'lib/latexmath/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "latexmath"
+  spec.name          = 'latexmath'
   spec.version       = Latexmath::VERSION
   spec.authors       = ['Ribose Inc.']
   spec.email         = ['open.source@ribose.com']
 
-  spec.summary       = %q{Converts LaTeX math into MathML.}
-  spec.description   = %q{Converts LaTeX math into MathML.}
-  spec.homepage      = "https://github.com/metanorma/latexmath"
-  spec.license       = "BSD-2-Clause"
+  spec.summary       = 'Converts LaTeX math into MathML.'
+  spec.description   = 'Converts LaTeX math into MathML.'
+  spec.homepage      = 'https://github.com/plurimath/latexmath'
+  spec.license       = 'BSD-2-Clause'
 
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/metanorma/latexmath"
-  spec.metadata["changelog_uri"] = "https://github.com/metanorma/latexmath/blob/master/CHANGELOG.md."
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/plurimath/latexmath'
+  spec.metadata['changelog_uri'] = 'https://github.com/plurimath/latexmath/blob/master/CHANGELOG.md.'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.add_dependency "unicode2latex", "~> 0.0.1"
-  spec.add_dependency "htmlentities", "~> 4.3"
+  spec.add_dependency 'htmlentities', '~> 4.3'
+  spec.add_dependency 'ox', '~> 2.13'
+  spec.add_development_dependency 'equivalent-xml'
+  spec.add_development_dependency 'execjs'
+  spec.add_development_dependency 'opal'
 end