metanorma-plugin-lutaml 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfe1f241f558def33ef0fc13446d842d50aac1b1003cade580fa3b62e730b722
-  data.tar.gz: 2d12efe1688915194f16cd857e6ca4deaf9852b98407112363bf106dcf3e60a9
+  metadata.gz: a594ac058de2a8fc661fa9354e32c3e53cbba9ba831eb2241866c3fe50fef39e
+  data.tar.gz: c9ccd2ad0f3d8bcb39da897b733f0c84a8aebf2b434f0c05e4229700e96b1042
 SHA512:
-  metadata.gz: d6c46b1d885bc2cb06ea76c4dd5ff057e2b2944579403c8582b43e8a66fe5cb67046b49c1d00526410aba63c0f1614900d3a65e681d67e5f75a3d9b66fc18fd9
-  data.tar.gz: 3da558c2e348387e60bdc1d0b079150c032e11dcf60731b8083b766dc129b10322c9e3f06892bfc06b8524df1ad453ed1d519153b19f55c7b34734ed20e4f614
+  metadata.gz: 2761bf514acf0b0861a18c7d9182834868d3061e8720373e2e57bf5f31216e7a5c66e08fee6069f93c59074c352b8f4fb6f416cbd5a1644df0d55dc6db59860e
+  data.tar.gz: 86489b0e1915b61997af3f55388ea4b788fe505188caca2efd40589b67c1ba4e9a0acba591d111c0af7c4943dbad1a3bd69dc0c0dd737663e93b1ada5436d046

data/README.adoc

@@ -64,9 +64,19 @@ Where:
 
 * content within the block is called the "`template`";
 
-* `{example.exp}` is the location of the exp schema file that contains data to be loaded. Location of the file is computed relative to the source directory that `[lutaml]` is used (e.g., if `[lutaml,example.exp,my_context]` is invoked in an `.adoc` file located at `/foo/bar/doc.adoc`, the data file is expected to be found at `/foo/bar/example.exp`);
-
-* `{my_context}` is the name where the EXPRESS Repository read from the .exp file can be accessed with. Context object is a serialized  Expressir::Model::Repository object with all variable names available. See https://github.com/lutaml/expressir[Expressir] docs for reference. `{my_context}` has `schemas` method to access Expressir https://github.com/lutaml/expressir/blob/master/lib/expressir/model/schema.rb[schemas]
+* `{example.exp}` is the location of the EXPRESS schema file (`*.exp`) that
+contains data to be loaded. Location of the file is computed relative to the
+source directory that `[lutaml]` is used (e.g., if
+`[lutaml,example.exp,my_context]` is invoked in an `.adoc` file located at
+`/foo/bar/doc.adoc`, the data file is expected to be found at
+`/foo/bar/example.exp`);
+
+* `{my_context}` is the name where the EXPRESS Repository read from the .exp
+file can be accessed with. Context object is a serialized
+`Expressir::Model::Repository` object with all variable names available. See
+https://github.com/lutaml/expressir[Expressir] docs for reference.
+`{my_context}` has `schemas` method to access Expressir
+https://github.com/lutaml/expressir/blob/master/lib/expressir/model/schema.rb[schemas]
 
 Will produce this output:
 
@@ -83,7 +93,11 @@ Will produce this output:
 
 This macro also supports `.lutaml` files.
 
-Instead of using the direct path to the file one can use `lutaml-express-index` document attribute to supply directory with express files or yaml index file to parse as well as the cache file location. The syntax is as follows:
+Instead of using the direct path to the file one can use `lutaml-express-index`
+document attribute to supply directory with express files or YAML index file to
+parse as well as the cache file location.
+
+The syntax is as follows:
 
 [source,adoc]
 -----
@@ -92,13 +106,15 @@ Instead of using the direct path to the file one can use `lutaml-express-index`
 
 Where:
 
-* `my_custom_name` - is name of the parsed express files context for the later use with lutaml macro
+* `my_custom_name` - is name of the parsed EXPRESS files context for the later
+use with lutaml macro
 
-* `dir_or_index_path` - location of directory with express files or path to yaml index file to parse
+* `dir_or_index_path` - location of directory with EXPRESS files or path to the
+YAML index file to parse
 
-* `cache_path` - optional, location of the expressir cache file to use
+* `cache_path` - optional, location of the Expressir cache file to use
 
-Example of real usage:
+Example of usage:
 
 [source,adoc]
 -----
@@ -113,9 +129,75 @@ Author
 ----
 -----
 
+=== Usage, `lutaml_diagram` macro
+
+This macro allows to quickly render lutaml file as diagram image.
+Given `example.lutaml` file with the content:
+
+[source,java]
+----
+diagram MyView {
+  title "my diagram"
+
+  enum AddressClassProfile {
+    imlicistAttributeProfile: CharacterString [0..1] {
+      definition
+        this is multiline with `ascidoc`
+      end definition
+    }
+  }
+
+  class AttributeProfile {
+    +addressClassProfile: CharacterString [0..1]
+    imlicistAttributeProfile: CharacterString [0..1] {
+      definition this is attribute definition
+    }
+  }
+}
+----
+
+And the `lutaml_diagram` macro:
+
+[source,adoc]
+-----
+lutaml_diagram::example.lutaml[]
+-----
+
+Will add diagram image to the document
+
+Also one can use `lutaml_diagram` block with embed lutaml code instead of block macro. Example:
+
+[source,java]
+----
+[lutaml_diagram]
+....
+diagram MyView {
+  title "my diagram"
+
+  enum AddressClassProfile {
+    imlicistAttributeProfile: CharacterString [0..1] {
+      definition
+        this is multiline with `ascidoc`
+      end definition
+    }
+  }
+
+  class AttributeProfile {
+    +addressClassProfile: CharacterString [0..1]
+    imlicistAttributeProfile: CharacterString [0..1] {
+      definition this is attribute definition
+    }
+  }
+}
+....
+----
+
+
 === Usage, `lutaml_uml_attributes_table` macro
 
-This macro allows to quickly render datamodel attributes/values tables. Given `example.lutaml` file with the content:
+This macro allows to quickly render data model attributes/values tables.
+
+Given `example.lutaml` file with the content:
 
 [source,java]
 ----
@@ -187,6 +269,193 @@ Will produce this output:
 |===
 -----
 
+=== Usage, `lutaml_uml_datamodel_description` macro
+
+This macro allows to quickly render data model packages and its dependent
+objects for supplied XMI file.
+
+Given an Enterprise Architect `example.xmi` file with 2 packages:
+
+* 'Another'
+* 'CityGML'
+
+The `lutaml_uml_datamodel_description` macro can be used:
+
+[source,adoc]
+-----
+[lutaml_uml_datamodel_description, path/to/example.xmi]
+--
+--
+[.before]
+---
+my text
+---
+
+[.before, package="Another"]
+---
+text before Another package
+---
+
+[.after, package="Another"]
+---
+text after Another package
+---
+
+[.after, package="CityGML"]
+---
+text after CityGML package
+---
+
+[.after]
+---
+footer text
+---
+--
+--
+-----
+
+Where:
+
+* `path/to/example.xmi` - required, path to the XMI file to render
+
+* `[.before]` - macro to add additional text before the rendered output, can be used only once, additional occurrences of macro will overwrite text
+
+* `[.after]` - macro to add additional text after the rendered output, can be used only once, additional occurrences of macro will overwrite text
+
+* `[.after, package="Another"]` - macro with text to be inserted before(after in case of `.before` name) the package
+
+
+Will produce this output:
+
+[source,adoc]
+-----
+= preface
+my text
+
+text before Another package
+
+=== Another
+
+[[rc_another-model_section]]
+==== Another
+
+==== Requirements
+
+==== Class Definitions
+
+.Classes used in Another
+[cols="2a,6a",options="header"]
+|===
+|Class |Description
+
+
+|<<AbstractAtomicTimeseries-section,AbstractAtomicTimeseries>>
+«»
+|
+
+
+|<<AbstractTimeseries-section,AbstractTimeseries>>
+«»
+|
+
+....
+|===
+
+
+
+.Data Types used in Another
+[cols="2,6",options="header"]
+|===
+|Name |Description
+
+
+|<<ADEOfAbstractAtomicTimeseries-section,ADEOfAbstractAtomicTimeseries>>
+|
+
+
+|<<ADEOfAbstractTimeseries-section,ADEOfAbstractTimeseries>>
+|
+
+....
+|===
+
+
+
+.Enumerated Classes used in Another
+[cols="2a,6a",options="header"]
+|===
+|Name |Description
+
+|<<TimeseriesTypeValue-section,TimeseriesTypeValue>>
+|
+
+|===
+
+
+==== Additional Information
+
+text after Another package
+
+
+=== CityGML
+
+[[rc_citygml-model_section]]
+==== CityGML
+
+==== Requirements
+
+==== Class Definitions
+
+==== Additional Information
+
+text after CityGML package
+
+
+= footer
+footer text
+
+-----
+
+In addition to just supplying XMI file, this macro also supports YAML
+configuration file.
+
+The format for using YAML is this:
+
+[source,yaml]
+-----
+---
+packages:
+  # includes these packages
+  - "Package *"
+  - two*
+  - three
+  # skips these packages
+  - skip: four
+-----
+
+Where:
+
+* `packages` - required, root element with the list of strings or objects
+
+* `Package *` - pattern matching, specifies lookup condition for packages to
+render.
++
+NOTE: In this example, it is equal to the following regular expression: `/^Package.*$/`
+
+* `skip: four` - object with package name to skip
+
+Usage with macro:
+
+[source,adoc]
+-----
+[lutaml_uml_datamodel_description, path/to/example.xmi, path/to/config.yml]
+....
+-----
+
+The macro processor will read supplied YAML file and arrange packages according
+to the order supplied in the config file, also all packages supplied as `skip`
+will be skipped during render
+
 == Documentation
 
-See https://www.metanorma.com.
+Please refer to https://www.metanorma.com.

data/lib/metanorma-plugin-lutaml.rb

@@ -1,7 +1,9 @@
 require "metanorma/plugin/lutaml/version"
 require "metanorma/plugin/lutaml/lutaml_preprocessor"
 require "metanorma/plugin/lutaml/lutaml_uml_attributes_table_preprocessor"
+require "metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor"
 require "metanorma/plugin/lutaml/lutaml_diagram_block"
+require "metanorma/plugin/lutaml/lutaml_diagram_block_macro"
 
 module Metanorma
   module Plugin

data/lib/metanorma/plugin/lutaml/liquid_templates/_packages.liquid

@@ -0,0 +1,108 @@
+{% for package in context.packages %}
+{% assign before_package_key = 'before;' | append: package.name %}
+{% if additional_context[before_package_key] %}
+{{ additional_context[before_package_key] }}
+{% endif %}
+{% assign is_package_spare = package.name | slice: 0,5 %}
+{% if is_package_spare == 'old: ' %}{% continue %}
+{% elsif is_package_spare == 'Spare' %}{% continue %}
+{% endif %}
+{% assign package_name = package.name | downcase | replace: ":", "" | replace: " ", "_" %}
+
+{% capture equalsigns %}{% for count in (1..depth) %}={% endfor %}{% endcapture %}{{equalsigns}} {{ package.name }} package
+{{equalsigns}}= {{ package.name }} overview
+
+// TODO: include blocks by base path
+//{% for diagram in package.diagrams %}
+//[[figure-{{ diagram.xmi_id }}]]
+//.{{ diagram.name }}
+//image::../../xmi-19170-only/Images/{{ diagram.xmi_id }}.png[]
+//
+//{% if diagram.definition %}
+//{{ diagram.definition | html2adoc }}
+//{% endif %}
+//{% endfor %}
+
+{% if package.packages.size > 0 %}The {{ package.name }} package is organized into
+{{ package.packages.size }} packages{% assign modules_nested_size = 0 %}{% for module in package.packages %}{% assign modules_nested_size = modules_nested_size | plus: module.packages.size %}{% endfor %}{% if modules_nested_size > 0 %} with {{modules_nested_size}} modules{% endif %}:
+{% endif %}
+[arabic]
+{% for module in package.packages %}
+{% if module.packages.length > 0 %}
+. {{ module.name }} package comprises:
+{% for nested_module in module.packages %}
+.. {{nested_module.name}} module
+{% endfor %}
+{% else %}
+. {{ module.name }} package
+{% endif %}
+{% endfor %}
+
+{% if package.classes.size > 0 %}
+
+{{equalsigns}}= Defining tables
+
+[arabic]
+{% for klass in package.classes %}
+{% assign is_klass_spare = klass.name | slice: 0,5 %}
+{% if is_klass_spare == 'old: ' %}{% continue %}
+{% elsif is_klass_spare == 'Spare' %}{% continue %}
+{% endif %}
+{% assign klass_name = klass.name | downcase | replace: ':', '' | replace: ' ', '_' %}
+.<<tab-P-{{ package_name }}-C-{{ klass_name }}>> -- Elements of {{ package.name }}::{{ klass.name }}
+
+{% endfor %}
+{% for enum in package.enums %}
+{% assign is_enum_spare = enum.name | slice: 0,5 %}
+{% if is_enum_spare == 'old: ' %}{% continue %}
+{% elsif is_enum_spare == 'Spare' %}{% continue %}
+{% endif %}
+{% assign enum_name = enum.name | downcase | replace: ':', '' | replace: ' ', '_' %}
+.<<tab-P-{{ package_name }}-E-{{ enum_name }}>> -- Elements of {{ package.name }}::{{ enum.name }}
+
+{% endfor %}
+{% for data_type in package.data_types %}
+{% assign is_data_type_spare = data_type.name | slice: 0,5 %}
+{% if is_data_type_spare == 'old: ' %}{% continue %}
+{% elsif is_data_type_spare == 'Spare' %}{% continue %}
+{% endif %}
+{% assign data_type_name = data_type.name | downcase | replace: ':', '' | replace: ' ', '_' %}
+.<<tab-P-{{ package_name }}-DT-{{ data_type_name }}>> -- Elements of {{ package.name }}::{{ data_type.name }}
+
+{% endfor %}
+
+{% for klass in package.classes %}
+{% include "packages_class" %}
+{% endfor %}
+
+{% for klass in package.enums %}
+{% include "packages_enum" %}
+{% endfor %}
+
+{% for klass in package.data_types %}
+{% include "packages_data_type" %}
+{% endfor %}
+
+// TODO: include blocks by base path
+// {% capture requirement_filename %}requirements/REQ_{{ package_name }}{% endcapture %}
+// {% capture requirement_content %}{% include requirement_filename %}{% endcapture %}
+// {% unless requirement_content contains "Liquid error" %}
+// The following requirements apply:
+// {{ requirement_content }}
+//
+// {% for num in (1..5) %}
+// {% capture nested_requirement_filename %}requirements/REQ_{{ package_name }}_{{num}}{% endcapture %}
+// {% capture nested_requirement_content %}{% include nested_requirement_filename %}{% endcapture %}
+// {% unless nested_requirement_content contains "Liquid error" %}
+// {{ nested_requirement_content }}
+// {% endunless %}
+// {% endfor %}
+// {% endunless %}
+
+{% endif %}
+{% assign after_package_key = 'after;' | append: package.name %}
+{{equalsigns}}= Additional Information
+{% if additional_context[after_package_key] %}
+{{ additional_context[after_package_key] }}
+{% endif %}
+{% endfor %}

data/lib/metanorma/plugin/lutaml/liquid_templates/_packages_class.liquid

@@ -0,0 +1,81 @@
+{% assign is_klass_spare = klass.name | slice: 0,5 %}
+{% if is_klass_spare == 'old: ' %}{% continue %}
+{% elsif is_klass_spare == 'Spare' %}{% continue %}
+{% endif %}
+{% assign klass_name = klass.name | downcase | replace: ':', '' | replace: ' ', '_' %}
+[[tab-P-{{ package_name }}-C-{{ klass_name }}]]
+.Elements of {{ package.name }}::{{ klass.name }}
+[width="100%",cols="a,a,a,a,a,a,a,a"]
+|===
+
+h|Name: 7+| {{ klass.name }}
+
+h|Definition: 7+| {{ klass.definition | html2adoc }}
+
+h|Stereotype: 7+| {{ klass.stereotype | default: 'interface' }}
+
+{% assign inherited = klass.associations | where: "member_end_type", "inheritance" %}
+{% if inherited.size > 0 %}
+h|Inheritance from: 7+| {{ inherited | map: 'member_end' | join: ", " }}
+{% endif %}
+
+{% assign generalizations = klass.associations | where: "member_end_type", "generalization" %}
+{% if generalizations.size > 0 %}
+h|Generalization of: 7+| {{ generalizations | map: 'member_end' | join: ", " }}
+{% endif %}
+
+h|Abstract: 7+| {{ klass.is_abstract }}
+{% assign aggregations = klass.associations | where: "member_end_type", "aggregation" %}
+{% if aggregations.size > 0 %}
+.{{aggregations.size | plus: 1}}+h|Associations:
+4+|_Association with:_
+|_Obligation_
+| _Maximum occurrence_
+|_Provides:_
+
+{% for assoc in aggregations %}
+4+| {{assoc.member_end}}
+| {% if assoc.member_end_cardinality %}{{ assoc.member_end_cardinality.min }}{% endif %}
+| {% if assoc.member_end_cardinality %}{{ assoc.member_end_cardinality.max }}{% endif %}
+| {{ assoc.member_end_attribute_name }}
+
+{% endfor %}
+{% else %}
+
+.1+h|Associations: 7+| (none)
+{% endif %}
+{% if klass.attributes.size > 0 %}
+.{{klass.attributes.size | plus: 1}}+h|Public attributes:
+| _Name_
+2+| _Definition_
+| _Derived_
+| _Obligation_
+| _Maximum occurrence_
+| _Data type_
+
+{% for attr in klass.attributes %}
+| {{attr.name}}
+2+| {{ attr.definition | html2adoc }}
+| {{ attr.is_derived }}
+| {{attr.cardinality.min}}
+| {{attr.cardinality.max}}
+| {{attr.type}}
+
+{% endfor %}
+{% else %}
+.1+h|Public attributes:
+7+| (none)
+{% endif %}
+
+{% if klass.constraints.size > 0 %}
+.{{ klass.constraints.size }}+|*Constraints:*
+{% for constr in klass.constraints %}
+7+| `{{ constr.body }}`
+
+{% endfor %}
+{% else %}
+
+h|Constraints: 7+| (none)
+{% endif %}
+
+|===

data/lib/metanorma/plugin/lutaml/liquid_templates/_packages_data_type.liquid

@@ -0,0 +1,63 @@
+{% assign is_klass_spare = klass.name | slice: 0,5 %}
+{% if is_klass_spare == 'old: ' %}{% continue %}
+{% elsif is_klass_spare == 'Spare' %}{% continue %}
+{% endif %}
+{% assign klass_name = klass.name | downcase | replace: ':', '' | replace: ' ', '_' %}
+[[tab-P-{{ package_name }}-DT-{{ klass_name }}]]
+.Elements of {{ package.name }}::{{ klass.name }}
+[width="100%",cols="a,a,a,a,a,a,a,a"]
+|===
+
+h|Name: 7+| {{ klass.name }}
+
+h|Definition: 7+| {{ klass.definition | html2adoc }}
+
+h|Stereotype: 7+| {{ klass.stereotype | default: 'interface' }}
+
+{% assign inherited = klass.associations | where: "member_end_type", "inheritance" %}
+{% if inherited.size > 0 %}
+h|Inheritance from: 7+| {{ inherited | map: 'member_end' | join: ", " }}
+{% endif %}
+
+{% assign generalizations = klass.associations | where: "member_end_type", "generalization" %}
+{% if generalizations.size > 0 %}
+h|Generalization of: 7+| {{ generalizations | map: 'member_end' | join: ", " }}
+{% endif %}
+
+h|Abstract: 7+| {{ klass.is_abstract }}
+{% assign aggregations = klass.associations | where: "member_end_type", "aggregation" %}
+{% if aggregations.size > 0 %}
+.{{aggregations.size | plus: 1}}+h|Associations:
+4+|_Association with:_
+|_Obligation_
+| _Maximum occurrence_
+|_Provides:_
+
+{% for assoc in aggregations %}
+4+| {{assoc.member_end}}
+| {% if assoc.member_end_cardinality %}{{ assoc.member_end_cardinality.min }}{% endif %}
+| {% if assoc.member_end_cardinality %}{{ assoc.member_end_cardinality.max }}{% endif %}
+| {{ assoc.member_end_attribute_name }}
+
+{% endfor %}
+{% else %}
+
+.1+h|Associations: 7+| (none)
+{% endif %}
+
+{% if klass.attributes.size > 0 %}
+.{{klass.attributes.size | plus: 1}}+h|Values:
+| _Name_
+6+| _Definition_
+
+{% for value in klass.attributes %}
+| {{value.name}}
+6+| {{ value.definition | html2adoc }}
+
+{% endfor %}
+{% else %}
+.1+h|Values:
+7+| (none)
+{% endif %}
+
+|===

data/lib/metanorma/plugin/lutaml/liquid_templates/_packages_enum.liquid

@@ -0,0 +1,63 @@
+{% assign is_klass_spare = klass.name | slice: 0,5 %}
+{% if is_klass_spare == 'old: ' %}{% continue %}
+{% elsif is_klass_spare == 'Spare' %}{% continue %}
+{% endif %}
+{% assign klass_name = klass.name | downcase | replace: ':', '' | replace: ' ', '_' %}
+[[tab-P-{{ package_name }}-E-{{ klass_name }}]]
+.Elements of {{ package.name }}::{{ klass.name }}
+[width="100%",cols="a,a,a,a,a,a,a,a"]
+|===
+
+h|Name: 7+| {{ klass.name }}
+
+h|Definition: 7+| {{ klass.definition | html2adoc }}
+
+h|Stereotype: 7+| {{ klass.stereotype | default: 'interface' }}
+
+{% assign inherited = klass.associations | where: "member_end_type", "inheritance" %}
+{% if inherited.size > 0 %}
+h|Inheritance from: 7+| {{ inherited | map: 'member_end' | join: ", " }}
+{% endif %}
+
+{% assign generalizations = klass.associations | where: "member_end_type", "generalization" %}
+{% if generalizations.size > 0 %}
+h|Generalization of: 7+| {{ generalizations | map: 'member_end' | join: ", " }}
+{% endif %}
+
+h|Abstract: 7+| {{ klass.is_abstract }}
+{% assign aggregations = klass.associations | where: "member_end_type", "aggregation" %}
+{% if aggregations.size > 0 %}
+.{{aggregations.size | plus: 1}}+h|Associations:
+4+|_Association with:_
+|_Obligation_
+| _Maximum occurrence_
+|_Provides:_
+
+{% for assoc in aggregations %}
+4+| {{assoc.member_end}}
+| {% if assoc.member_end_cardinality %}{{ assoc.member_end_cardinality.min }}{% endif %}
+| {% if assoc.member_end_cardinality %}{{ assoc.member_end_cardinality.max }}{% endif %}
+| {{ assoc.member_end_attribute_name }}
+
+{% endfor %}
+{% else %}
+
+.1+h|Associations: 7+| (none)
+{% endif %}
+{% if klass.values.size > 0 %}
+.{{klass.values.size | plus: 1}}+h|Values:
+| _Name_
+6+| _Definition_
+
+{% for value in klass.values %}
+| {{value.name}}
+6+| {{ value.definition | html2adoc }}
+
+{% endfor %}
+{% else %}
+.1+h|Values:
+7+| (none)
+{% endif %}
+
+
+|===

data/lib/metanorma/plugin/lutaml/lutaml_diagram_base.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "liquid"
+require "asciidoctor"
+require "asciidoctor/reader"
+require "lutaml"
+require "lutaml/uml"
+require "metanorma/plugin/lutaml/utils"
+
+module Metanorma
+  module Plugin
+    module Lutaml
+      module LutamlDiagramBase
+        def process(parent, reader, attrs)
+          uml_document = ::Lutaml::Uml::Parsers::Dsl.parse(lutaml_file(parent.document, reader))
+          filename = generate_file(parent, reader, uml_document)
+          through_attrs = generate_attrs(attrs)
+          through_attrs["target"] = filename
+          through_attrs["title"] = uml_document.caption
+          create_image_block(parent, through_attrs)
+        rescue StandardError => e
+          abort(parent, reader, attrs, e.message)
+        end
+
+        def lutaml_file(reader)
+          raise 'Implement me!'
+        end
+
+        protected
+
+        def abort(parent, reader, attrs, msg)
+          warn(msg)
+          attrs["language"] = "lutaml"
+          source = reader.respond_to?(:source) ? reader.source : reader
+          create_listing_block(
+            parent,
+            source,
+            attrs.reject { |k, _v| k == 1 }
+          )
+        end
+
+        # if no :imagesdir: leave image file in lutaml
+        def generate_file(parent, _reader, uml_document)
+          formatter = ::Lutaml::Uml::Formatter::Graphviz.new
+          formatter.type = :png
+
+          imagesdir = if parent.document.attr("imagesdir")
+                        File.join(parent.document.attr("imagesdir"), "lutaml")
+                      else
+                        "lutaml"
+                      end
+          result_path = Utils.relative_file_path(parent.document, imagesdir)
+          result_pathname = Pathname.new(result_path)
+          result_pathname.mkpath
+          File.writable?(result_pathname) || raise("Destination path #{result_path} not writable for Lutaml!")
+
+          outfile = Tempfile.new(["lutaml", ".png"])
+          outfile.binmode
+          outfile.puts(formatter.format(uml_document))
+
+          # Warning: metanorma/metanorma-standoc#187
+          # Windows Ruby 2.4 will crash if a Tempfile is "mv"ed.
+          # This is why we need to copy and then unlink.
+          filename = File.basename(outfile.path)
+          FileUtils.cp(outfile, result_pathname) && outfile.unlink
+
+          File.join(result_pathname, filename)
+        end
+
+        def generate_attrs(attrs)
+          %w(id align float title role width height alt)
+            .reduce({}) do |memo, key|
+              memo[key] = attrs[key] if attrs.has_key? key
+              memo
+            end
+        end
+      end
+    end
+  end
+end

data/lib/metanorma/plugin/lutaml/lutaml_diagram_block.rb

@@ -1,40 +1,21 @@
 # frozen_string_literal: true
 
-require "liquid"
-require "asciidoctor"
-require "asciidoctor/reader"
-require "lutaml"
-require "lutaml/uml"
-require "metanorma/plugin/lutaml/utils"
+require "metanorma/plugin/lutaml/lutaml_diagram_base"
 
 module Metanorma
   module Plugin
     module Lutaml
       class LutamlDiagramBlock < Asciidoctor::Extensions::BlockProcessor
+        include LutamlDiagramBase
+
         use_dsl
         named :lutaml_diagram
         on_context :literal
         parse_content_as :raw
 
-        def abort(parent, reader, attrs, msg)
-          warn(msg)
-          attrs["language"] = "lutaml"
-          create_listing_block(
-            parent,
-            reader.source,
-            attrs.reject { |k, _v| k == 1 }
-          )
-        end
+        def lutaml_file(document, reader)
 
-        def process(parent, reader, attrs)
-          uml_document = ::Lutaml::Uml::Parsers::Dsl.parse(lutaml_temp(parent.document, reader))
-          filename = generate_file(parent, reader, uml_document)
-          through_attrs = generate_attrs(attrs)
-          through_attrs["target"] = filename
-          through_attrs["title"] = uml_document.caption
-          create_image_block(parent, through_attrs)
-        rescue StandardError => e
-          abort(parent, reader, attrs, e.message)
+          lutaml_temp(document, reader)
         end
 
         private
@@ -45,42 +26,6 @@ module Metanorma
           temp_file.rewind
           temp_file
         end
-
-        # if no :imagesdir: leave image file in lutaml
-        def generate_file(parent, _reader, uml_document)
-          formatter = ::Lutaml::Uml::Formatter::Graphviz.new
-          formatter.type = :png
-
-          imagesdir = if parent.document.attr("imagesdir")
-                        File.join(parent.document.attr("imagesdir"), "lutaml")
-                      else
-                        "lutaml"
-                      end
-          result_path = Utils.relative_file_path(parent.document, imagesdir)
-          result_pathname = Pathname.new(result_path)
-          result_pathname.mkpath
-          File.writable?(result_pathname) || raise("Destination path #{result_path} not writable for Lutaml!")
-
-          outfile = Tempfile.new(["lutaml", ".png"])
-          outfile.binmode
-          outfile.puts(formatter.format(uml_document))
-
-          # Warning: metanorma/metanorma-standoc#187
-          # Windows Ruby 2.4 will crash if a Tempfile is "mv"ed.
-          # This is why we need to copy and then unlink.
-          filename = File.basename(outfile.path)
-          FileUtils.cp(outfile, result_pathname) && outfile.unlink
-
-          File.join(result_pathname, filename)
-        end
-
-        def generate_attrs(attrs)
-          %w(id align float title role width height alt)
-            .reduce({}) do |memo, key|
-              memo[key] = attrs[key] if attrs.has_key? key
-              memo
-            end
-        end
       end
     end
   end

data/lib/metanorma/plugin/lutaml/lutaml_diagram_block_macro.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "metanorma/plugin/lutaml/lutaml_diagram_base"
+
+module Metanorma
+  module Plugin
+    module Lutaml
+      class LutamlDiagramBlockMacro < Asciidoctor::Extensions::BlockMacroProcessor
+        include LutamlDiagramBase
+
+        use_dsl
+        named :lutaml_diagram
+
+        def lutaml_file(document, file_path)
+          File.new(Utils.relative_file_path(document, file_path))
+        end
+      end
+    end
+  end
+end

data/lib/metanorma/plugin/lutaml/lutaml_uml_attributes_table_preprocessor.rb

@@ -89,7 +89,7 @@ module Metanorma
           |Name |Definition |Mandatory/ Optional/ Conditional |Max Occur |Data Type
 
           {% for item in definition.attributes %}
-          |{{ item.name }} |{% if item.definition %}{{ item.definition }}{% else %}TODO: enum {{ key }}'s definition{% endif %} |{% if item.cardinality.min == "0" %}O{% else %}M{% endif %} |{% if item.cardinality.max == "*" %}N{% else %}1{% endif %} |{% if item.origin %}<<{{ item.origin }}>>{% endif %} `{{ item.type }}`
+          |{{ item.name }} |{% if item.definition %}{{ item.definition }}{% endif %} |{% if item.cardinality.min == "0" %}O{% else %}M{% endif %} |{% if item.cardinality.max == "*" %}N{% else %}1{% endif %} |{% if item.origin %}<<{{ item.origin }}>>{% endif %} `{{ item.type }}`
           {% endfor %}
           |===
           {% endif %}

data/lib/metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+require "liquid"
+require "asciidoctor"
+require "asciidoctor/reader"
+require "lutaml"
+require "lutaml/uml"
+require "metanorma/plugin/lutaml/utils"
+
+module Metanorma
+  module Plugin
+    module Lutaml
+      #  Macro for quick rendering of datamodel attributes/values table
+      #  @example [lutaml_uml_attributes_table,path/to/lutaml,EntityName]
+      class LutamlUmlDatamodelDescriptionPreprocessor <
+          Asciidoctor::Extensions::Preprocessor
+        MARCO_REGEXP =
+          /\[lutaml_uml_datamodel_description,([^,]+),?(.+)?\]/
+        SUPPORTED_NESTED_MACROSES = %w[before after].freeze
+        LIQUID_INCLUDE_PATH = File.join(
+          Gem.loaded_specs["metanorma-plugin-lutaml"].full_gem_path,
+          "lib", "metanorma", "plugin", "lutaml", "liquid_templates"
+        )
+        # search document for block `lutaml_uml_datamodel_description`
+        #  read include derectives that goes after that in block and transform
+        #  into yaml2text blocks
+        def process(document, reader)
+          input_lines = reader.readlines.to_enum
+          Asciidoctor::Reader.new(processed_lines(document, input_lines))
+        end
+
+        private
+
+        def lutaml_document_from_file(document, file_path)
+          ::Lutaml::Parser
+            .parse(File.new(Utils.relative_file_path(document, file_path),
+                            encoding: "UTF-8"))
+            .first
+        end
+
+        def parse_yaml_config_file(document, file_path)
+          return {} if file_path.nil?
+
+          relative_file_path = Utils.relative_file_path(document, file_path)
+          YAML.load(File.read(relative_file_path, encoding: "UTF-8"))
+        end
+
+        def processed_lines(document, input_lines)
+          result = []
+          loop do
+            result.push(*process_text_blocks(document, input_lines))
+          end
+          result
+        end
+
+        def process_text_blocks(document, input_lines)
+          line = input_lines.next
+          block_match = line.match(MARCO_REGEXP)
+          return [line] if block_match.nil?
+
+          model_representation(
+            lutaml_document_from_file(document, block_match[1]),
+            document,
+            collect_additional_context(input_lines, input_lines.next),
+            parse_yaml_config_file(document, block_match[2]))
+        end
+
+        def collect_additional_context(input_lines, end_mark)
+          additional_context = {}
+          while (block_line = input_lines.next) != end_mark
+            nested_match = SUPPORTED_NESTED_MACROSES
+              .map { |macro| [macro, block_line.match(/\[.#{macro}(,\s*package=("|')(?<package>.+?)("|'))?\]/)] }
+              .detect { |n| !n.last.nil? }
+            nested_context_value = []
+            if nested_match
+              macro_keyword = [nested_match.first, nested_match.last['package']].compact.join(";")
+              nested_end_mark = input_lines.next
+              while (block_line = input_lines.next) != nested_end_mark
+                nested_context_value.push(block_line)
+              end
+              additional_context[macro_keyword] = nested_context_value
+                .join("\n")
+            end
+          end
+          additional_context
+        end
+
+        def create_context_object(lutaml_document, additional_context, options)
+          root_package = lutaml_document.to_liquid['packages'].first
+          all_packages = [root_package, *root_package['children_packages']]
+          {
+            "packages" => sort_and_filter_out_packages(all_packages, options),
+            "additional_context" => additional_context
+          }
+        end
+
+        def sort_and_filter_out_packages(all_packages, options)
+          return all_packages if options['packages'].nil?
+
+          result = []
+          # Step one - filter out all skipped packages
+          options['packages']
+            .find_all { |entity| entity.is_a?(Hash) && entity['skip'] }
+            .each do |entity|
+              entity_regexp = config_entity_regexp(entity['skip'])
+              all_packages
+                .delete_if {|package| package['name'] =~ entity_regexp }
+            end
+          # Step two - select supplied packages by pattern
+          options['packages']
+            .find_all { |entity| entity.is_a?(String) }
+            .each do |entity|
+              entity_regexp = config_entity_regexp(entity)
+              all_packages.each.with_index do |package|
+                if package['name'] =~ entity_regexp
+                  result.push(package)
+                  all_packages
+                    .delete_if {|nest_package| nest_package['name'] == package['name'] }
+                end
+              end
+            end
+          result
+        end
+
+        def config_entity_regexp(entity)
+          additional_sym = '.*' if entity =~ /\*$/
+          %r{^#{Regexp.escape(entity.gsub('*', ''))}#{additional_sym}$}
+        end
+
+        def model_representation(lutaml_document, document, additional_context, options)
+          render_result, errors = Utils.render_liquid_string(
+            template_string: table_template,
+            context_items: create_context_object(lutaml_document,
+                              additional_context,
+                              options),
+            context_name: "context",
+            document: document,
+            include_path: LIQUID_INCLUDE_PATH
+          )
+          Utils.notify_render_errors(document, errors)
+          render_result.split("\n")
+        end
+
+        def table_template
+          <<~LIQUID
+            {% include "packages", depth: 2, context: context, additional_context: context.additional_context %}
+          LIQUID
+        end
+      end
+    end
+  end
+end

data/lib/metanorma/plugin/lutaml/utils.rb

@@ -22,10 +22,11 @@ module Metanorma
         end
 
         def render_liquid_string(template_string:, context_items:,
-                                 context_name:, document:)
+                                 context_name:, document:, include_path: nil)
           liquid_template = ::Liquid::Template.parse(template_string)
           # Allow includes for the template
-          liquid_template.registers[:file_system] = ::Liquid::LocalFileSystem.new(Utils.relative_file_path(document, ""))
+          include_path ||= Utils.relative_file_path(document, "")
+          liquid_template.registers[:file_system] = ::Liquid::LocalFileSystem.new(include_path)
           rendered_string = liquid_template
             .render(context_name => context_items,
                     strict_variables: true,

data/lib/metanorma/plugin/lutaml/version.rb

@@ -1,7 +1,7 @@
 module Metanorma
   module Plugin
     module Lutaml
-      VERSION = "0.4.2".freeze
+      VERSION = "0.4.3".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-plugin-lutaml
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-07-16 00:00:00.000000000 Z
+date: 2021-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: liquid
@@ -257,9 +257,16 @@ files:
 - lib/metanorma-plugin-lutaml.rb
 - lib/metanorma/plugin/lutaml/express_remarks_decorator.rb
 - lib/metanorma/plugin/lutaml/liquid/custom_filters.rb
+- lib/metanorma/plugin/lutaml/liquid_templates/_packages.liquid
+- lib/metanorma/plugin/lutaml/liquid_templates/_packages_class.liquid
+- lib/metanorma/plugin/lutaml/liquid_templates/_packages_data_type.liquid
+- lib/metanorma/plugin/lutaml/liquid_templates/_packages_enum.liquid
+- lib/metanorma/plugin/lutaml/lutaml_diagram_base.rb
 - lib/metanorma/plugin/lutaml/lutaml_diagram_block.rb
+- lib/metanorma/plugin/lutaml/lutaml_diagram_block_macro.rb
 - lib/metanorma/plugin/lutaml/lutaml_preprocessor.rb
 - lib/metanorma/plugin/lutaml/lutaml_uml_attributes_table_preprocessor.rb
+- lib/metanorma/plugin/lutaml/lutaml_uml_datamodel_description_preprocessor.rb
 - lib/metanorma/plugin/lutaml/utils.rb
 - lib/metanorma/plugin/lutaml/version.rb
 - metanorma-plugin-lutaml.gemspec