rails_console_pro 0.1.1 → 0.1.3

data/lib/rails_console_pro/commands/snippets_command.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  module Commands
+    # Command for managing, searching, and listing reusable console snippets
+    class SnippetsCommand < BaseCommand
+      DEFAULT_LIST_LIMIT = 10
+
+      def execute(action = :list, *args, **kwargs, &block)
+        return disabled_message unless enabled?
+
+        action = infer_action(action, args)
+        case action
+        when :list
+          list_snippets(**kwargs)
+        when :search
+          search_snippets(*args, **kwargs)
+        when :add, :create
+          add_snippet(*args, **kwargs, &block)
+        when :show
+          show_snippet(*args)
+        when :delete, :remove
+          delete_snippet(*args)
+        when :favorite
+          toggle_favorite(*args, value: true)
+        when :unfavorite
+          toggle_favorite(*args, value: false)
+        else
+          pastel.red("Unknown snippets action: #{action}")
+        end
+      rescue ArgumentError => e
+        pastel.red("Snippets error: #{e.message}")
+      end
+
+      private
+
+      def enabled?
+        RailsConsolePro.config.enabled && RailsConsolePro.config.snippets_command_enabled
+      end
+
+      def disabled_message
+        pastel.yellow('Snippets command is disabled. Enable via RailsConsolePro.configure { |c| c.snippets_command_enabled = true }')
+      end
+
+      def infer_action(action, args)
+        return action.to_sym if action.respond_to?(:to_sym)
+        return :search if args.any?
+
+        :list
+      end
+
+      def list_snippets(limit: DEFAULT_LIST_LIMIT, favorites: false)
+        snippets = repository.all(limit: limit)
+        snippets = snippets.select(&:favorite?) if favorites
+
+        Snippets::CollectionResult.new(
+          snippets: snippets,
+          limit: limit,
+          total_count: repository.all.size,
+          tags: favorites ? ['favorite'] : []
+        )
+      end
+
+      def search_snippets(term = nil, tags: nil, limit: DEFAULT_LIST_LIMIT)
+        search_result = repository.search(term: term, tags: tags, limit: limit)
+        snippets = search_result[:results]
+        Snippets::CollectionResult.new(
+          snippets: snippets,
+          query: term,
+          tags: Array(tags),
+          limit: limit,
+          total_count: search_result[:total_count]
+        )
+      end
+
+      def add_snippet(body = nil, id: nil, tags: nil, description: nil, favorite: false, metadata: nil, &block)
+        snippet_body = extract_body(body, &block)
+
+        snippet = repository.add(
+          body: snippet_body,
+          id: id,
+          tags: tags,
+          description: description,
+          favorite: favorite,
+          metadata: metadata
+        )
+
+        Snippets::SingleResult.new(snippet: snippet, action: :add, created: true)
+      end
+
+      def show_snippet(id)
+        snippet = repository.find(id)
+        return pastel.yellow("No snippet found for '#{id}'") unless snippet
+
+        Snippets::SingleResult.new(snippet: snippet, action: :show, created: false)
+      end
+
+      def delete_snippet(id)
+        if repository.delete(id)
+          pastel.green("Removed snippet '#{id}'")
+        else
+          pastel.yellow("No snippet found for '#{id}'")
+        end
+      end
+
+      def toggle_favorite(id, value:)
+        snippet = repository.update(id, favorite: value)
+        return pastel.yellow("No snippet found for '#{id}'") unless snippet
+
+        status = value ? 'marked as favorite' : 'removed from favorites'
+        message = pastel.green("Snippet '#{id}' #{status}.")
+        Snippets::SingleResult.new(
+          snippet: snippet,
+          action: value ? :favorite : :unfavorite,
+          created: false,
+          message: message
+        )
+      end
+
+      def extract_body(body, &block)
+        content = if block
+                    result = block.call
+                    result.respond_to?(:join) ? result.join("\n") : result.to_s
+                  else
+                    body
+                  end
+
+        raise ArgumentError, 'Snippet body is required' if content.nil? || content.to_s.strip.empty?
+
+        content.to_s
+      end
+
+      def repository
+        @repository ||= RailsConsolePro::Services::SnippetRepository.new(
+          store_path: RailsConsolePro.config.snippet_store_path
+        )
+      end
+    end
+  end
+end
+

data/lib/rails_console_pro/commands.rb

@@ -30,5 +30,20 @@ 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
   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,14 @@ 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 :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 +83,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 +96,14 @@ 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
       @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 +154,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 +211,7 @@ module RailsConsolePro
       @navigate_command_enabled = false
       @stats_command_enabled = false
       @diff_command_enabled = false
+      @queue_command_enabled = false
       @active_record_printer_enabled = false
       @relation_printer_enabled = false
       @collection_printer_enabled = false
@@ -204,6 +226,7 @@ module RailsConsolePro
       @navigate_command_enabled = true
       @stats_command_enabled = true
       @diff_command_enabled = true
+      @queue_command_enabled = true
       @active_record_printer_enabled = true
       @relation_printer_enabled = true
       @collection_printer_enabled = true
@@ -214,6 +237,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,8 @@ module RailsConsolePro
         serialize_diff_result(data)
       when ExplainResult
         serialize_explain_result(data)
+      when ProfileResult
+        serialize_profile_result(data)
       when ActiveRecord::Base
         serialize_active_record(data)
       when ActiveRecord::Relation
@@ -131,6 +133,10 @@ module RailsConsolePro
       Serializers::DiffSerializer.serialize(result, self)
     end
 
+    def serialize_profile_result(result)
+      Serializers::ProfileSerializer.serialize(result, self)
+    end
+
     def serialize_active_record(record)
       Serializers::ActiveRecordSerializer.serialize(record, self)
     end
@@ -388,6 +394,8 @@ module RailsConsolePro
         "Diff Comparison: #{data.object1_type} vs #{data.object2_type}"
       when ExplainResult
         "SQL Explain Analysis"
+      when ProfileResult
+        "Profile: #{data.label || 'Session'}"
       when ActiveRecord::Base
         "#{data.class.name} ##{data.id}"
       when ActiveRecord::Relation

data/lib/rails_console_pro/global_methods.rb

@@ -40,3 +40,15 @@ 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
+

data/lib/rails_console_pro/initializer.rb

@@ -8,6 +8,9 @@ module RailsConsolePro
 
   # Singleton Pastel instance
   PASTEL = Pastel.new(enabled: TTY::Color.color?)
+  
+  # Require ColorHelper early since it's used throughout
+  require_relative 'color_helper'
 
   # Configuration instance
   def config
@@ -22,18 +25,20 @@ module RailsConsolePro
 
   # Autoload all components
   autoload :Configuration,          "rails_console_pro/configuration"
-  autoload :ColorHelper,            "rails_console_pro/color_helper"
   autoload :BasePrinter,            "rails_console_pro/base_printer"
   autoload :ModelValidator,         "rails_console_pro/model_validator"
   autoload :SchemaInspectorResult,  "rails_console_pro/schema_inspector_result"
   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 :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"
@@ -43,6 +48,10 @@ 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 :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"
   end
 
   # Main dispatcher - optimized with early returns
@@ -57,7 +66,7 @@ module RailsConsolePro
   rescue => e
     # Show error in development to help debug
     if Rails.env.development? || ENV['RAILS_CONSOLE_PRO_DEBUG']
-      pastel = ColorHelper.pastel
+      pastel = PASTEL
       output.puts pastel.red.bold("💥 RailsConsolePro Error: #{e.class}: #{e.message}")
       output.puts pastel.dim(e.backtrace.first(5).join("\n"))
     end
@@ -86,6 +95,14 @@ 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::QueueInsightsPrinter if value.is_a?(QueueInsightsResult)
+    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
@@ -105,7 +122,7 @@ module RailsConsolePro
   end
 
   def handle_error(output, error, value, pry_instance)
-    pastel = ColorHelper.pastel
+    pastel = PASTEL
     output.puts pastel.red.bold("💥 #{error.class}: #{error.message}")
     output.puts pastel.dim(error.backtrace.first(3).join("\n"))
     default_print(output, value, pry_instance)
@@ -137,6 +154,10 @@ 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'
 
 # Load command classes (needed by Commands module)
 require_relative 'commands/base_command'
@@ -145,6 +166,9 @@ require_relative 'commands/explain_command'
 require_relative 'commands/stats_command'
 require_relative 'commands/diff_command'
 require_relative 'commands/export_command'
+require_relative 'commands/snippets_command'
+require_relative 'commands/profile_command'
+require_relative 'commands/jobs_command'
 
 # Load Commands module (uses command classes)
 require_relative 'commands'
@@ -155,6 +179,7 @@ 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/active_record_serializer'
 require_relative 'serializers/relation_serializer'
 require_relative 'serializers/array_serializer'
@@ -169,7 +194,7 @@ end
 
 # Print welcome message if enabled (only for Pry)
 if RailsConsolePro.config.show_welcome_message && defined?(Pry)
-  pastel = ColorHelper.pastel
+  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.dim("💾 Export support: Use `.to_json`, `.to_yaml`, `.to_html`, or `.export_to_file` on any result")

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/profile_printer.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  module Printers
+    # Printer for profile results
+    class ProfilePrinter < BasePrinter
+      def print
+        print_header
+        print_summary
+        print_sql_breakdown
+        print_cache_breakdown
+        print_instantiation_info
+        print_slow_queries
+        print_duplicate_queries
+        print_query_samples
+        print_result_preview
+        print_error_info
+        print_footer
+      end
+
+      private
+
+      def print_header
+        label = value.label || 'Profiling Session'
+        header_color = config.get_color(:header)
+        border_length = config.header_width
+
+        output.puts bold_color(header_color, '═' * border_length)
+        output.puts bold_color(header_color, "🧪 PROFILE: #{label}")
+        output.puts bold_color(header_color, '═' * border_length)
+      end
+
+      def print_summary
+        output.puts bold_color(config.get_color(:warning), "\n⏱ Execution Summary:")
+        output.puts "  #{summary_line('Total time', format_ms(value.duration_ms), config.get_color(:success))}"
+        output.puts "  #{summary_line('SQL time', format_ms(value.total_sql_duration_ms), config.get_color(:attribute_value_numeric))}"
+        sql_ratio = ratio(value.total_sql_duration_ms, value.duration_ms)
+        output.puts color(config.get_color(:info), "    (#{sql_ratio}% of total time spent in SQL)") if sql_ratio
+      end
+
+      def print_sql_breakdown
+        output.puts bold_color(config.get_color(:warning), "\n🗂 Query Breakdown:")
+        output.puts "  #{summary_line('Total queries', value.query_count, config.get_color(:attribute_value_numeric))}"
+        output.puts "  #{summary_line('Read queries', value.read_query_count, config.get_color(:attribute_value_string))}"
+        output.puts "  #{summary_line('Write queries', value.write_query_count, config.get_color(:attribute_value_numeric))}"
+        output.puts "  #{summary_line('Cached queries', value.cached_query_count, config.get_color(:info))}"
+      end
+
+      def print_cache_breakdown
+        return unless value.cache_activity?
+
+        output.puts bold_color(config.get_color(:warning), "\n🧮 Cache Activity:")
+        output.puts "  #{summary_line('Cache hits', value.cache_hits, config.get_color(:success))}"
+        output.puts "  #{summary_line('Cache misses', value.cache_misses, config.get_color(:error))}"
+        output.puts "  #{summary_line('Cache writes', value.cache_writes, config.get_color(:attribute_value_numeric))}"
+      end
+
+      def print_instantiation_info
+        return if value.instantiation_count.zero?
+
+        output.puts bold_color(config.get_color(:warning), "\n📦 Records Instantiated:")
+        output.puts "  #{summary_line('ActiveRecord objects', value.instantiation_count, config.get_color(:attribute_value_numeric))}"
+      end
+
+      def print_slow_queries
+        return unless value.slow_queries?
+
+        output.puts bold_color(config.get_color(:warning), "\n🐢 Slow Queries (#{config.profile_slow_query_threshold}ms+):")
+        value.slow_queries.each_with_index do |query, index|
+          print_query_item(index + 1, query, highlight: config.get_color(:error))
+        end
+      end
+
+      def print_duplicate_queries
+        return unless value.duplicate_queries?
+
+        output.puts bold_color(config.get_color(:warning), "\n♻️  Possible N+1 Queries:")
+        value.duplicate_queries.each_with_index do |duplicate, index|
+          sql_preview = truncate_sql(duplicate.sql)
+          duration = format_ms(duplicate.total_duration_ms)
+          output.puts "  #{index + 1}. #{bold_color(config.get_color(:error), "#{duplicate.count}x")} "\
+                      "#{color(config.get_color(:attribute_value_string), sql_preview)} "\
+                      "#{color(config.get_color(:info), "(#{duration} total)")} "\
+                      "#{color(config.get_color(:warning), "[#{duplicate.fingerprint.hash}]")}"
+        end
+      end
+
+      def print_query_samples
+        return unless value.query_samples?
+
+        output.puts bold_color(config.get_color(:warning), "\n🔍 Query Samples:")
+        value.query_samples.each_with_index do |query, index|
+          print_query_item(index + 1, query)
+        end
+      end
+
+      def print_result_preview
+        preview = format_result_preview(value.result)
+        output.puts bold_color(config.get_color(:warning), "\n🧾 Result Preview:")
+        output.puts "  #{preview}"
+      end
+
+      def print_error_info
+        return unless value.error?
+
+        error = value.error
+        output.puts bold_color(config.get_color(:error), "\n⚠️  Error Raised During Profiling:")
+        output.puts "  #{color(config.get_color(:error), "#{error.class}: #{error.message}")}"
+        backtrace = Array(error.backtrace).first(3)
+        backtrace.each do |line|
+          output.puts color(config.get_color(:info), "    ↳ #{line}")
+        end
+      end
+
+      def print_footer
+        footer_color = config.get_color(:footer)
+        output.puts bold_color(footer_color, "\n" + '═' * config.header_width)
+        if value.started_at && value.finished_at
+          output.puts color(:dim, "Started: #{value.started_at.strftime('%Y-%m-%d %H:%M:%S')}")
+          output.puts color(:dim, "Finished: #{value.finished_at.strftime('%Y-%m-%d %H:%M:%S')}")
+        end
+      end
+
+      def summary_line(label, value, color_value)
+        "#{label.ljust(18)} #{bold_color(color_value, value.to_s)}"
+      end
+
+      def format_ms(duration_ms)
+        return '0.00 ms' if duration_ms.nil?
+
+        format('%.2f ms', duration_ms)
+      end
+
+      def ratio(value, total)
+        return nil if total.to_f.zero?
+
+        ((value.to_f / total.to_f) * 100).round(2)
+      end
+
+      def truncate_sql(sql)
+        sql.to_s.gsub(/\s+/, ' ').strip.truncate(120)
+      end
+
+      def print_query_item(index, query, highlight: config.get_color(:attribute_value_numeric))
+        duration = format_ms(query.duration_ms)
+        cached_label = query.cached ? color(config.get_color(:info), '[cache] ') : ''
+        name_label = query.name.to_s.empty? ? '' : color(config.get_color(:attribute_key), "(#{query.name}) ")
+        binds = format_binds(query.binds)
+
+        output.puts "  #{index}. #{bold_color(highlight, duration)} #{cached_label}#{name_label}"\
+                    "#{color(config.get_color(:attribute_value_string), truncate_sql(query.sql))}"
+        output.puts "     #{color(:dim, binds)}" if binds
+      end
+
+      def format_binds(binds)
+        return nil if binds.nil? || binds.empty?
+
+        "binds: #{binds.map { |b| b.nil? ? 'nil' : b.inspect }.join(', ')}"
+      end
+
+      def format_result_preview(result)
+        case result
+        when NilClass
+          color(config.get_color(:attribute_value_nil), 'nil')
+        when Array
+          color(config.get_color(:attribute_value_numeric), "#{result.class.name} (#{result.size} items)")
+        when ActiveRecord::Relation
+          color(config.get_color(:attribute_value_numeric), "#{result.klass.name} relation (#{result.count} records)")
+        when ActiveRecord::Base
+          color(config.get_color(:attribute_value_string), "#{result.class.name}##{result.id || 'new'}")
+        else
+          color(config.get_color(:attribute_value_string), result.inspect.truncate(120))
+        end
+      rescue => e
+        color(config.get_color(:error), "Error previewing result: #{e.message}")
+      end
+    end
+  end
+end
+