rails_console_pro 0.1.2 → 0.1.4

data/lib/rails_console_pro/commands.rb

@@ -30,5 +30,35 @@ module RailsConsolePro
     def diff(object1, object2)
       DiffCommand.new.execute(object1, object2)
     end
+
+  # Profiling command
+  def profile(target = nil, *args, **kwargs, &block)
+    ProfileCommand.new.execute(target, *args, **kwargs, &block)
+  end
+
+    # Queue insights command
+    def jobs(options = {})
+      JobsCommand.new.execute(options)
+    end
+
+    # Snippets command
+    def snippets(action = :list, *args, **kwargs, &block)
+      SnippetsCommand.new.execute(action, *args, **kwargs, &block)
+    end
+
+    # Model introspection command
+    def introspect(model_class, *options)
+      IntrospectCommand.new.execute(model_class, *options)
+    end
+
+    # Query comparison command
+    def compare(&block)
+      CompareCommand.new.execute(&block)
+    end
+
+    # Query builder command
+    def query(model_class, &block)
+      QueryBuilderCommand.new.execute(model_class, &block)
+    end
   end
 end

data/lib/rails_console_pro/compare_result.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  # Value object for query comparison results
+  class CompareResult
+    Comparison = Struct.new(
+      :name,
+      :duration_ms,
+      :query_count,
+      :result,
+      :error,
+      :sql_queries,
+      :memory_usage_kb,
+      keyword_init: true
+    )
+
+    attr_reader :comparisons, :winner, :timestamp
+
+    def initialize(comparisons:, winner: nil, timestamp: Time.current)
+      @comparisons = Array(comparisons)
+      @winner = winner
+      @timestamp = timestamp
+    end
+
+    def fastest
+      comparisons.min_by { |c| c.duration_ms || Float::INFINITY }
+    end
+
+    def slowest
+      comparisons.max_by { |c| c.duration_ms || 0 }
+    end
+
+    def has_errors?
+      comparisons.any? { |c| c.error }
+    end
+
+    def error_count
+      comparisons.count { |c| c.error }
+    end
+
+    def total_queries
+      comparisons.sum { |c| c.query_count || 0 }
+    end
+
+    def fastest_name
+      fastest&.name
+    end
+
+    def slowest_name
+      slowest&.name
+    end
+
+    def performance_ratio
+      return nil if comparisons.size < 2 || fastest.nil? || slowest.nil?
+      return nil if fastest.duration_ms.nil? || slowest.duration_ms.nil? || fastest.duration_ms.zero?
+
+      (slowest.duration_ms / fastest.duration_ms).round(2)
+    end
+
+    # Export to JSON
+    def to_json(pretty: true)
+      FormatExporter.to_json(self, pretty: pretty)
+    end
+
+    # Export to YAML
+    def to_yaml
+      FormatExporter.to_yaml(self)
+    end
+
+    # Export to HTML
+    def to_html(style: :default)
+      FormatExporter.to_html(self, title: "Query Comparison", style: style)
+    end
+
+    # Export to file
+    def export_to_file(file_path, format: nil)
+      FormatExporter.export_to_file(self, file_path, format: format)
+    end
+  end
+end
+

data/lib/rails_console_pro/configuration.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'tmpdir'
+require 'pathname'
+
 module RailsConsolePro
   # Configuration class for Enhanced Console Printer
   class Configuration
@@ -45,10 +48,17 @@ module RailsConsolePro
     attr_accessor :navigate_command_enabled
     attr_accessor :stats_command_enabled
     attr_accessor :diff_command_enabled
+    attr_accessor :snippets_command_enabled
+    attr_accessor :profile_command_enabled
+    attr_accessor :queue_command_enabled
+    attr_accessor :introspect_command_enabled
+    attr_accessor :compare_command_enabled
+    attr_accessor :query_builder_command_enabled
     attr_accessor :active_record_printer_enabled
     attr_accessor :relation_printer_enabled
     attr_accessor :collection_printer_enabled
     attr_accessor :export_enabled
+    attr_accessor :snippet_store_path
 
     # Color customization
     attr_accessor :color_scheme
@@ -76,6 +86,11 @@ module RailsConsolePro
     attr_accessor :stats_large_table_threshold
     attr_accessor :stats_skip_distinct_threshold
 
+    # Profiling settings
+    attr_accessor :profile_slow_query_threshold
+    attr_accessor :profile_duplicate_query_threshold
+    attr_accessor :profile_max_saved_queries
+
     def initialize
       # Default feature toggles - all enabled
       @enabled = true
@@ -84,10 +99,17 @@ module RailsConsolePro
       @navigate_command_enabled = true
       @stats_command_enabled = true
       @diff_command_enabled = true
+      @snippets_command_enabled = true
+      @profile_command_enabled = true
+      @queue_command_enabled = true
+      @introspect_command_enabled = true
+      @compare_command_enabled = true
+      @query_builder_command_enabled = true
       @active_record_printer_enabled = true
       @relation_printer_enabled = true
       @collection_printer_enabled = true
       @export_enabled = true
+      @snippet_store_path = default_snippet_store_path
 
       # Default color scheme
       @color_scheme = :dark
@@ -138,6 +160,11 @@ module RailsConsolePro
       # Default stats calculation settings
       @stats_large_table_threshold = 10_000  # Consider table large if it has 10k+ records
       @stats_skip_distinct_threshold = 10_000  # Skip distinct count for tables with 10k+ records
+
+      # Default profiling settings
+      @profile_slow_query_threshold = 100.0 # milliseconds
+      @profile_duplicate_query_threshold = 2
+      @profile_max_saved_queries = 10
     end
 
     # Set color scheme (dark, light, or custom)
@@ -190,6 +217,10 @@ module RailsConsolePro
       @navigate_command_enabled = false
       @stats_command_enabled = false
       @diff_command_enabled = false
+      @queue_command_enabled = false
+      @introspect_command_enabled = false
+      @compare_command_enabled = false
+      @query_builder_command_enabled = false
       @active_record_printer_enabled = false
       @relation_printer_enabled = false
       @collection_printer_enabled = false
@@ -204,6 +235,10 @@ module RailsConsolePro
       @navigate_command_enabled = true
       @stats_command_enabled = true
       @diff_command_enabled = true
+      @queue_command_enabled = true
+      @introspect_command_enabled = true
+      @compare_command_enabled = true
+      @query_builder_command_enabled = true
       @active_record_printer_enabled = true
       @relation_printer_enabled = true
       @collection_printer_enabled = true
@@ -214,6 +249,22 @@ module RailsConsolePro
     def reset
       initialize
     end
+
+    private
+
+    def default_snippet_store_path
+      base_path =
+        if defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+          Rails.root.join('tmp', 'rails_console_pro')
+        else
+          File.expand_path(File.join(Dir.respond_to?(:pwd) ? Dir.pwd : Dir.tmpdir, 'tmp', 'rails_console_pro'))
+        end
+
+      base_path = Pathname.new(base_path) unless base_path.is_a?(Pathname)
+      (base_path + 'snippets.yml').to_s
+    rescue StandardError
+      File.join(Dir.tmpdir, 'rails_console_pro', 'snippets.yml')
+    end
   end
 end
 

data/lib/rails_console_pro/format_exporter.rb

@@ -81,6 +81,14 @@ module RailsConsolePro
         serialize_diff_result(data)
       when ExplainResult
         serialize_explain_result(data)
+      when ProfileResult
+        serialize_profile_result(data)
+      when IntrospectResult
+        serialize_introspect_result(data)
+      when CompareResult
+        serialize_compare_result(data)
+      when QueryBuilderResult
+        serialize_query_builder_result(data)
       when ActiveRecord::Base
         serialize_active_record(data)
       when ActiveRecord::Relation
@@ -131,6 +139,22 @@ module RailsConsolePro
       Serializers::DiffSerializer.serialize(result, self)
     end
 
+    def serialize_profile_result(result)
+      Serializers::ProfileSerializer.serialize(result, self)
+    end
+
+    def serialize_introspect_result(result)
+      Serializers::IntrospectSerializer.serialize(result, self)
+    end
+
+    def serialize_compare_result(result)
+      Serializers::CompareSerializer.serialize(result, self)
+    end
+
+    def serialize_query_builder_result(result)
+      Serializers::QueryBuilderSerializer.serialize(result, self)
+    end
+
     def serialize_active_record(record)
       Serializers::ActiveRecordSerializer.serialize(record, self)
     end
@@ -388,6 +412,14 @@ module RailsConsolePro
         "Diff Comparison: #{data.object1_type} vs #{data.object2_type}"
       when ExplainResult
         "SQL Explain Analysis"
+      when ProfileResult
+        "Profile: #{data.label || 'Session'}"
+      when IntrospectResult
+        "Introspection: #{data.model.name}"
+      when CompareResult
+        "Query Comparison (#{data.comparisons.size} strategies)"
+      when QueryBuilderResult
+        "Query Builder: #{data.model_class.name}"
       when ActiveRecord::Base
         "#{data.class.name} ##{data.id}"
       when ActiveRecord::Relation

data/lib/rails_console_pro/global_methods.rb

@@ -40,3 +40,27 @@ def diff(object1, object2)
   RailsConsolePro::Commands.diff(object1, object2)
 end
 
+def profile(target = nil, *args, **kwargs, &block)
+  RailsConsolePro::Commands.profile(target, *args, **kwargs, &block)
+end
+
+def jobs(options = {})
+  RailsConsolePro::Commands.jobs(options)
+end
+
+def snippets(action = :list, *args, **kwargs, &block)
+  RailsConsolePro::Commands.snippets(action, *args, **kwargs, &block)
+end
+
+def introspect(model_class, *options)
+  RailsConsolePro::Commands.introspect(model_class, *options)
+end
+
+def compare(&block)
+  RailsConsolePro::Commands.compare(&block)
+end
+
+def query(model_class, &block)
+  RailsConsolePro::Commands.query(model_class, &block)
+end
+

data/lib/rails_console_pro/initializer.rb

@@ -31,11 +31,18 @@ module RailsConsolePro
   autoload :ExplainResult,          "rails_console_pro/explain_result"
   autoload :StatsResult,            "rails_console_pro/stats_result"
   autoload :DiffResult,             "rails_console_pro/diff_result"
+  autoload :ProfileResult,          "rails_console_pro/profile_result"
+  autoload :QueueInsightsResult,    "rails_console_pro/queue_insights_result"
+  autoload :IntrospectResult,       "rails_console_pro/introspect_result"
+  autoload :CompareResult,          "rails_console_pro/compare_result"
+  autoload :QueryBuilderResult,     "rails_console_pro/query_builder_result"
+  autoload :QueryBuilder,           "rails_console_pro/query_builder"
   autoload :AssociationNavigator,  "rails_console_pro/association_navigator"
   autoload :Commands,               "rails_console_pro/commands"
   autoload :FormatExporter,         "rails_console_pro/format_exporter"
   autoload :ErrorHandler,           "rails_console_pro/error_handler"
   autoload :Paginator,              "rails_console_pro/paginator"
+  autoload :Snippets,               "rails_console_pro/snippets"
 
   module Printers
     autoload :ActiveRecordPrinter,  "rails_console_pro/printers/active_record_printer"
@@ -45,6 +52,13 @@ module RailsConsolePro
     autoload :ExplainPrinter,       "rails_console_pro/printers/explain_printer"
     autoload :StatsPrinter,         "rails_console_pro/printers/stats_printer"
     autoload :DiffPrinter,          "rails_console_pro/printers/diff_printer"
+    autoload :ProfilePrinter,       "rails_console_pro/printers/profile_printer"
+    autoload :IntrospectPrinter,    "rails_console_pro/printers/introspect_printer"
+    autoload :SnippetCollectionPrinter, "rails_console_pro/printers/snippet_collection_printer"
+    autoload :SnippetPrinter,           "rails_console_pro/printers/snippet_printer"
+    autoload :QueueInsightsPrinter, "rails_console_pro/printers/queue_insights_printer"
+    autoload :ComparePrinter,      "rails_console_pro/printers/compare_printer"
+    autoload :QueryBuilderPrinter, "rails_console_pro/printers/query_builder_printer"
   end
 
   # Main dispatcher - optimized with early returns
@@ -88,6 +102,17 @@ module RailsConsolePro
     return Printers::ExplainPrinter if value.is_a?(ExplainResult)
     return Printers::StatsPrinter if value.is_a?(StatsResult)
     return Printers::DiffPrinter if value.is_a?(DiffResult)
+    return Printers::ProfilePrinter if value.is_a?(ProfileResult)
+    return Printers::IntrospectPrinter if value.is_a?(IntrospectResult)
+    return Printers::QueueInsightsPrinter if value.is_a?(QueueInsightsResult)
+    return Printers::ComparePrinter if value.is_a?(CompareResult)
+    return Printers::QueryBuilderPrinter if value.is_a?(QueryBuilderResult)
+    if defined?(Snippets::CollectionResult) && value.is_a?(Snippets::CollectionResult)
+      return Printers::SnippetCollectionPrinter
+    end
+    if defined?(Snippets::SingleResult) && value.is_a?(Snippets::SingleResult)
+      return Printers::SnippetPrinter
+    end
     
     # Fallback to base printer
     BasePrinter
@@ -139,6 +164,11 @@ require_relative 'services/stats_calculator'
 require_relative 'services/table_size_calculator'
 require_relative 'services/index_analyzer'
 require_relative 'services/column_stats_calculator'
+require_relative 'services/profile_collector'
+require_relative 'services/snippet_repository'
+require_relative 'services/queue_action_service'
+require_relative 'services/queue_insight_fetcher'
+require_relative 'services/introspection_collector'
 
 # Load command classes (needed by Commands module)
 require_relative 'commands/base_command'
@@ -147,6 +177,12 @@ require_relative 'commands/explain_command'
 require_relative 'commands/stats_command'
 require_relative 'commands/diff_command'
 require_relative 'commands/export_command'
+require_relative 'commands/introspect_command'
+require_relative 'commands/snippets_command'
+require_relative 'commands/profile_command'
+require_relative 'commands/jobs_command'
+require_relative 'commands/compare_command'
+require_relative 'commands/query_builder_command'
 
 # Load Commands module (uses command classes)
 require_relative 'commands'
@@ -157,6 +193,10 @@ require_relative 'serializers/schema_serializer'
 require_relative 'serializers/stats_serializer'
 require_relative 'serializers/explain_serializer'
 require_relative 'serializers/diff_serializer'
+require_relative 'serializers/profile_serializer'
+require_relative 'serializers/introspect_serializer'
+require_relative 'serializers/compare_serializer'
+require_relative 'serializers/query_builder_serializer'
 require_relative 'serializers/active_record_serializer'
 require_relative 'serializers/relation_serializer'
 require_relative 'serializers/array_serializer'
@@ -173,6 +213,6 @@ end
 if RailsConsolePro.config.show_welcome_message && defined?(Pry)
   pastel = RailsConsolePro::PASTEL
   puts pastel.bright_green("🚀 Rails Console Pro Loaded!")
-  puts pastel.cyan("📊 Use `schema ModelName`, `explain Query`, `stats ModelName`, `diff obj1, obj2`, or `navigate ModelName`")
+  puts pastel.cyan("📊 Use `schema`, `explain`, `stats`, `introspect`, `diff`, `navigate`, `profile`, or `jobs` commands")
   puts pastel.dim("💾 Export support: Use `.to_json`, `.to_yaml`, `.to_html`, or `.export_to_file` on any result")
 end

data/lib/rails_console_pro/introspect_result.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  # Value object for model introspection results
+  class IntrospectResult
+    attr_reader :model, :callbacks, :enums, :concerns, :scopes, 
+                :validations, :lifecycle_hooks, :timestamp
+
+    def initialize(model:, callbacks: {}, enums: {}, concerns: [], 
+                   scopes: {}, validations: [], lifecycle_hooks: {},
+                   timestamp: Time.current)
+      @model = model
+      @callbacks = callbacks
+      @enums = enums
+      @concerns = concerns
+      @scopes = scopes
+      @validations = validations
+      @lifecycle_hooks = lifecycle_hooks
+      @timestamp = timestamp
+      validate_model!
+    end
+
+    def ==(other)
+      other.is_a?(self.class) && other.model == model && other.timestamp == timestamp
+    end
+
+    # Query methods
+    def has_callbacks?
+      callbacks.any?
+    end
+
+    def has_enums?
+      enums.any?
+    end
+
+    def has_concerns?
+      concerns.any?
+    end
+
+    def has_scopes?
+      scopes.any?
+    end
+
+    def has_validations?
+      validations.any?
+    end
+
+    # Get callbacks by type
+    def callbacks_by_type(type)
+      callbacks[type] || []
+    end
+
+    # Get validations for attribute
+    def validations_for(attribute)
+      validations[attribute] || []
+    end
+
+    # Get enum values
+    def enum_values(enum_name)
+      enums.dig(enum_name.to_s, :values) || []
+    end
+
+    # Get scope SQL
+    def scope_sql(scope_name)
+      scopes.dig(scope_name.to_sym, :sql)
+    end
+
+    # Get method source location
+    def method_source(method_name)
+      collector = Services::IntrospectionCollector.new(model)
+      collector.method_source_location(method_name)
+    end
+
+    # Export to JSON
+    def to_json(pretty: true)
+      FormatExporter.to_json(self, pretty: pretty)
+    end
+
+    # Export to YAML
+    def to_yaml
+      FormatExporter.to_yaml(self)
+    end
+
+    # Export to HTML
+    def to_html(style: :default)
+      FormatExporter.to_html(self, title: "Introspection: #{model.name}", style: style)
+    end
+
+    # Export to file
+    def export_to_file(file_path, format: nil)
+      FormatExporter.export_to_file(self, file_path, format: format)
+    end
+
+    private
+
+    def validate_model!
+      ModelValidator.validate_model!(model)
+    end
+  end
+end
+

data/lib/rails_console_pro/model_validator.rb

@@ -27,7 +27,7 @@ module RailsConsolePro
     # Check if model is abstract
     def abstract_class?(model_class)
       return false unless valid_model?(model_class)
-      model_class.abstract_class?
+      !!model_class.abstract_class?
     end
 
     # Check if model uses Single Table Inheritance (STI)

data/lib/rails_console_pro/printers/compare_printer.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  module Printers
+    # Printer for query comparison results
+    class ComparePrinter < BasePrinter
+      def print
+        print_header
+        print_summary
+        print_comparisons
+        print_winner
+        print_footer
+      end
+
+      private
+
+      def print_header
+        header_color = config.get_color(:header)
+        output.puts bold_color(header_color, "═" * config.header_width)
+        output.puts bold_color(header_color, "⚖️  QUERY COMPARISON")
+        output.puts bold_color(header_color, "═" * config.header_width)
+      end
+
+      def print_summary
+        output.puts bold_color(config.get_color(:warning), "\n📊 Summary:")
+        output.puts "  Total Strategies: #{color(config.get_color(:attribute_value_numeric), value.comparisons.size)}"
+        output.puts "  Fastest: #{color(config.get_color(:success), value.fastest_name || 'N/A')}"
+        output.puts "  Slowest: #{color(config.get_color(:error), value.slowest_name || 'N/A')}"
+        
+        if value.performance_ratio
+          ratio = value.performance_ratio
+          ratio_color = ratio > 2 ? config.get_color(:error) : config.get_color(:warning)
+          output.puts "  Performance Ratio: #{color(ratio_color, "#{ratio}x slower")}"
+        end
+
+        if value.has_errors?
+          output.puts "  Errors: #{color(config.get_color(:error), value.error_count.to_s)}"
+        end
+      end
+
+      def print_comparisons
+        output.puts bold_color(config.get_color(:warning), "\n📈 Detailed Results:")
+        
+        sorted = value.comparisons.sort_by { |c| c.duration_ms || Float::INFINITY }
+        
+        sorted.each_with_index do |comparison, index|
+          print_comparison(comparison, index + 1, sorted.size)
+        end
+      end
+
+      def print_comparison(comparison, rank, total)
+        is_winner = comparison == value.fastest
+        rank_color = is_winner ? config.get_color(:success) : config.get_color(:attribute_value_string)
+        
+        output.puts "\n  #{color(rank_color, "##{rank}")} #{bold_color(rank_color, comparison.name)}"
+        
+        if comparison.error
+          output.puts "    #{color(config.get_color(:error), "❌ Error: #{comparison.error.class} - #{comparison.error.message}")}"
+          return
+        end
+
+        # Duration
+        duration_str = format_duration(comparison.duration_ms)
+        output.puts "    ⏱️  Duration: #{duration_str}"
+
+        # Query count
+        query_color = comparison.query_count > 10 ? config.get_color(:error) : 
+                      comparison.query_count > 1 ? config.get_color(:warning) : 
+                      config.get_color(:success)
+        output.puts "    🔢 Queries: #{color(query_color, comparison.query_count.to_s)}"
+
+        # Memory usage
+        if comparison.memory_usage_kb && comparison.memory_usage_kb > 0
+          memory_str = format_memory(comparison.memory_usage_kb)
+          output.puts "    💾 Memory: #{color(config.get_color(:info), memory_str)}"
+        end
+
+        # SQL queries preview
+        if comparison.sql_queries&.any?
+          preview_count = [comparison.sql_queries.size, 3].min
+          output.puts "    📝 SQL Queries (#{comparison.sql_queries.size} total):"
+          comparison.sql_queries.first(preview_count).each_with_index do |query_info, idx|
+            sql_preview = truncate_sql(query_info[:sql], 60)
+            duration = query_info[:duration_ms]
+            cached = query_info[:cached] ? " (cached)" : ""
+            output.puts "      #{idx + 1}. #{color(config.get_color(:attribute_value_string), sql_preview)} #{color(config.get_color(:border), "(#{duration}ms#{cached})")}"
+          end
+          if comparison.sql_queries.size > preview_count
+            output.puts "      ... and #{comparison.sql_queries.size - preview_count} more"
+          end
+        end
+      end
+
+      def print_winner
+        return unless value.winner
+
+        output.puts bold_color(config.get_color(:success), "\n🏆 Winner: #{value.winner.name}")
+        if value.performance_ratio && value.performance_ratio > 1
+          output.puts "   #{color(config.get_color(:info), "This strategy is #{value.performance_ratio.round(1)}x faster than the slowest")}"
+        end
+      end
+
+      def print_footer
+        footer_color = config.get_color(:footer)
+        output.puts bold_color(footer_color, "═" * config.header_width)
+      end
+
+      def format_duration(ms)
+        return color(config.get_color(:attribute_value_nil), "N/A") unless ms
+
+        case ms
+        when 0...10
+          color(config.get_color(:success), "#{ms.round(2)}ms")
+        when 10...100
+          color(config.get_color(:warning), "#{ms.round(2)}ms")
+        else
+          color(config.get_color(:error), "#{ms.round(2)}ms")
+        end
+      end
+
+      def format_memory(kb)
+        if kb < 1024
+          "#{kb.round(2)} KB"
+        elsif kb < 1024 * 1024
+          "#{(kb / 1024.0).round(2)} MB"
+        else
+          "#{(kb / (1024.0 * 1024.0)).round(2)} GB"
+        end
+      end
+
+      def truncate_sql(sql, max_length)
+        return sql if sql.length <= max_length
+        "#{sql[0, max_length - 3]}..."
+      end
+    end
+  end
+end
+