lutaml 0.10.13 → 0.10.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66f287c7903f45ebce9fc0abdc3561ad6ef3df65fdb4b437a126685610756df7
-  data.tar.gz: 8459a2ad63cf3e4071c7d56ec4ae105410d3044aad2f05810419d4dd90adf861
+  metadata.gz: cb62e96e62545c49b005e89cc972bc7dfb9510dbd9867831db9b6f4ab0bbcc40
+  data.tar.gz: 3975abff3b9a8e54714a76209d5917ed1bcf291baf9dcdf405c658d211934714
 SHA512:
-  metadata.gz: d395f7c78511a601edef5eab6e96f5f896e46a135675767dfd031df36caaa6cfb34a3e5c834d96feed728760a59bd1fe2321ff2ce25490274d9d2693345eb2aa
-  data.tar.gz: e0ab7f240736d995f948283a9668f578133a39443d95d1889178c7e8c97afb7872d581bc0d8b2d0b79db9c3587087448c82048bb2bce00ee28179b011c422597
+  metadata.gz: a09b2b6074e7fb3fa04d2084b16c35ac5f9c115708ac8f50efaac08b5999cd21613053df9eebe487a714c361317e4411de2ecc8d2286b8100e3fe23102854265
+  data.tar.gz: 6d6c1dd06afac86c94ba1047087914b59b95d09e11308482f90bb3b99b4b65633eb443a565200842f07ce51064b14e2441a4406f408697a8fe55ef67ce33c9eb

data/.rubocop_todo.yml

@@ -1,33 +1,18 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2026-05-12 08:24:03 UTC using RuboCop version 1.86.1.
+# on 2026-05-13 02:18:49 UTC using RuboCop version 1.86.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: EnforcedStyle, IndentationWidth.
-# SupportedStyles: with_first_argument, with_fixed_indentation
-Layout/ArgumentAlignment:
-  Exclude:
-    - 'spec/lutaml/xml/parsers/xsd_spec.rb'
-
-# Offense count: 156
+# Offense count: 155
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AllowInHeredoc.
-Layout/TrailingWhitespace:
-  Exclude:
-    - 'spec/lutaml/xml/parsers/xsd_spec.rb'
-
 # Offense count: 1
 Lint/BinaryOperatorWithIdenticalOperands:
   Exclude:
@@ -87,36 +72,48 @@ Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/lutaml/cli/uml/export_command.rb'
 
-# Offense count: 2
+# Offense count: 3
 Lint/UselessConstantScoping:
   Exclude:
     - 'lib/lutaml/cli/interactive_shell.rb'
+    - 'lib/lutaml/qea/factory/ea_to_uml_factory.rb'
 
-# Offense count: 51
+# Offense count: 8
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
-  Enabled: false
+  Exclude:
+    - 'lib/lutaml/cli/interactive_shell/query_commands.rb'
+    - 'lib/lutaml/qea/factory/generalization_builder.rb'
+    - 'lib/lutaml/uml_repository/exporters/markdown/class_page_builder.rb'
+    - 'lib/lutaml/uml_repository/queries/search_query.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
+    - 'lib/lutaml/xmi/liquid_drops/klass_drop.rb'
 
 # Offense count: 4
-# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
-# AllowedMethods: refine
-Metrics/BlockLength:
-  Max: 53
-
-# Offense count: 35
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
-  Enabled: false
+  Exclude:
+    - 'lib/lutaml/qea/factory/generalization_builder.rb'
+    - 'lib/lutaml/uml_repository/index_builders/association_index.rb'
+    - 'lib/lutaml/uml_repository/queries/search_query.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
 
-# Offense count: 75
+# Offense count: 48
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 62
+  Max: 18
+
+# Offense count: 4
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 7
 
-# Offense count: 26
+# Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
-  Enabled: false
+  Exclude:
+    - 'lib/lutaml/qea/factory/ea_to_uml_factory.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
 
 # Offense count: 3
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
@@ -136,11 +133,10 @@ Naming/PredicateMethod:
     - 'lib/lutaml/qea/factory/document_builder.rb'
     - 'spec/lutaml/xmi/liquid_drops/nil_safety_spec.rb'
 
-# Offense count: 3
+# Offense count: 2
 # Configuration parameters: MinSize.
 Performance/CollectionLiteralInLoop:
   Exclude:
-    - 'lib/lutaml/xmi/parsers/xmi_connector.rb'
     - 'spec/lutaml/qea/infrastructure/table_reader_spec.rb'
     - 'spec/lutaml/uml_repository/index_builder_spec.rb'
 

data/lib/lutaml/cli/interactive_shell/export_handler.rb

@@ -6,32 +6,40 @@ module Lutaml
   module Cli
     class InteractiveShell
       class ExportHandler < CommandBase
+        EXPORT_FORMATS = {
+          "csv" => :export_csv,
+          "json" => :export_json,
+          "yaml" => :export_yaml,
+        }.freeze
+
         def cmd_export(args)
-          if last_results.nil? || last_results.empty?
-            puts OutputFormatter.warning("No results to export")
-            return
-          end
+          return warn_no_results if last_results.nil? || last_results.empty?
+          return warn_export_usage unless valid_export_args?(args)
 
-          if args.size < 3 || args[0] != "last"
-            puts OutputFormatter.warning("Usage: export last FORMAT FILE")
-            return
-          end
+          dispatch_export(args[1].downcase, args[2])
+        end
 
-          format = args[1].downcase
-          file_path = args[2]
+        def valid_export_args?(args)
+          args.size >= 3 && args[0] == "last"
+        end
 
-          case format
-          when "csv"
-            export_csv(file_path)
-          when "json"
-            export_json(file_path)
-          when "yaml"
-            export_yaml(file_path)
+        def dispatch_export(format, file_path)
+          exporter = EXPORT_FORMATS[format]
+          if exporter
+            public_send(exporter, file_path)
           else
             puts OutputFormatter.error("Unsupported format: #{format}")
           end
         end
 
+        def warn_no_results
+          puts OutputFormatter.warning("No results to export")
+        end
+
+        def warn_export_usage
+          puts OutputFormatter.warning("Usage: export last FORMAT FILE")
+        end
+
         def export_csv(file_path)
           require "csv"
 

data/lib/lutaml/cli/interactive_shell/help_display.rb

@@ -8,18 +8,14 @@ module Lutaml
     class InteractiveShell
       class HelpDisplay < CommandBase
         def display_welcome
-          puts OutputFormatter.colorize(
-            "╔═══════════════════════════════════════╗", :cyan
-          )
-          puts OutputFormatter.colorize(
-            "║  LutaML Interactive Shell (REPL)     ║", :cyan
-          )
-          puts OutputFormatter.colorize(
-            "╚═══════════════════════════════════════╝", :cyan
-          )
-          puts ""
-          puts "Type 'help' for available commands, 'exit' to quit"
-          puts ""
+          puts <<~WELCOME
+            #{OutputFormatter.colorize('╔═══════════════════════════════════════╗', :cyan)}
+            #{OutputFormatter.colorize('║  LutaML Interactive Shell (REPL)     ║', :cyan)}
+            #{OutputFormatter.colorize('╚═══════════════════════════════════════╝', :cyan)}
+
+            Type 'help' for available commands, 'exit' to quit
+
+          WELCOME
 
           stats = repository.statistics
           puts "Repository loaded:"
@@ -65,43 +61,41 @@ module Lutaml
         end
 
         def display_general_help
-          puts OutputFormatter.colorize("Available Commands:", :cyan)
-          puts ""
+          puts <<~HELP
+            #{OutputFormatter.colorize('Available Commands:', :cyan)}
 
-          puts OutputFormatter.colorize("Navigation:", :yellow)
-          puts "  cd PATH           Change to package path"
-          puts "  pwd               Print current path"
-          puts "  ls [PATH]         List packages"
-          puts "  tree [PATH]       Show package tree"
-          puts "  up                Go to parent package"
-          puts "  root              Go to ModelRoot"
-          puts "  back              Go to previous location"
-          puts ""
+            #{OutputFormatter.colorize('Navigation:', :yellow)}
+              cd PATH           Change to package path
+              pwd               Print current path
+              ls [PATH]         List packages
+              tree [PATH]       Show package tree
+              up                Go to parent package
+              root              Go to ModelRoot
+              back              Go to previous location
 
-          puts OutputFormatter.colorize("Query:", :yellow)
-          puts "  find CLASS        Find class (fuzzy search)"
-          puts "  show class QNAME  Show class details"
-          puts "  show package PATH Show package details"
-          puts "  show NUMBER       Show numbered result"
-          puts "  search QUERY      Full-text search"
-          puts "  ? QUERY           Alias for search"
-          puts ""
+            #{OutputFormatter.colorize('Query:', :yellow)}
+              find CLASS        Find class (fuzzy search)
+              show class QNAME  Show class details
+              show package PATH Show package details
+              show NUMBER       Show numbered result
+              search QUERY      Full-text search
+              ? QUERY           Alias for search
 
-          puts OutputFormatter.colorize("Bookmarks:", :yellow)
-          puts "  bookmark add NAME  Bookmark current location"
-          puts "  bookmark list      List bookmarks"
-          puts "  bookmark go NAME   Jump to bookmark"
-          puts "  bookmark rm NAME   Remove bookmark"
-          puts "  bm NAME            Quick jump"
-          puts ""
+            #{OutputFormatter.colorize('Bookmarks:', :yellow)}
+              bookmark add NAME  Bookmark current location
+              bookmark list      List bookmarks
+              bookmark go NAME   Jump to bookmark
+              bookmark rm NAME   Remove bookmark
+              bm NAME            Quick jump
 
-          puts OutputFormatter.colorize("Utilities:", :yellow)
-          puts "  help [COMMAND]    Show help"
-          puts "  history           Show command history"
-          puts "  clear             Clear screen"
-          puts "  config            Show configuration"
-          puts "  stats             Show statistics"
-          puts "  exit, quit, q     Exit shell"
+            #{OutputFormatter.colorize('Utilities:', :yellow)}
+              help [COMMAND]    Show help
+              history           Show command history
+              clear             Clear screen
+              config            Show configuration
+              stats             Show statistics
+              exit, quit, q     Exit shell
+          HELP
         end
 
         def display_command_help(command)

data/lib/lutaml/cli/interactive_shell/navigation_commands.rb

@@ -38,22 +38,13 @@ module Lutaml
           if packages.empty?
             puts OutputFormatter.warning("No packages found at #{path}")
           else
-            packages.each do |pkg|
-              icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:package]} " : ""
-              puts "#{icon}#{pkg.name}"
-            end
-            puts ""
-            puts "Total: #{packages.size} package(s)"
+            display_packages(packages)
           end
         end
 
         def cmd_tree(args)
           path = args.empty? ? current_path : resolve_path(args[0])
-
-          max_depth = nil
-          args.each_with_index do |arg, i|
-            max_depth = args[i + 1].to_i if arg == "-d" && args[i + 1]
-          end
+          max_depth = extract_depth(args)
 
           tree_data = repository.package_tree(path, max_depth: max_depth)
 
@@ -62,11 +53,7 @@ module Lutaml
             return
           end
 
-          if config[:icons]
-            puts EnhancedFormatter.format_tree_with_icons(tree_data, config)
-          else
-            puts OutputFormatter.format_tree(tree_data)
-          end
+          puts format_tree(tree_data)
         end
 
         def cmd_up(_args)
@@ -108,21 +95,53 @@ module Lutaml
           return path if path.start_with?("ModelRoot")
           return current_path if path == "."
           return "ModelRoot" if path == "/"
+          return resolve_parent_path(path) if path.start_with?("../")
+          return resolve_child_path(path) if path.start_with?("./")
 
-          if path.start_with?("../")
-            parts = current_path.split("::")
-            path.scan("../").each { parts.pop }
-            remaining = path.gsub(/^(\.\.\/)+/, "")
-            new_path = parts + remaining.split("/")
-            new_path.join("::")
-          elsif path.start_with?("./")
-            "#{current_path}::#{path[2..]}"
+          resolve_simple_path(path)
+        end
+
+        def resolve_child_path(path)
+          "#{current_path}::#{path[2..]}"
+        end
+
+        def resolve_simple_path(path)
+          current_path == "ModelRoot" ? path : "#{current_path}::#{path}"
+        end
+
+        private
+
+        def display_packages(packages)
+          packages.each do |pkg|
+            icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:package]} " : ""
+            puts "#{icon}#{pkg.name}"
+          end
+          puts ""
+          puts "Total: #{packages.size} package(s)"
+        end
+
+        def extract_depth(args)
+          args.each_with_index do |arg, i|
+            return args[i + 1].to_i if arg == "-d" && args[i + 1]
+          end
+          nil
+        end
+
+        def format_tree(tree_data)
+          if config[:icons]
+            EnhancedFormatter.format_tree_with_icons(tree_data, config)
           else
-            current_path == "ModelRoot" ? path : "#{current_path}::#{path}"
+            OutputFormatter.format_tree(tree_data)
           end
         end
 
-        private
+        def resolve_parent_path(path)
+          parts = current_path.split("::")
+          path.scan("../").each { parts.pop }
+          remaining = path.gsub(/^(\.\.\/)+/, "")
+          new_path = parts + remaining.split("/")
+          new_path.join("::")
+        end
 
         def push_path_history
           return if path_history.last == current_path

data/lib/lutaml/cli/interactive_shell/query_commands.rb

@@ -19,16 +19,10 @@ module Lutaml
           if results[:class].empty?
             puts OutputFormatter.warning("No classes found matching '#{query}'")
           else
-            self.last_results = results[:class]
-
             puts OutputFormatter.colorize(
-              "Found #{last_results.size} class(es):", :cyan
+              "Found #{results[:class].size} class(es):", :cyan
             )
-            last_results.each_with_index do |qname, i|
-              puts "  #{i + 1}. #{qname}"
-            end
-            puts ""
-            puts "Use 'show NUMBER' to view details"
+            display_class_results(results[:class])
           end
         end
 
@@ -94,18 +88,7 @@ module Lutaml
           if config[:icons]
             puts EnhancedFormatter.format_class_details_enhanced(cls)
           else
-            puts OutputFormatter.colorize("Class: #{qname}", :cyan)
-            puts "=" * 50
-            puts ""
-            puts "Name: #{cls.name}"
-
-            if cls.is_a?(Lutaml::Uml::Classifier) && cls.attributes && !cls.attributes.empty?
-              puts ""
-              puts OutputFormatter.colorize("Attributes:", :yellow)
-              cls.attributes.each do |attr|
-                puts "  - #{attr.name}: #{attr.type}"
-              end
-            end
+            display_class_plain(cls, qname)
           end
         end
 
@@ -119,18 +102,7 @@ module Lutaml
             return
           end
 
-          puts OutputFormatter.colorize("Package: #{path}", :cyan)
-          puts "=" * 50
-          puts ""
-          puts "Name: #{pkg.name}"
-          puts ""
-
-          classes = repository.classes_in_package(path)
-          puts OutputFormatter.colorize("Classes (#{classes.size}):", :yellow)
-          classes.each do |cls|
-            icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:class]} " : ""
-            puts "  #{icon}#{cls.name}"
-          end
+          display_package_contents(pkg, path)
         end
 
         def show_numbered_result(number)
@@ -159,26 +131,80 @@ module Lutaml
 
             case type
             when :class
-              self.last_results = items
-              items.each_with_index do |qname, i|
-                icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:class]} " : ""
-                puts "  #{i + 1}. #{icon}#{qname}"
-              end
-              puts ""
-              puts "Use 'show NUMBER' to view details"
+              display_class_results(items)
             when :attribute
-              items.each do |item|
-                puts "  - #{item[:class_name]}::#{item[:attribute_name]} : " \
-                     "#{item[:type]}"
-              end
+              display_attribute_results(items)
             when :association
-              items.each do |item|
-                icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:association]} " : ""
-                puts "  #{icon}#{item[:source]} → #{item[:target]}"
-              end
+              display_association_results(items)
             end
           end
         end
+
+        private
+
+        def display_class_results(items)
+          self.last_results = items
+          items.each_with_index do |qname, i|
+            icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:class]} " : ""
+            puts "  #{i + 1}. #{icon}#{qname}"
+          end
+          puts ""
+          puts "Use 'show NUMBER' to view details"
+        end
+
+        def display_attribute_results(items)
+          items.each do |item|
+            puts "  - #{item[:class_name]}::#{item[:attribute_name]} : " \
+                 "#{item[:type]}"
+          end
+        end
+
+        def display_association_results(items)
+          items.each do |item|
+            icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:association]} " : ""
+            puts "  #{icon}#{item[:source]} → #{item[:target]}"
+          end
+        end
+
+        def display_class_plain(cls, qname)
+          puts OutputFormatter.colorize("Class: #{qname}", :cyan)
+          puts "=" * 50
+          puts ""
+          puts "Name: #{cls.name}"
+
+          display_class_attributes(cls) if has_displayable_attributes?(cls)
+        end
+
+        def has_displayable_attributes?(cls)
+          cls.is_a?(Lutaml::Uml::Classifier) && cls.attributes && !cls.attributes.empty?
+        end
+
+        def display_class_attributes(cls)
+          puts ""
+          puts OutputFormatter.colorize("Attributes:", :yellow)
+          cls.attributes.each do |attr|
+            puts "  - #{attr.name}: #{attr.type}"
+          end
+        end
+
+        def display_package_contents(pkg, path)
+          puts OutputFormatter.colorize("Package: #{path}", :cyan)
+          puts "=" * 50
+          puts ""
+          puts "Name: #{pkg.name}"
+          puts ""
+
+          display_package_classes(path)
+        end
+
+        def display_package_classes(path)
+          classes = repository.classes_in_package(path)
+          puts OutputFormatter.colorize("Classes (#{classes.size}):", :yellow)
+          classes.each do |cls|
+            icon = config[:icons] ? "#{EnhancedFormatter::ICONS[:class]} " : ""
+            puts "  #{icon}#{cls.name}"
+          end
+        end
       end
     end
   end

data/lib/lutaml/cli/interactive_shell.rb

@@ -24,65 +24,91 @@ module Lutaml
       attr_accessor :current_path, :last_results
 
       def initialize(lur_path_or_repo, config: nil)
-        @config = {
+        @config = default_config.merge(config || {})
+        @repository = load_repository(lur_path_or_repo)
+
+        @current_path = "ModelRoot"
+        @bookmarks = {}
+        @last_results = nil
+        @path_history = ["ModelRoot"]
+        @running = false
+
+        init_commands
+        setup_readline
+        load_history
+      end
+
+      def start
+        @running = true
+        @help.display_welcome
+
+        run_repl_loop
+
+        save_history
+        puts "\nGoodbye!"
+      end
+
+      private
+
+      def default_config
+        {
           color: true,
           icons: true,
           show_counts: true,
           page_size: 50,
-        }.merge(config || {})
+        }
+      end
 
+      def load_repository(lur_path_or_repo)
         if lur_path_or_repo.is_a?(String)
           OutputFormatter.progress("Loading repository")
-          @repository = Lutaml::UmlRepository::Repository.from_package(lur_path_or_repo)
+          repo = Lutaml::UmlRepository::Repository.from_package(lur_path_or_repo)
           OutputFormatter.progress_done
+          repo
         else
-          @repository = lur_path_or_repo
+          lur_path_or_repo
         end
+      end
 
-        @current_path = "ModelRoot"
-        @bookmarks = {}
-        @last_results = nil
-        @path_history = ["ModelRoot"]
-        @running = false
-
+      def init_commands
         @navigation = NavigationCommands.new(self)
         @query = QueryCommands.new(self)
         @bookmarks_cmd = BookmarkCommands.new(self)
         @export = ExportHandler.new(self)
         @help = HelpDisplay.new(self)
-
-        setup_readline
-        load_history
       end
 
-      def start
-        @running = true
-        @help.display_welcome
-
+      def run_repl_loop
         while @running
           begin
             input = Readline.readline(prompt, true)
             break if input.nil?
             next if input.strip.empty?
 
-            if Readline::HISTORY.length > 1 && Readline::HISTORY[-2] == input
-              Readline::HISTORY.pop
-            end
-
+            deduplicate_history(input)
             execute_command(input.strip)
           rescue Interrupt
-            puts "\nUse 'exit' or 'quit' to exit the shell"
+            handle_interrupt
           rescue StandardError => e
-            puts OutputFormatter.error("Error: #{e.message}")
-            puts e.backtrace.first(3).join("\n") if ENV["DEBUG"]
+            handle_error(e)
           end
         end
+      end
 
-        save_history
-        puts "\nGoodbye!"
+      def handle_interrupt
+        puts "\nUse 'exit' or 'quit' to exit the shell"
       end
 
-      private
+      def handle_error(error)
+        puts OutputFormatter.error("Error: #{error.message}")
+        puts error.backtrace.first(3).join("\n") if ENV["DEBUG"]
+      end
+
+      def deduplicate_history(input)
+        if Readline::HISTORY.length > 1 && Readline::HISTORY[-2] == input
+          Readline::HISTORY.pop
+        end
+      end
 
       COMMAND_DISPATCH = {
         # Navigation