stepmod-utils 0.3.14 → 0.3.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2dbfad6cebbd4552c2b91cfd5aac3dc5a032bde8a44269b83303d8472bf86310
-  data.tar.gz: 185a292f76f2e5b792383b8f2ca17438cb939a557f3df763ed5c9321c28b7438
+  metadata.gz: e8be21fe4d04046487ecb36fdebeb74f8dbbb7bda473cbb1b3451b62b15d62a0
+  data.tar.gz: f3005c150d30d5c8aac9b77f9221cfcfc575e0d541208152087f6ff88623375d
 SHA512:
-  metadata.gz: a6f855167c151253c8b2278dfafe460198fe2c7789ce3cb2eba4dca20dc216546d88b68f199f48a6508574b1c28eaf476604799c99b3762662269eec743e0d5e
-  data.tar.gz: a85e8f5a2d4607f5c001c5889c4549d2698279bb5163b3e87c79e5e28c3f0bbea7a38dd56d3440af3b43467ac2d93d7b16407d63f27c7abc61ca3fe1f5aa6551
+  metadata.gz: b004697a0c9eeecc570ba7e184fd7165fa991be9b0046f13305106a6cbdff123aca57299c340ce72fb95214ad878a0d0aff140af5e07308070d1c8a336c09921
+  data.tar.gz: 9aaa80fff000066c954b660592626a9ee0132cfca173c0d93aeb572211adf1929d79dc1f1336858725b031b287d1a9d07f9e4d79e45b8d4a4727819fbe303b9f

data/.github/workflows/rake.yml

@@ -10,23 +10,6 @@ on:
 
 jobs:
   rake:
-    name: Test on Ruby ${{ matrix.ruby }} ${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    continue-on-error: ${{ matrix.experimental }}
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby: [ '3.0', '2.7', '2.6', '2.5' ]
-        os: [ ubuntu-latest, windows-latest, macos-latest ]
-        experimental: [ false ]
-    steps:
-      - uses: actions/checkout@v2
-        with:
-          submodules: true
-
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-
-      - run: bundle exec rake
+    uses: metanorma/ci/.github/workflows/generic-rake.yml@main
+    secrets:
+      pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}

data/.github/workflows/release.yml

@@ -15,32 +15,10 @@ on:
 
 jobs:
   release:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
+    uses: metanorma/ci/.github/workflows/rubygems-release.yml@main
+    with:
+      next_version: ${{ github.event.inputs.next_version }}
+    secrets:
+      rubygems-api-key: ${{ secrets.METANORMA_CI_RUBYGEMS_API_KEY }}
+      pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}
 
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '2.6'
-          bundler-cache: true
-
-      - run: gem install gem-release
-
-      - run: |
-          git config user.name github-actions
-          git config user.email github-actions@github.com
-
-      - if: github.event_name == 'workflow_dispatch' && github.event.inputs.next_version != 'skip'
-        run: gem bump --version ${{ github.event.inputs.next_version }} --tag --push
-
-      - name: publish to rubygems.org
-        env:
-          RUBYGEMS_API_KEY: ${{secrets.METANORMA_CI_RUBYGEMS_API_KEY}}
-        run: |
-          gem install gem-release
-          envsubst << 'EOF' > ~/.gem/credentials
-          ---
-          :rubygems_api_key: ${RUBYGEMS_API_KEY}
-          EOF
-          chmod 0600 ~/.gem/credentials
-          gem release

data/README.adoc

@@ -14,11 +14,6 @@ The `stepmod-utils` Ruby gem provides a number of tools to work with the STEPmod
 repository.
 
 
-== CVS to Git migration procedures
-
-include::migrating_from_cvs.adoc[]
-
-
 == Installation
 
 [source,ruby]
@@ -116,48 +111,15 @@ expg_image:contract_schemaexpg1.xml[]
 expg_image:contract_schemaexpg2.xml[]
 ----
 
+== Git repository
 
-== CVS revision detection
-
-If the STEPmod repository is a CVS repository, it will display the
-working and repository revisions as comments.
-
-WARNING: CVS revision detection can be *slow*! Be patient.
-
-Sample output:
-
-[source,sh]
-----
-[stepmod-utils] INFO: STEPmod directory set to ../x/stepmod/.
-[stepmod-utils] INFO: STEPmod directory is a CVS repository and will detect revisions.
-[stepmod-utils] INFO: [CVS] Detecting file revisions can be slow, please be patient!
-[stepmod-utils] INFO: Detecting paths...
-[stepmod-utils] INFO: Processing XML file data/business_object_models/managed_model_based_3d_engineering/business_object_model.xml
-[stepmod-utils] INFO: Detecting CVS revision...
-[stepmod-utils] INFO: CVS working rev (1.148), repo rev (1.148)
-[stepmod-utils] INFO: Completed processing XML file data/business_object_models/managed_model_based_3d_engineering/business_object_model.xml
-[stepmod-utils] INFO: Processing XML file data/business_object_models/managed_model_based_3d_engineering_domain/business_object_model.xml
-[stepmod-utils] INFO: Detecting CVS revision...
-[stepmod-utils] INFO: CVS working rev (1.31), repo rev (1.31)
-[stepmod-utils] INFO: Completed processing XML file data/business_object_models/managed_model_based_3d_engineering_domain/business_object_model.xml
-...
- stepmod/data/business_object_models/managed_model_based_3d_engineering_domain/business_object_model.xml
-[stepmod-utils] INFO: written to: 031-generated-terms.adoc
-[stepmod-utils] INFO: written to: 991-generated-bibliography.adoc
-----
-
-
-== Non-CVS repository
-
-If the STEPmod repository is not a CVS repository, or if the `cvs` executable
-cannot be found, term extract will still work.
+If the STEPmod repository is a Git repository, term extract will work.
 
 Sample output:
 
 [source,sh]
 ----
 [stepmod-utils] INFO: STEPmod directory set to ../iso-10303-stepmod.
-[stepmod-utils] INFO: STEPmod directory is not a CVS repository, skipping revision detection.
 [stepmod-utils] INFO: Detecting paths...
 [stepmod-utils] INFO: Processing XML file data/application_protocols/boundary_representation_for_iso_14306_open_jt/application_protocol.xml
 [stepmod-utils] INFO: skipped ISO/CD 10303-243 as it is not IS, DIS or TS

data/exe/stepmod-annotate-all

@@ -27,15 +27,20 @@ files.each_slice(MAX_QUEUE_SIZE) do |batch|
   batch.each do |file|
     pool.post do
       puts("#{Thread.current.object_id}: Queued processing #{file}")
-      annotated = Stepmod::Utils::StepmodFileAnnotator.new(express_file: file,
-                                                           resource_docs_cache_file: resource_docs_cache_file, stepmod_dir: stepmod_dir).call
-      File.open(
-        File.join(File.dirname(file),
-                  "#{File.basename(file, '.exp')}_annotated.exp"), "w"
-      ) do |file|
+      annotated = Stepmod::Utils::StepmodFileAnnotator.new(
+        express_file: file,
+        resource_docs_cache_file: resource_docs_cache_file,
+        stepmod_dir: stepmod_dir
+      ).call
+
+      annotated_file_name = "#{File.basename(file, '.exp')}_annotated.exp"
+      annotated_file_path = File.join(File.dirname(file), annotated_file_name)
+
+      File.open(annotated_file_path, "w") do |file|
         file.puts(annotated)
       end
-      puts("#{Thread.current.object_id}: Done processing #{file}")
+
+      puts("#{Thread.current.object_id}: Done processing #{File.basename(file)} => #{annotated_file_path}.")
     end
   end
   pool.shutdown

data/exe/stepmod-extract-terms

@@ -20,14 +20,17 @@ end
 
 require "bundler/setup"
 require "stepmod/utils/terms_extractor"
-
 require 'optparse'
 
+def log(message)
+  puts "[stepmod-utils] #{message}"
+end
+
 options = {}
 OptionParser.new do |opts|
   opts.banner = "Usage: #{$0} [options]"
 
-  opts.on("-p", "--path STEPMOD_DATA_PATH", String, "Path to STEPmod CVS data directory") do |path|
+  opts.on("-p", "--path STEPMOD_DATA_PATH", String, "Path to STEPmod data directory") do |path|
     options[:stepmod_dir] = path
   end
 
@@ -103,32 +106,29 @@ def replace_images(content)
   content
 end
 
-def log(message)
-  puts "[stepmod-utils] #{message}"
-end
-
-part_concepts.each do |(bibdata, current_part_concepts)|
-  current_part_concepts = current_part_concepts.to_a.map do |n|
-    n.localizations["en"]
-  end
-  fn = "03x-stepmod-#{bibdata.part}.adoc"
-  File.open(fn, "w") do |file|
-    file.puts("== #{part_to_title(bibdata)}\n\n")
-    file.puts(replace_images(current_part_concepts.map(&:to_mn_adoc).join("\n")))
-  end
-  log "INFO: written to: #{fn}"
-end
-
-File.open("03x-stepmod.adoc", "w") do |file|
-  part_concepts.sort_by do |(bibdata, current_part_concepts)|
-    bibdata.part.to_i
-  end.each do |(bibdata, current_part_concepts)|
-    fn = "03x-stepmod-#{bibdata.part}.adoc"
-    file.puts("\ninclude::#{fn}[]\n")
-  end
-end
-
-log "INFO: written summary file to: 03x-stepmod.adoc"
+## Skip all Clause 3 terms
+# part_concepts.each do |(bibdata, current_part_concepts)|
+#   current_part_concepts = current_part_concepts.to_a.map do |n|
+#     n.localizations["en"]
+#   end
+#   fn = "03x-stepmod-#{bibdata.part}.adoc"
+#   File.open(fn, "w") do |file|
+#     file.puts("== #{part_to_title(bibdata)}\n\n")
+#     file.puts(replace_images(current_part_concepts.map(&:to_mn_adoc).join("\n")))
+#   end
+#   log "INFO: written to: #{fn}"
+# end
+
+# File.open("03x-stepmod.adoc", "w") do |file|
+#   part_concepts.sort_by do |(bibdata, current_part_concepts)|
+#     bibdata.part.to_i
+#   end.each do |(bibdata, current_part_concepts)|
+#     fn = "03x-stepmod-#{bibdata.part}.adoc"
+#     file.puts("\ninclude::#{fn}[]\n")
+#   end
+# end
+
+# log "INFO: written summary file to: 03x-stepmod.adoc"
 
 part_resources.each do |(bibdata, current_part_resources)|
   current_part_resources = current_part_resources.to_a.map do |n|
@@ -195,17 +195,18 @@ end
 
 log "INFO: written summary file to: 05x-stepmod-entities-modules.adoc"
 
-File.open("031-stepmod-general.adoc", "w") do |file|
-  file.puts(
-    replace_images(
-      general_concepts.to_a.map do |n|
-        n.localizations["en"]
-      end.map(&:to_mn_adoc).join("\n")
-    )
-  )
-end
-
-log "INFO: written to: 031-stepmod-general.adoc"
+## Skipping all Clause 3 terms
+# File.open("031-stepmod-general.adoc", "w") do |file|
+#   file.puts(
+#     replace_images(
+#       general_concepts.to_a.map do |n|
+#         n.localizations["en"]
+#       end.map(&:to_mn_adoc).join("\n")
+#     )
+#   )
+# end
+
+# log "INFO: written to: 031-stepmod-general.adoc"
 
 File.open("041-stepmod-entities-resources.adoc", "w") do |file|
   file.puts(

data/lib/stepmod/utils/concept.rb

@@ -23,15 +23,6 @@ module Stepmod
 
           return nil if converted_definition.nil? || converted_definition.strip.empty?
 
-          if definition_xml.name == "ext_description"
-            converted_definition = <<~TEXT
-              #{converted_definition}
-
-              NOTE: This term is incompletely defined in this document.
-              Reference <<#{reference_anchor}>> for the complete definition.
-            TEXT
-          end
-
           # https://github.com/metanorma/stepmod-utils/issues/86
 
           # TODO: This portion DOES NOT HANDLE the <synonym> element. WTF??

data/lib/stepmod/utils/converters/express_example.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Stepmod
+  module Utils
+    module Converters
+      class ExpressExample < ReverseAdoc::Converters::Base
+        def convert(node, state = {})
+          <<~TEMPLATE
+            (*"#{state[:schema_and_entity]}.__example"
+            #{treat_children(node, state).strip}
+            *)
+          TEMPLATE
+        end
+      end
+
+      ReverseAdoc::Converters.register :express_example, ExpressExample.new
+    end
+  end
+end

data/lib/stepmod/utils/converters/express_note.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Stepmod
+  module Utils
+    module Converters
+      class ExpressNote < ReverseAdoc::Converters::Base
+        def convert(node, state = {})
+          <<~TEMPLATE
+            (*"#{state[:schema_and_entity]}.__note"
+            #{treat_children(node, state).strip}
+            *)
+          TEMPLATE
+        end
+      end
+
+      ReverseAdoc::Converters.register :express_note, ExpressNote.new
+    end
+  end
+end

data/lib/stepmod/utils/converters/module_ref_express_description.rb

@@ -0,0 +1,14 @@
+module Stepmod
+  module Utils
+    module Converters
+      class ModuleRefExpressDescription < ReverseAdoc::Converters::Base
+        def convert(node, _state = {})
+          parts = node["linkend"].to_s.split(":").last.split(".")
+          "<<express:#{parts.join('.').strip},#{parts.last.strip}>>"
+        end
+      end
+      ReverseAdoc::Converters.register :module_ref,
+                                       ModuleRefExpressDescription.new
+    end
+  end
+end

data/lib/stepmod/utils/converters/stepmod_ext_description.rb

@@ -43,18 +43,17 @@ module Stepmod
 
           domain =  case linkend.first
                     when /_mim$/, /_arm$/
-                      "ISO 10303 application module"
+                      "application module"
                     # when /_schema$/
                     else
-                      "ISO 10303 resource"
+                      "resource"
                     end
 
           <<~TEMPLATE
             === #{linkend.last}
+            #{domain ? "domain:[#{domain}: #{linkend.first}]" : ''}
 
-            #{domain ? "domain:[#{domain}]" : ''}
-
-            #{child_text}
+            #{child_text.strip}
           TEMPLATE
         end
       end

data/lib/stepmod/utils/converters/term.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require "stepmod/utils/converters/synonym"
+require "stepmod/utils/term"
+require "glossarist"
 
 module Stepmod
   module Utils
@@ -22,22 +24,20 @@ module Stepmod
           unless first_child &&
               node.text.split(";").length == 2 &&
               defined?(Stepmod::Utils::Converters::Synonym)
-            return "=== #{treat_acronym(treat_children(node, state).strip)}"
+
+            return Stepmod::Utils::Term.from_h(
+              "definition" => treat_children(node, state).strip,
+            ).to_mn_adoc
           end
 
           term_def, alt = node.text.split(";")
           alt_xml = Nokogiri::XML::Text.new(alt, Nokogiri::XML::Document.new)
           converted_alt = Stepmod::Utils::Converters::Synonym.new.convert(alt_xml)
-          "=== #{treat_acronym(term_def)}\n\n#{converted_alt}"
-        end
-
-        private
-
-        def treat_acronym(term_def)
-          return term_def.strip if term_def !~ /.+\(.+?\)$/
 
-          _, term_text, term_acronym = term_def.match(/(.+?)(\(.+\))$/).to_a
-          "#{term_text.strip}\nalt:[#{term_acronym.gsub(/\(|\)/, '')}]"
+          Stepmod::Utils::Term.from_h(
+            "definition" => term_def,
+            "synonyms" => [converted_alt],
+          ).to_mn_adoc
         end
       end
 

data/lib/stepmod/utils/smrl_description_converter.rb

@@ -41,7 +41,7 @@ module Stepmod
         root || (return "")
 
         ReverseAdoc.config.with(options) do
-          result = ReverseAdoc::Converters.lookup(root.name).convert(root)
+          result = ReverseAdoc::Converters.lookup(root.name).convert(root, options)
           Stepmod::Utils::Cleaner.new.tidy(result)
         end
       end

data/lib/stepmod/utils/smrl_resource_converter.rb

@@ -59,7 +59,8 @@ module Stepmod
         root || (return "")
 
         ReverseAdoc.config.with(options) do
-          result = ReverseAdoc::Converters.lookup(root.name).convert(root)
+          result = ReverseAdoc::Converters.lookup(root.name).convert(root, options)
+
           Stepmod::Utils::Cleaner.new.tidy(result)
         end
       end

data/lib/stepmod/utils/stepmod_file_annotator.rb

@@ -1,6 +1,8 @@
 require "json"
 require "stepmod/utils/smrl_description_converter"
 require "stepmod/utils/smrl_resource_converter"
+require "stepmod/utils/converters/express_note"
+require "stepmod/utils/converters/express_example"
 
 module Stepmod
   module Utils
@@ -64,7 +66,27 @@ module Stepmod
       def convert_from_description_text(descriptions_file, description)
         Dir.chdir(File.dirname(descriptions_file)) do
           wrapper = "<ext_descriptions>#{description}</ext_descriptions>"
-          "\n#{Stepmod::Utils::SmrlDescriptionConverter.convert(wrapper)}"
+          notes = description.xpath("note")
+          examples = description.xpath("example")
+
+          converted_description = <<~DESCRIPTION
+
+            #{Stepmod::Utils::SmrlDescriptionConverter.convert(wrapper, no_notes_examples: true)}
+          DESCRIPTION
+
+          converted_examples = examples.map do |example|
+            Stepmod::Utils::Converters::ExpressExample
+              .new
+              .convert(example, schema_and_entity: description["linkend"])
+          end.join
+
+          converted_notes = notes.map do |note|
+            Stepmod::Utils::Converters::ExpressNote
+              .new
+              .convert(note, schema_and_entity: description["linkend"])
+          end.join
+
+          "#{converted_description}#{converted_examples}#{converted_notes}"
         end
       end
 
@@ -77,7 +99,7 @@ module Stepmod
 
         Dir.chdir(File.dirname(descriptions_file)) do
           wrapper = "<resource>#{schema}</resource>"
-          "\n#{Stepmod::Utils::SmrlResourceConverter.convert(wrapper)}"
+          "\n#{Stepmod::Utils::SmrlResourceConverter.convert(wrapper, no_notes_examples: true)}"
         end
       end
     end

data/lib/stepmod/utils/term.rb

@@ -0,0 +1,38 @@
+require "glossarist"
+
+module Stepmod
+  module Utils
+    class Term < Glossarist::LocalizedConcept
+      # Term acronym
+      attr_accessor :acronym
+
+      def to_mn_adoc
+        mn_adoc = ["=== #{definition}"]
+        mn_adoc << "\nalt:[#{acronym}]" if acronym
+        mn_adoc << "\n\n#{designations.join(", ")}" if designations&.any?
+
+        mn_adoc.join
+      end
+
+      class << self
+        def from_h(hash)
+          _, definition, acronym = treat_acronym(hash["definition"])
+
+          hash["definition"] = definition
+          hash["acronym"] = acronym.gsub(/\(|\)/, "") if acronym
+          hash["designations"] = hash["synonyms"]
+
+          super(hash.reject { |k, _| k == "synonyms" })
+        end
+
+        private
+
+        def treat_acronym(term_def)
+          return [nil, term_def.strip, nil] unless term_def.match?(/.+\(.+?\)$/)
+
+          term_def.match(/(.+?)(\(.+\))$/).to_a
+        end
+      end
+    end
+  end
+end

data/lib/stepmod/utils/terms_extractor.rb

@@ -3,6 +3,9 @@ require "stepmod/utils/bibdata"
 require "stepmod/utils/concept"
 require "glossarist"
 require "securerandom"
+require "expressir"
+require "expressir/express/parser"
+require "indefinite_article"
 
 ReverseAdoc.config.unknown_tags = :bypass
 
@@ -20,7 +23,6 @@ module Stepmod
                   :resource_concepts,
                   :parsed_bibliography,
                   :encountered_terms,
-                  :cvs_mode,
                   :part_concepts,
                   :part_resources,
                   :part_modules,
@@ -60,25 +62,7 @@ module Stepmod
       end
 
       def call
-        # If we are using the stepmod CVS repository, provide the revision number per file
-        @cvs_mode = if Dir.exists?(stepmod_path.join("CVS"))
-                      require "ptools"
-                      # ptools provides File.which
-                      File.which("cvs")
-                    end
-
         log "INFO: STEPmod directory set to #{stepmod_dir}."
-
-        if cvs_mode
-          log "INFO: STEPmod directory is a \
-            CVS repository and will detect revisions."
-          log "INFO: [CVS] Detecting file revisions can be slow, \
-            please be patient!"
-        else
-          log "INFO: STEPmod directory is not a CVS repository, \
-            skipping revision detection."
-        end
-
         log "INFO: Detecting paths..."
 
         repo_index = Nokogiri::XML(File.read(@index_path)).root
@@ -161,24 +145,15 @@ module Stepmod
             next
           end
 
-          revision_string = "\n// CVS: revision not detected"
-          if cvs_mode
-            # Run `cvs status` to find out version
-
-            log "INFO: Detecting CVS revision..."
-            Dir.chdir(stepmod_path) do
-              status = `cvs status #{fpath}`
-
-              unless status.empty?
-                working_rev = status.split(/\n/).grep(/Working revision:/)
-                  .first.match(/revision:\s+(.+)$/)[1]
-                repo_rev = status.split(/\n/).grep(/Repository revision:/)
-                  .first.match(/revision:\t(.+)\t/)[1]
-                log "INFO: CVS working rev (#{working_rev}), \
-                  repo rev (#{repo_rev})"
-                revision_string = "\n// CVS working rev: (#{working_rev}), repo rev (#{repo_rev})\n" +
-                  "// CVS: revision #{working_rev == repo_rev ? 'up to date' : 'differs'}"
-              end
+          revision_string = ""
+
+          # Run `cvs status` to find out version
+          log "INFO: Detecting Git SHA..."
+          Dir.chdir(stepmod_path) do
+            git_sha = `git rev-parse HEAD`
+
+            unless git_sha.empty?
+              revision_string = "\n// Git: SHA #{git_sha}"
             end
           end
 
@@ -226,7 +201,7 @@ module Stepmod
           case file_path.to_s
           when /resource.xml$/
             log "INFO: Processing resource.xml for #{file_path}"
-            # Assumption: every schema is only linked by a single resource_docs document.
+
             current_document.xpath("//schema").each do |schema_node|
               schema_name = schema_node["name"]
               if parsed_schema_names[schema_name]
@@ -238,19 +213,36 @@ module Stepmod
                 parsed_schema_names[schema_name] = file_path
               end
 
-              Dir["#{stepmod_path}/resources/#{schema_name}/descriptions.xml"].each do |description_xml_path|
-                log "INFO: Processing resources schema #{description_xml_path}"
-                description_document = Nokogiri::XML(File.read(description_xml_path)).root
-                description_document.xpath("//ext_description").each do |ext_description|
-                  # log "INFO: Processing linkend[#{ext_description['linkend']}]"
-
-                  concept = Stepmod::Utils::Concept.parse(
-                    ext_description,
-                    reference_anchor: bibdata.anchor,
-                    reference_clause: nil,
-                    file_path: Pathname.new(description_xml_path)
+              exp_annotated_path =
+                "#{stepmod_path}/resources/#{schema_name}/#{schema_name}_annotated.exp"
+
+              log "INFO: Processing resources schema #{exp_annotated_path}"
+
+              if File.exists?(exp_annotated_path)
+                repo = Expressir::Express::Parser.from_file(exp_annotated_path)
+                schema = repo.schemas.first
+
+                schema.entities.each do |entity|
+                  old_definition = entity.remarks.first
+
+                  domain = "resource: #{schema.id}"
+                  entity_definition = generate_entity_definition(entity, domain, old_definition)
+
+                  reference_anchor = bibdata.anchor
+                  reference_clause = nil
+
+                  concept = Stepmod::Utils::Concept.new(
+                    designations: [entity.id],
+                    definition: old_definition,
+                    converted_definition: entity_definition,
+                    id: "#{reference_anchor}.#{reference_clause}",
+                    reference_anchor: reference_anchor,
+                    reference_clause: reference_clause,
+                    file_path: Pathname.new(file_path)
                                 .relative_path_from(stepmod_path),
+                    language_code: "en",
                   )
+
                   next unless concept
 
                   if term_special_category(bibdata)
@@ -280,62 +272,89 @@ module Stepmod
               parsed_schema_names[schema_name] = file_path
             end
 
-            description_xml_path = "#{stepmod_path}/modules/#{schema_name}/arm_descriptions.xml"
-            log "INFO: Processing modules schema #{description_xml_path}"
-
-            if File.exists?(description_xml_path)
-              description_document = Nokogiri::XML(
-                File.read(description_xml_path),
-              )
-                .root
-              description_document.xpath("//ext_description").each do |ext_description|
-                linkend_schema = ext_description["linkend"].split(".").first
-                concept = Stepmod::Utils::Concept.parse(
-                  ext_description,
-                  reference_anchor: bibdata.anchor,
-                  reference_clause: nil,
-                  file_path: Pathname.new(description_xml_path)
-                              .relative_path_from(stepmod_path),
-                )
-                next unless concept
-
-                current_part_modules_arm[linkend_schema] ||= Glossarist::Collection.new
-                find_or_initialize_concept(
-                  current_part_modules_arm[linkend_schema], concept
-                )
-                # puts part_modules_arm.inspect
-                parsed_bibliography << bibdata
+            exp_annotated_path =
+              "#{stepmod_path}/modules/#{schema_name}/arm_annotated.exp"
+
+            log "INFO: Processing modules schema #{exp_annotated_path}"
+
+            if File.exists?(exp_annotated_path)
+              repo = Expressir::Express::Parser.from_file(exp_annotated_path)
+
+              repo.schemas.each do |schema|
+                schema.entities.each do |entity|
+                  old_definition = entity.remarks.first
+
+                  domain = "application module: #{schema.id}"
+                  entity_definition = generate_entity_definition(entity, domain, old_definition)
+
+                  reference_anchor = bibdata.anchor
+                  reference_clause = nil
+
+                  concept = Stepmod::Utils::Concept.new(
+                    designations: [entity.id],
+                    definition: old_definition,
+                    converted_definition: entity_definition,
+                    id: "#{reference_anchor}.#{reference_clause}",
+                    reference_anchor: reference_anchor,
+                    reference_clause: reference_clause,
+                    file_path: Pathname.new(file_path)
+                                .relative_path_from(stepmod_path),
+                    language_code: "en",
+                  )
+
+                  next unless concept
+
+                  current_part_modules_arm[schema.id] ||=
+                    Glossarist::Collection.new
+                  find_or_initialize_concept(
+                    current_part_modules_arm[schema.id], concept
+                  )
+
+                  # puts part_modules_arm.inspect
+                  parsed_bibliography << bibdata
+                end
               end
             end
 
-            description_xml_path = "#{stepmod_path}/modules/#{schema_name}/mim_descriptions.xml"
-            log "INFO: Processing modules schema #{description_xml_path}"
-
-            if File.exists?(description_xml_path)
-              description_document = Nokogiri::XML(
-                File.read(description_xml_path),
-              )
-                .root
-              description_document.xpath("//ext_description").each do |ext_description|
-                linkend_schema = ext_description["linkend"].split(".").first
-
-                concept = Stepmod::Utils::Concept.parse(
-                  ext_description,
-                  reference_anchor: bibdata.anchor,
-                  reference_clause: nil,
-                  file_path: Pathname
-                              .new(description_xml_path)
-                              .relative_path_from(stepmod_path),
-                )
-                next unless concept
-
-                current_part_modules_mim[linkend_schema] ||=
-                  Glossarist::Collection.new
-                find_or_initialize_concept(
-                  current_part_modules_mim[linkend_schema], concept
-                )
-
-                parsed_bibliography << bibdata
+            mim_exp_annotated_path = "#{stepmod_path}/modules/#{schema_name}/mim_annotated.exp"
+
+            log "INFO: Processing modules schema #{mim_exp_annotated_path}"
+
+            if File.exists?(mim_exp_annotated_path)
+              repo = Expressir::Express::Parser.from_file(mim_exp_annotated_path)
+
+              repo.schemas.each do |schema|
+                schema.entities.each do |entity|
+                  old_definition = entity.remarks.first
+
+                  domain = "application module: #{schema.id}"
+                  definition = generate_entity_definition(entity, domain, old_definition)
+
+                  reference_anchor = bibdata.anchor
+                  reference_clause = nil
+
+                  concept = Stepmod::Utils::Concept.new(
+                    designations: [entity.id],
+                    definition: old_definition,
+                    converted_definition: definition,
+                    id: "#{reference_anchor}.#{reference_clause}",
+                    reference_anchor: reference_anchor,
+                    reference_clause: reference_clause,
+                    file_path: Pathname.new(file_path)
+                                .relative_path_from(stepmod_path),
+                    language_code: "en",
+                  )
+
+                  next unless concept
+
+                  current_part_modules_mim[schema.id] ||=
+                    Glossarist::Collection.new
+                  find_or_initialize_concept(
+                    current_part_modules_mim[schema.id], concept
+                  )
+
+                  parsed_bibliography << bibdata
+                end
               end
             end
 
@@ -371,10 +390,73 @@ module Stepmod
       end
 
       def find_or_initialize_concept(collection, localized_concept)
+        concept_id = SecureRandom.uuid
+
         concept = collection
-          .store(Glossarist::Concept.new(id: SecureRandom.uuid))
+          .store(Glossarist::Concept.new(id: concept_id))
         concept.add_l10n(localized_concept)
       end
+
+      # rubocop:disable Layout/LineLength
+      def generate_entity_definition(entity, domain, old_definition)
+        return "" if entity.nil?
+
+        entity_text = if entity.subtype_of.size.zero?
+                        "entity data type that represents " +
+                        entity.id.indefinite_article + " **#{entity.id}** entity"
+                      else
+                        "entity data type that is a type of "+
+                        "**#{entity.subtype_of.map(&:id).join('** and **')}** that represents " +
+                        entity.id.indefinite_article + " **#{entity.id}** entity"
+                      end
+
+        definition = <<~DEFINITION
+          === #{entity.id}
+          domain:[#{domain}]
+
+          #{entity_text}
+
+        DEFINITION
+
+        unless old_definition.nil? || old_definition.blank?
+          definition << <<~OLD_DEFINITION
+            [NOTE]
+            --
+            #{old_definition&.strip}
+            --
+          OLD_DEFINITION
+        end
+
+        # We no longer add Notes and Examples to the extracted terms
+        # definition + format_remark_items(entity.remark_items)
+
+        definition
+      end
+
+      def format_remark_items(remark_items)
+        notes = remark_items.detect { |i| i.id == "__note" }&.remarks
+        examples = remark_items.detect { |i| i.id == "__example" }&.remarks
+
+        formatted_notes = format_remarks(notes, "NOTE", "--")
+        formatted_examples = format_remarks(examples, "example", "====")
+
+        formatted_notes + formatted_examples
+      end
+      # rubocop:enable Layout/LineLength
+
+      def format_remarks(remarks, remark_item_name, remark_item_symbol)
+        return "" if remarks.nil?
+
+        remarks.map do |remark|
+          <<~REMARK
+
+            [#{remark_item_name}]
+            #{remark_item_symbol}
+            #{remark}
+            #{remark_item_symbol}
+          REMARK
+        end.join
+      end
     end
   end
 end

data/lib/stepmod/utils/version.rb

@@ -1,5 +1,5 @@
 module Stepmod
   module Utils
-    VERSION = "0.3.14".freeze
+    VERSION = "0.3.17".freeze
   end
 end

data/stepmod-utils.gemspec

@@ -32,7 +32,9 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_runtime_dependency "concurrent-ruby"
+  spec.add_runtime_dependency "expressir"
   spec.add_runtime_dependency "glossarist", "~> 0.1.0"
+  spec.add_runtime_dependency "indefinite_article"
   spec.add_runtime_dependency "ptools"
   spec.add_runtime_dependency "reverse_adoc", ">= 0.3.5"
   spec.add_runtime_dependency "thor", ">= 0.20.3"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stepmod-utils
 version: !ruby/object:Gem::Version
-  version: 0.3.14
+  version: 0.3.17
 platform: ruby
 authors:
 - Ribose Inc.
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-16 00:00:00.000000000 Z
+date: 2022-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: expressir
+  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: glossarist
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: indefinite_article
+  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: ptools
   requirement: !ruby/object:Gem::Requirement
@@ -178,7 +206,9 @@ files:
 - lib/stepmod/utils/converters/em_express_description.rb
 - lib/stepmod/utils/converters/eqn.rb
 - lib/stepmod/utils/converters/example.rb
+- lib/stepmod/utils/converters/express_example.rb
 - lib/stepmod/utils/converters/express_g.rb
+- lib/stepmod/utils/converters/express_note.rb
 - lib/stepmod/utils/converters/express_ref.rb
 - lib/stepmod/utils/converters/express_ref_express_description.rb
 - lib/stepmod/utils/converters/ext_description.rb
@@ -190,6 +220,7 @@ files:
 - lib/stepmod/utils/converters/ignore.rb
 - lib/stepmod/utils/converters/introduction.rb
 - lib/stepmod/utils/converters/module_ref.rb
+- lib/stepmod/utils/converters/module_ref_express_description.rb
 - lib/stepmod/utils/converters/note.rb
 - lib/stepmod/utils/converters/ol.rb
 - lib/stepmod/utils/converters/p.rb
@@ -213,6 +244,7 @@ files:
 - lib/stepmod/utils/smrl_resource_converter.rb
 - lib/stepmod/utils/stepmod_definition_converter.rb
 - lib/stepmod/utils/stepmod_file_annotator.rb
+- lib/stepmod/utils/term.rb
 - lib/stepmod/utils/terms_extractor.rb
 - lib/stepmod/utils/version.rb
 - resource_example.xml
@@ -221,7 +253,7 @@ homepage: https://github.com/metanorma/stepmod-utils
 licenses:
 - BSD-2-Clause
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -236,8 +268,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Stepmod-utils is a toolkit that works on STEPmod data.
 test_files: []