class-metrix 1.0.0 → 1.1.0

data/examples/inheritance_and_modules.rb

@@ -11,11 +11,11 @@ puts "=" * 50
 
 module Configurable
   DEFAULT_TIMEOUT = 30
-  
+
   def self.included(base)
     base.extend(ClassMethods)
   end
-  
+
   module ClassMethods
     def configuration
       { timeout: DEFAULT_TIMEOUT, enabled: true }
@@ -25,11 +25,11 @@ end
 
 module Cacheable
   CACHE_TTL = 3600
-  
+
   def self.included(base)
     base.extend(ClassMethods)
   end
-  
+
   module ClassMethods
     def cache_config
       { ttl: CACHE_TTL, enabled: true }
@@ -39,11 +39,11 @@ end
 
 class BaseService
   SERVICE_VERSION = "1.0"
-  
+
   def self.service_type
     "base"
   end
-  
+
   def self.health_check
     { status: "ok", version: SERVICE_VERSION }
   end
@@ -51,14 +51,14 @@ end
 
 class DatabaseService < BaseService
   include Configurable
-  
+
   SERVICE_NAME = "database"
   CONNECTION_POOL_SIZE = 5
-  
+
   def self.service_type
     "database"
   end
-  
+
   def self.connection_config
     { pool_size: CONNECTION_POOL_SIZE, timeout: 60 }
   end
@@ -67,14 +67,14 @@ end
 class CacheService < BaseService
   include Configurable
   include Cacheable
-  
-  SERVICE_NAME = "cache" 
+
+  SERVICE_NAME = "cache"
   MAX_MEMORY = "512MB"
-  
+
   def self.service_type
     "cache"
   end
-  
+
   def self.memory_config
     { max_memory: MAX_MEMORY, eviction_policy: "lru" }
   end
@@ -86,43 +86,43 @@ services = [DatabaseService, CacheService]
 puts "\n1. Basic Analysis (Own Constants Only)"
 puts "-" * 40
 result = ClassMetrix.extract(:constants)
-                   .from(services)
-                   .to_markdown
+                    .from(services)
+                    .to_markdown
 puts result
 
 puts "\n2. With Inheritance (Own + Parent Constants)"
 puts "-" * 40
 result = ClassMetrix.extract(:constants)
-                   .from(services)
-                   .include_inherited
-                   .to_markdown
+                    .from(services)
+                    .include_inherited
+                    .to_markdown
 puts result
 
 puts "\n3. With Modules (Own + Module Constants)"
 puts "-" * 40
 result = ClassMetrix.extract(:constants)
-                   .from(services)
-                   .include_modules
-                   .to_markdown
+                    .from(services)
+                    .include_modules
+                    .to_markdown
 puts result
 
 puts "\n4. Complete Analysis (Own + Inherited + Modules)"
 puts "-" * 40
 result = ClassMetrix.extract(:constants, :class_methods)
-                   .from(services)
-                   .include_all
-                   .handle_errors
-                   .to_markdown
+                    .from(services)
+                    .include_all
+                    .handle_errors
+                    .to_markdown
 puts result
 
 puts "\n5. Filtered Configuration Analysis"
 puts "-" * 40
 result = ClassMetrix.extract(:constants, :class_methods)
-                   .from(services)
-                   .include_all
-                   .filter(/config|timeout|service/i)
-                   .expand_hashes
-                   .to_markdown
+                    .from(services)
+                    .include_all
+                    .filter(/config|timeout|service/i)
+                    .expand_hashes
+                    .to_markdown
 puts result
 
 puts "\n6. Hash Expansion Modes"
@@ -130,26 +130,26 @@ puts "-" * 40
 
 puts "\n6a. Default: Show Only Main Rows (Collapsed Hashes)"
 result = ClassMetrix.extract(:class_methods)
-                   .from([CacheService])
-                   .filter(/config/)
-                   .expand_hashes
-                   .to_markdown
+                    .from([CacheService])
+                    .filter(/config/)
+                    .expand_hashes
+                    .to_markdown
 puts result
 
 puts "\n6b. Show Only Key Rows (Expanded Details)"
 result = ClassMetrix.extract(:class_methods)
-                   .from([CacheService])
-                   .filter(/config/)
-                   .expand_hashes
-                   .show_only_keys
-                   .to_markdown
+                    .from([CacheService])
+                    .filter(/config/)
+                    .expand_hashes
+                    .show_only_keys
+                    .to_markdown
 puts result
 
 puts "\n6c. Show Both Main and Key Rows"
 result = ClassMetrix.extract(:class_methods)
-                   .from([CacheService])
-                   .filter(/config/)
-                   .expand_hashes
-                   .show_expanded_details
-                   .to_markdown
-puts result 
+                    .from([CacheService])
+                    .filter(/config/)
+                    .expand_hashes
+                    .show_expanded_details
+                    .to_markdown
+puts result

data/lib/class_metrix/extractor.rb

@@ -48,7 +48,7 @@ module ClassMetrix
       @debug_mode = true
       @debug_level = level
       @logger = Utils::DebugLogger.new("Extractor", @debug_mode, level)
-      @logger.log("Debug mode enabled (level: #{level})")
+      @logger&.log("Debug mode enabled (level: #{level})")
       self
     end
 

data/lib/class_metrix/extractors/constants_extractor.rb

@@ -108,7 +108,7 @@ module ClassMetrix
     end
 
     def get_all_included_modules(klass)
-      modules = []
+      modules = [] # : Array[Module]
       modules.concat(klass.included_modules)
 
       if @options[:include_inherited]

data/lib/class_metrix/extractors/methods_extractor.rb

@@ -115,7 +115,7 @@ module ClassMetrix
     end
 
     def get_all_singleton_modules(klass)
-      modules = []
+      modules = [] # : Array[Module]
       modules.concat(klass.singleton_class.included_modules)
 
       if @options[:include_inherited]

data/lib/class_metrix/extractors/multi_type_extractor.rb

@@ -20,7 +20,7 @@ module ClassMetrix
       # Build headers: ["Type", "Behavior", "Class1", "Class2", ...]
       headers = %w[Type Behavior] + @classes.map(&:name)
 
-      all_rows = []
+      all_rows = [] # : Array[Array[untyped]]
 
       @types.each do |type|
         type_data = extract_single_type(type)
@@ -28,7 +28,7 @@ module ClassMetrix
         # Add rows with type prefix
         type_data[:rows].each do |row|
           behavior_name = row[0]
-          values = row[1..]
+          values = row[1..] || []
 
           new_row = [type_label(type), behavior_name] + values
           all_rows << new_row

data/lib/class_metrix/formatters/base/base_formatter.rb

@@ -26,7 +26,7 @@ module ClassMetrix
             # Common options for all formatters
             title: nil,
             show_metadata: true,
-            extraction_types: []
+            extraction_types: [] # : Array[Symbol]
           }
         end
 
@@ -52,11 +52,11 @@ module ClassMetrix
 
         def collect_all_hash_keys(rows, _headers)
           value_start_idx = value_start_index
-          all_keys = {} # behavior_name => Set of keys
+          all_keys = {} # : Hash[String, Set[String]] # behavior_name => Set of keys
 
           rows.each do |row|
             behavior_name = row[behavior_column_index]
-            values = row[value_start_idx..]
+            values = row[value_start_idx..] || []
 
             values.each do |value|
               if value.is_a?(Hash)

data/lib/class_metrix/formatters/components/footer_component.rb

@@ -16,7 +16,7 @@ module ClassMetrix
         def generate
           return [] unless @show_footer
 
-          output = []
+          output = [] # : Array[String]
 
           # Add separator line
           output << "---" if @show_separator
@@ -36,7 +36,7 @@ module ClassMetrix
         private
 
         def generate_default_footer
-          output = []
+          output = [] # : Array[String]
 
           output << (@custom_footer || "*Report generated by ClassMetrix gem*")
 
@@ -49,7 +49,7 @@ module ClassMetrix
         end
 
         def generate_detailed_footer
-          output = []
+          output = [] # : Array[String]
 
           output << "## Report Information"
           output << ""

data/lib/class_metrix/formatters/components/generic_header_component.rb

@@ -30,7 +30,7 @@ module ClassMetrix
         private
 
         def generate_markdown_header
-          output = []
+          output = [] # : Array[String]
 
           # Add title
           if @title
@@ -58,7 +58,7 @@ module ClassMetrix
         end
 
         def generate_csv_header
-          output = []
+          output = [] # : Array[String]
           comment_char = @options.fetch(:comment_char, "#")
 
           # Add title as comment

data/lib/class_metrix/formatters/components/header_component.rb

@@ -15,7 +15,7 @@ module ClassMetrix
         end
 
         def generate
-          output = []
+          output = [] # : Array[String]
 
           # Add title
           output.concat(generate_title) if @title || @show_metadata
@@ -32,7 +32,7 @@ module ClassMetrix
         private
 
         def generate_title
-          output = []
+          output = [] # : Array[String]
 
           if @title
             output << "# #{@title}"
@@ -46,7 +46,7 @@ module ClassMetrix
         end
 
         def generate_classes_section
-          output = []
+          output = [] # : Array[String]
 
           has_type_column = @data[:headers].first == "Type"
           class_headers = if has_type_column
@@ -66,7 +66,7 @@ module ClassMetrix
         end
 
         def generate_extraction_info
-          output = []
+          output = [] # : Array[String]
 
           output << "## Extraction Types"
           output << ""

data/lib/class_metrix/formatters/components/missing_behaviors_component.rb

@@ -9,7 +9,7 @@ module ClassMetrix
           @options = options
           @show_missing_summary = options.fetch(:show_missing_summary, false)
           @summary_style = options.fetch(:summary_style, :grouped) # :grouped, :flat, :detailed
-          @missing_behaviors = {}
+          @missing_behaviors = {} # : Hash[String, Hash[String, String]]
         end
 
         def generate
@@ -30,7 +30,7 @@ module ClassMetrix
                           end
 
           # Initialize missing behaviors tracking with hash to store behavior name and error message
-          class_headers.each { |class_name| @missing_behaviors[class_name] = {} }
+          class_headers.each { |class_name| @missing_behaviors[class_name] = {} } # : Hash[String, Hash[String, String]]
 
           @data[:rows].each do |row|
             behavior_name = has_type_column ? row[1] : row[0]
@@ -63,7 +63,7 @@ module ClassMetrix
         end
 
         def generate_grouped_summary
-          output = []
+          output = [] # : Array[String]
 
           output << "## Missing Behaviors Summary"
           output << ""
@@ -84,12 +84,12 @@ module ClassMetrix
         end
 
         def generate_flat_summary
-          output = []
+          output = [] # : Array[String]
 
           output << "## Missing Behaviors"
           output << ""
 
-          all_missing = []
+          all_missing = [] # : Array[String]
           @missing_behaviors.each do |class_name, behaviors_hash|
             behaviors_hash.each do |behavior_name, error_message|
               all_missing << "- **#{class_name}**: `#{behavior_name}` - #{error_message}"
@@ -103,7 +103,7 @@ module ClassMetrix
         end
 
         def generate_detailed_summary
-          output = []
+          output = [] # : Array[String]
 
           total_missing = @missing_behaviors.values.map(&:size).sum
           total_classes = @missing_behaviors.keys.size
@@ -114,7 +114,7 @@ module ClassMetrix
           output << ""
 
           # Group by error type
-          by_error_type = {}
+          by_error_type = {} # : Hash[String, Array[Hash[Symbol, String]]]
           @missing_behaviors.each do |class_name, behaviors_hash|
             behaviors_hash.each do |behavior_name, error_message|
               error_type = error_message.split.first(2).join(" ") # e.g., "🚫 Not", "⚠️ Error:"

data/lib/class_metrix/formatters/components/table_component/row_processor.rb

@@ -16,7 +16,8 @@ module ClassMetrix
           def process_simple_rows(rows)
             rows.map do |row|
               processed_row = [row[0]] # Keep the behavior name as-is
-              row[1..].each do |value|
+              rest_values = row[1..] || []
+              rest_values.each do |value|
                 processed_row << ValueProcessor.process(value)
               end
               processed_row
@@ -24,7 +25,7 @@ module ClassMetrix
           end
 
           def process_expanded_rows(rows)
-            expanded_rows = []
+            expanded_rows = [] # : Array[Array[String]]
 
             rows.each do |row|
               if @data_extractor.row_has_expandable_hash?(row)
@@ -41,9 +42,11 @@ module ClassMetrix
 
           def process_non_hash_row(row)
             if @data_extractor.has_type_column?
-              [row[0], row[1]] + row[2..].map { |value| ValueProcessor.process(value) }
+              rest_values = row[2..] || []
+              [row[0], row[1]] + rest_values.map { |value| ValueProcessor.process(value) }
             else
-              [row[0]] + row[1..].map { |value| ValueProcessor.process(value) }
+              rest_values = row[1..] || []
+              [row[0]] + rest_values.map { |value| ValueProcessor.process(value) }
             end
           end
 
@@ -57,7 +60,7 @@ module ClassMetrix
           end
 
           def build_expanded_rows(row_data, all_hash_keys, original_row)
-            expanded_rows = []
+            expanded_rows = [] # : Array[Array[String]]
 
             # Add main row if configured to show
             expanded_rows << build_main_expanded_row(row_data) if should_show_main_row?

data/lib/class_metrix/formatters/components/table_component/table_data_extractor.rb

@@ -37,7 +37,10 @@ module ClassMetrix
           end
 
           def row_has_expandable_hash?(row)
-            row[value_start_index..].any? { |cell| cell.is_a?(Hash) }
+            values = row[value_start_index..] || []
+            return false if values.nil?
+
+            values.any? { |cell| cell.is_a?(Hash) }
           end
 
           def collect_hash_keys(values)

data/lib/class_metrix/formatters/components/table_component/table_renderer.rb

@@ -11,7 +11,7 @@ module ClassMetrix
           end
 
           def render_table(headers, rows, column_widths)
-            output = []
+            output = [] # : Array[String]
             output << build_row(headers, column_widths)
             output << build_separator(column_widths)
 
@@ -19,7 +19,7 @@ module ClassMetrix
               output << build_row(row, column_widths)
             end
 
-            output.join("\n")
+            output
           end
 
           private

data/lib/class_metrix/formatters/components/table_component.rb

@@ -21,9 +21,10 @@ module ClassMetrix
 
           # Initialize helper objects
           @data_extractor = TableDataExtractor.new(@data[:headers])
-          @row_processor = RowProcessor.new(@data_extractor,
-                                            hide_main_row: @hide_main_row,
-                                            hide_key_rows: @hide_key_rows)
+          @row_processor = RowProcessor.new(@data_extractor, {
+                                              hide_main_row: @hide_main_row,
+                                              hide_key_rows: @hide_key_rows
+                                            })
           @width_calculator = ColumnWidthCalculator.new(
             table_style: @table_style,
             min_column_width: @min_column_width,
@@ -36,7 +37,7 @@ module ClassMetrix
         end
 
         def generate
-          return "" if @data[:headers].empty? || @data[:rows].empty?
+          return [""] if @data[:headers].empty? || @data[:rows].empty?
 
           headers = @data[:headers]
           rows = if @expand_hashes

data/lib/class_metrix/formatters/csv_formatter.rb

@@ -15,7 +15,7 @@ module ClassMetrix
     def format
       return "" if @data[:headers].empty? || @data[:rows].empty?
 
-      output_lines = []
+      output_lines = [] # : Array[String]
 
       # Add CSV header comments
       if @options.fetch(:show_metadata, true)
@@ -65,7 +65,7 @@ module ClassMetrix
 
       return [] if headers.empty?
 
-      output = []
+      output = [] # : Array[String]
       separator = @options.fetch(:separator, ",")
       quote_char = @options.fetch(:quote_char, '"')
 
@@ -75,7 +75,7 @@ module ClassMetrix
       csv_rows.each do |row|
         # Ensure all row values are strings and properly quoted
         formatted_row = row.map { |cell| format_csv_cell(cell) }
-        csv_line = CSV.generate_line(formatted_row, col_sep: separator, quote_char: quote_char).chomp
+        csv_line = CSV.generate(col_sep: separator, quote_char: quote_char) { |csv| csv << formatted_row }.chomp
         output << csv_line
       end
 

data/lib/class_metrix/formatters/markdown_formatter.rb

@@ -16,7 +16,7 @@ module ClassMetrix
     def format
       return "" if @data[:headers].empty? || @data[:rows].empty?
 
-      output = []
+      output = [] # : Array[String]
 
       # Add header sections (title, classes, extraction info)
       if @options.fetch(:show_metadata, true)
@@ -77,7 +77,7 @@ module ClassMetrix
 
       widths = calculate_column_widths(headers, rows)
 
-      output = []
+      output = [] # : Array[String]
       output << build_header_row(headers, widths)
       output << build_separator_row(widths)
       output.concat(build_data_rows(rows, headers, widths))
@@ -170,8 +170,7 @@ module ClassMetrix
       if max_width >= 15
         # Look for the first complete key-value pair (handle :symbol=>value format)
         match = text.match(/\{(:[^,}]+=>[^,}]+)/)
-        if match
-          first_pair = match[1]
+        if match && (first_pair = match[1])
           needed_length = first_pair.length + 6 # For "{", ", ...}"
           return "{#{first_pair}, ...}" if needed_length <= max_width
         end

data/lib/class_metrix/formatters/shared/markdown_table_builder.rb

@@ -19,7 +19,7 @@ module ClassMetrix
         # Create proper flat table structure for hash expansion
         def expand_row(row, _headers)
           behavior_name = row[behavior_column_index]
-          values = row[value_start_index..]
+          values = row[value_start_index..] || []
 
           all_hash_keys = collect_unique_hash_keys(values)
           return [process_row(row)] if all_hash_keys.empty?
@@ -36,7 +36,7 @@ module ClassMetrix
         end
 
         def build_expanded_row_structure(row, behavior_name, values, all_hash_keys)
-          expanded_rows = []
+          expanded_rows = [] # : Array[Array[String]]
 
           # Add main row if configured to show
           expanded_rows << build_main_row(row, behavior_name, values) if should_show_main_row?

data/lib/class_metrix/formatters/shared/table_builder.rb

@@ -63,7 +63,7 @@ module ClassMetrix
         private
 
         def process_rows_for_expansion(headers)
-          expanded_rows = []
+          expanded_rows = [] # : Array[Array[String]]
           expandable_count = 0
 
           @data[:rows].each_with_index do |row, index|
@@ -88,6 +88,8 @@ module ClassMetrix
           @logger.log_hash_detection_summary(values)
 
           # Only consider real Hash objects as expandable
+          return false if values.nil?
+
           result = values.any? { |cell| cell.is_a?(Hash) && cell.instance_of?(Hash) }
           @logger.log_decision("Row expandable", "#{result ? "Has" : "No"} real Hash objects", :detailed)
           result
@@ -130,7 +132,7 @@ module ClassMetrix
 
         def expand_row(row, _headers)
           behavior_name = row[behavior_column_index]
-          values = row[value_start_index..]
+          values = row[value_start_index..] || []
 
           @logger.log("Expanding row for behavior '#{behavior_name}'")
 
@@ -161,7 +163,7 @@ module ClassMetrix
         end
 
         def build_expanded_row_set(row, behavior_name, values, all_hash_keys)
-          expanded_rows = []
+          expanded_rows = [] # : Array[Array[String]]
 
           # Add main row if configured to show
           expanded_rows << build_main_row(row, behavior_name, values) if should_show_main_row?
@@ -232,7 +234,7 @@ module ClassMetrix
 
         def collect_all_hash_keys(rows, _headers)
           value_start_idx = value_start_index
-          all_keys = {} # behavior_name => Set of keys
+          all_keys = {} # : Hash[String, Set[String]] # behavior_name => Set of keys
           total_hash_count = 0
 
           rows.each_with_index do |row, index|
@@ -247,7 +249,7 @@ module ClassMetrix
 
         def collect_hash_keys_for_row(row, value_start_idx, all_keys)
           behavior_name = row[behavior_column_index]
-          values = row[value_start_idx..]
+          values = row[value_start_idx..] || []
           hash_count = 0
 
           values.each_with_index do |value, index|
@@ -299,7 +301,7 @@ module ClassMetrix
         def add_flattened_hash_values(flattened, row, behavior_name, all_hash_keys)
           return unless all_hash_keys[behavior_name]
 
-          values = row[value_start_index..]
+          values = row[value_start_index..] || []
 
           all_hash_keys[behavior_name].to_a.sort.each do |key|
             add_flattened_values_for_key(flattened, values, key)

data/lib/class_metrix/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClassMetrix
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/sig/class_metrix.rbs

@@ -0,0 +1,8 @@
+# Main ClassMetrix module
+module ClassMetrix
+  class Error < StandardError
+  end
+
+  # Main entry point for the gem
+  def self.extract: (*Symbol types) -> ClassMetrix::Extractor
+end