lutaml 0.10.13 → 0.10.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66f287c7903f45ebce9fc0abdc3561ad6ef3df65fdb4b437a126685610756df7
-  data.tar.gz: 8459a2ad63cf3e4071c7d56ec4ae105410d3044aad2f05810419d4dd90adf861
+  metadata.gz: 69670b20b9f7eeb39ebc7fc3fa638b7f2934d077e18319af972881c3ef0522b5
+  data.tar.gz: b77ad5274ea62236961489bfef7751d7f4ca98ddcc8e4daa5cff30469d00abd8
 SHA512:
-  metadata.gz: d395f7c78511a601edef5eab6e96f5f896e46a135675767dfd031df36caaa6cfb34a3e5c834d96feed728760a59bd1fe2321ff2ce25490274d9d2693345eb2aa
-  data.tar.gz: e0ab7f240736d995f948283a9668f578133a39443d95d1889178c7e8c97afb7872d581bc0d8b2d0b79db9c3587087448c82048bb2bce00ee28179b011c422597
+  metadata.gz: d75318da9968bee531f257272a490b574c7541a264ce54283f35bea1cd4cc24314d9766ab8da589a326ea06edb7ac953b43c4c2db3579cc55dee46f0bee22f25
+  data.tar.gz: 9ab593c061dfb0983ded7744859ddf3e7214dc8e64f5808dae4f54f779bab4a772b6c5af65eb5c69d1df887b2ae52837d69e872790656e9aa444cd0f91eb77e0

data/.rubocop_todo.yml

@@ -1,32 +1,40 @@
 # 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-12 14:40:16 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
+# Offense count: 6
 # 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'
+    - 'lib/lutaml/qea/factory/association_builder.rb'
+    - 'lib/lutaml/qea/factory/generalization_builder.rb'
+    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/inheritance_resolver.rb'
 
-# Offense count: 156
+# Offense count: 158
 # 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
+# Offense count: 7
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowInHeredoc.
 Layout/TrailingWhitespace:
   Exclude:
-    - 'spec/lutaml/xml/parsers/xsd_spec.rb'
+    - 'lib/lutaml/qea/factory/generalization_builder.rb'
+    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
+    - 'lib/lutaml/uml_repository/queries/inheritance_query.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/inheritance_resolver.rb'
 
 # Offense count: 1
 Lint/BinaryOperatorWithIdenticalOperands:
@@ -92,31 +100,41 @@ Lint/UselessConstantScoping:
   Exclude:
     - 'lib/lutaml/cli/interactive_shell.rb'
 
-# Offense count: 51
+# Offense count: 33
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
 
-# Offense count: 4
-# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
-# AllowedMethods: refine
-Metrics/BlockLength:
-  Max: 53
-
-# Offense count: 35
+# Offense count: 23
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 75
+# Offense count: 63
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 62
+  Max: 21
+
+# Offense count: 2
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 7
 
-# Offense count: 26
+# Offense count: 12
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
-  Enabled: false
+  Exclude:
+    - 'lib/lutaml/cli/interactive_shell/navigation_commands.rb'
+    - 'lib/lutaml/converter/xmi_to_uml.rb'
+    - 'lib/lutaml/qea/factory/association_builder.rb'
+    - 'lib/lutaml/qea/factory/ea_to_uml_factory.rb'
+    - 'lib/lutaml/qea/lookup_indexes.rb'
+    - 'lib/lutaml/uml_repository/index_builders/association_index.rb'
+    - 'lib/lutaml/uml_repository/repository/loader.rb'
+    - 'lib/lutaml/uml_repository/static_site/data_transformer.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/class_serializer.rb'
+    - 'lib/lutaml/uml_repository/static_site/serializers/inheritance_resolver.rb'
+    - 'lib/lutaml/xmi/parsers/xmi_connector.rb'
 
 # Offense count: 3
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
@@ -309,6 +327,12 @@ Style/EvalWithLocation:
   Exclude:
     - 'spec/lutaml/cli/uml/search_command_spec.rb'
 
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineIfModifier:
+  Exclude:
+    - 'lib/lutaml/uml_repository/index_builders/class_index.rb'
+
 # Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
 Style/PartitionInsteadOfDoubleSelect:
@@ -321,3 +345,19 @@ Style/SafeNavigationChainLength:
   Exclude:
     - 'lib/lutaml/qea/validation/attribute_validator.rb'
     - 'lib/lutaml/qea/validation/operation_validator.rb'
+
+# Offense count: 8
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiteralsInInterpolation:
+  Exclude:
+    - 'lib/lutaml/cli/interactive_shell/help_display.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, AllowSafeAssignment.
+# SupportedStyles: require_parentheses, require_no_parentheses, require_parentheses_when_complex
+Style/TernaryParentheses:
+  Exclude:
+    - 'lib/lutaml/qea/factory/association_builder.rb'

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

@@ -6,6 +6,12 @@ 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")
@@ -20,13 +26,9 @@ module Lutaml
           format = args[1].downcase
           file_path = args[2]
 
-          case format
-          when "csv"
-            export_csv(file_path)
-          when "json"
-            export_json(file_path)
-          when "yaml"
-            export_yaml(file_path)
+          exporter = EXPORT_FORMATS[format]
+          if exporter
+            public_send(exporter, file_path)
           else
             puts OutputFormatter.error("Unsupported format: #{format}")
           end

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)
@@ -110,11 +97,7 @@ module Lutaml
           return "ModelRoot" if path == "/"
 
           if path.start_with?("../")
-            parts = current_path.split("::")
-            path.scan("../").each { parts.pop }
-            remaining = path.gsub(/^(\.\.\/)+/, "")
-            new_path = parts + remaining.split("/")
-            new_path.join("::")
+            resolve_parent_path(path)
           elsif path.start_with?("./")
             "#{current_path}::#{path[2..]}"
           else
@@ -124,6 +107,38 @@ module Lutaml
 
         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
+            OutputFormatter.format_tree(tree_data)
+          end
+        end
+
+        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,70 @@ 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}"
+
+          return unless 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
+
+        def display_package_contents(pkg, path)
+          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
+        end
       end
     end
   end

data/lib/lutaml/cli/interactive_shell.rb

@@ -24,51 +24,68 @@ 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"
@@ -77,12 +94,13 @@ module Lutaml
             puts e.backtrace.first(3).join("\n") if ENV["DEBUG"]
           end
         end
-
-        save_history
-        puts "\nGoodbye!"
       end
 
-      private
+      def deduplicate_history(input)
+        if Readline::HISTORY.length > 1 && Readline::HISTORY[-2] == input
+          Readline::HISTORY.pop
+        end
+      end
 
       COMMAND_DISPATCH = {
         # Navigation