rails_console_pro 0.1.0

data/lib/rails_console_pro/services/column_stats_calculator.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  module Services
+    # Service for calculating column statistics
+    class ColumnStatsCalculator
+      def self.calculate(model_class, connection, table_name, safe_count_proc, config)
+        new(model_class, connection, table_name, safe_count_proc, config).calculate
+      end
+
+      def initialize(model_class, connection, table_name, safe_count_proc, config)
+        @model_class = model_class
+        @connection = connection
+        @table_name = table_name
+        @safe_count = safe_count_proc
+        @config = config
+      end
+
+      def calculate
+        # Skip for large tables (already checked in execute_stats, but defensive)
+        return {} if ModelValidator.large_table?(@model_class)
+        
+        column_names = ModelValidator.safe_column_names(@model_class)
+        return {} unless column_names.any?
+
+        column_stats = {}
+        total_count = @safe_count.call
+        
+        # Skip distinct count for very large tables (performance)
+        skip_distinct_threshold = @config.stats_skip_distinct_threshold
+        skip_distinct = total_count >= skip_distinct_threshold
+
+        column_names.each do |column_name|
+          stats = {}
+          
+          # Count nulls (safe with error handling)
+          begin
+            null_count = @model_class.where("#{@connection.quote_column_name(column_name)} IS NULL").count
+            stats[:null_count] = null_count if null_count > 0
+          rescue => e
+            # Skip if column doesn't support null checks or query fails
+          end
+
+          # Count distinct values (only for smaller tables)
+          unless skip_distinct
+            begin
+              distinct_count = @model_class.distinct.count(column_name)
+              stats[:distinct_count] = distinct_count if distinct_count > 0
+            rescue => e
+              # Skip if calculation fails
+            end
+          end
+
+          column_stats[column_name] = stats if stats.any?
+        end
+
+        column_stats
+      rescue => e
+        {} # Return empty hash on any error
+      end
+    end
+  end
+end
+

data/lib/rails_console_pro/services/index_analyzer.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  module Services
+    # Service for analyzing database index usage
+    class IndexAnalyzer
+      def self.analyze(connection, table_name)
+        new(connection, table_name).analyze
+      end
+
+      def initialize(connection, table_name)
+        @connection = connection
+        @table_name = table_name
+      end
+
+      def analyze
+        return {} unless @table_name
+        
+        adapter_name = @connection.adapter_name.downcase
+        index_usage = {}
+
+        case adapter_name
+        when /postgresql/
+          analyze_postgresql(index_usage)
+        when /mysql/
+          analyze_mysql(index_usage)
+        else
+          analyze_fallback(index_usage)
+        end
+
+        index_usage
+      rescue => e
+        {} # Return empty hash on any error
+      end
+
+      private
+
+      def analyze_postgresql(index_usage)
+        # Get index usage statistics from pg_stat_user_indexes
+        begin
+          quoted_table = @connection.quote(@table_name)
+          result = @connection.execute(
+            "SELECT schemaname, indexrelname, idx_scan, idx_tup_read, idx_tup_fetch
+             FROM pg_stat_user_indexes
+             WHERE relname = #{quoted_table}"
+          )
+          result.each do |row|
+            index_name = row['indexrelname'] || row[:indexrelname]
+            scans = row['idx_scan'] || row[:idx_scan] || 0
+            rows_read = row['idx_tup_read'] || row[:idx_tup_read] || 0
+            index_usage[index_name] = {
+              used: scans > 0,
+              scans: scans.to_i,
+              rows: rows_read.to_i
+            }
+          end
+        rescue => e
+          # Fallback to just listing indexes
+          fallback_to_listing(index_usage)
+        end
+      end
+
+      def analyze_mysql(index_usage)
+        # MySQL index usage from information_schema
+        begin
+          quoted_table = @connection.quote(@table_name)
+          result = @connection.execute(
+            "SELECT INDEX_NAME, SEQ_IN_INDEX, CARDINALITY
+             FROM information_schema.STATISTICS
+             WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = #{quoted_table}
+             GROUP BY INDEX_NAME"
+          )
+          result.each do |row|
+            index_name = row['INDEX_NAME'] || row[:index_name]
+            cardinality = row['CARDINALITY'] || row[:cardinality] || 0
+            index_usage[index_name] = {
+              used: cardinality.to_i > 0,
+              cardinality: cardinality.to_i
+            }
+          end
+        rescue => e
+          # Fallback
+          fallback_to_listing(index_usage)
+        end
+      end
+
+      def analyze_fallback(index_usage)
+        # Fallback: just list indexes
+        begin
+          indexes = @connection.indexes(@table_name)
+          indexes.each { |idx| index_usage[idx.name] = "available" }
+        rescue => e
+          # If indexes fail, return empty
+          {}
+        end
+      end
+
+      def fallback_to_listing(index_usage)
+        begin
+          indexes = @connection.indexes(@table_name)
+          indexes.each { |idx| index_usage[idx.name] = { used: false } }
+        rescue => e
+          # If indexes fail, return empty
+          {}
+        end
+      end
+    end
+  end
+end
+

data/lib/rails_console_pro/services/stats_calculator.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  module Services
+    # Service for calculating model growth rate statistics
+    class StatsCalculator
+      def self.calculate_growth_rate(model_class, safe_count_proc)
+        new(model_class, safe_count_proc).calculate_growth_rate
+      end
+
+      def initialize(model_class, safe_count_proc)
+        @model_class = model_class
+        @safe_count = safe_count_proc
+      end
+
+      def calculate_growth_rate
+        # Double-check created_at exists (defensive programming)
+        return nil unless ModelValidator.has_timestamp_column?(@model_class)
+        return nil unless ModelValidator.has_table?(@model_class)
+
+        begin
+          # Get count from 1 hour ago
+          one_hour_ago = 1.hour.ago
+          old_count = @model_class.where('created_at < ?', one_hour_ago).count
+          return nil if old_count == 0
+
+          current_count = @safe_count.call
+          return nil if current_count == old_count || current_count == 0
+
+          # Calculate percentage change
+          ((current_count - old_count).to_f / old_count * 100).round(2)
+        rescue => e
+          # Silently fail - growth rate is optional
+          nil
+        end
+      end
+    end
+  end
+end
+

data/lib/rails_console_pro/services/table_size_calculator.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  module Services
+    # Service for calculating database table sizes
+    class TableSizeCalculator
+      def self.calculate(connection, table_name)
+        new(connection, table_name).calculate
+      end
+
+      def initialize(connection, table_name)
+        @connection = connection
+        @table_name = table_name
+      end
+
+      def calculate
+        adapter_name = @connection.adapter_name.downcase
+        quoted_table = @connection.quote(@table_name)
+
+        size_value = case adapter_name
+        when /postgresql/
+          result = @connection.execute("SELECT pg_total_relation_size(#{quoted_table}) as size")
+          row = result.first
+          row['size'] || row[:size]
+        when /mysql/
+          result = @connection.execute(
+            "SELECT data_length + index_length as size FROM information_schema.tables WHERE table_schema = DATABASE() AND table_name = #{quoted_table}"
+          )
+          row = result.first
+          row['size'] || row[:size]
+        else
+          nil
+        end
+        
+        return nil unless size_value
+        size_value.is_a?(Numeric) ? size_value : size_value.to_i
+      rescue => e
+        nil
+      end
+    end
+  end
+end
+

data/lib/rails_console_pro/stats_result.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  # Value object for model statistics
+  class StatsResult
+    attr_reader :model, :record_count, :growth_rate, :table_size, 
+                :index_usage, :column_stats, :timestamp
+
+    def initialize(model:, record_count:, growth_rate: nil, table_size: nil,
+                   index_usage: {}, column_stats: {}, timestamp: Time.current)
+      @model = model
+      @record_count = record_count
+      @growth_rate = growth_rate
+      @table_size = table_size
+      @index_usage = index_usage
+      @column_stats = column_stats
+      @timestamp = timestamp
+      validate_model!
+    end
+
+    def ==(other)
+      other.is_a?(self.class) && other.model == model && other.timestamp == timestamp
+    end
+
+    def has_growth_data?
+      !growth_rate.nil?
+    end
+
+    def has_table_size?
+      !table_size.nil?
+    end
+
+    def has_index_data?
+      index_usage.any?
+    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: "Statistics: #{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)
+      if ModelValidator.abstract_class?(model)
+        raise ArgumentError, "#{model} is an abstract class and has no database table"
+      end
+    end
+  end
+end

data/lib/rails_console_pro/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module RailsConsolePro
+  VERSION = "0.1.0"
+end
+

data/lib/rails_console_pro.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "rails_console_pro/version"
+require_relative "rails_console_pro/initializer"
+
+# Auto-load Railtie for Rails integration
+if defined?(Rails)
+  require_relative "rails_console_pro/railtie"
+end
+
+# Main entry point for Rails Console Pro
+module RailsConsolePro
+  class Error < StandardError; end
+end

data/lib/tasks/rails_console_pro.rake

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+namespace :rails_console_pro do
+  desc "Display Rails Console Pro version"
+  task :version do
+    require_relative "../rails_console_pro/version"
+    puts "Rails Console Pro version: #{RailsConsolePro::VERSION}"
+  end
+end
+

data/rails_console_pro.gemspec

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require_relative "lib/rails_console_pro/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "rails_console_pro"
+  spec.version       = RailsConsolePro::VERSION
+  spec.authors       = ["Harsh"]
+  spec.email         = ["harsh.patel.hp846@gmail.com"]
+
+  spec.summary       = "Enhanced Rails console with schema inspection, SQL explain, association navigation, and beautiful formatting"
+  spec.description   = <<~DESC
+    Rails Console Pro enhances your Rails console with powerful debugging tools:
+    - Beautiful colored formatting for ActiveRecord objects
+    - Schema inspection with columns, indexes, associations, validations
+    - SQL explain analysis with performance recommendations
+    - Interactive association navigation
+    - Model statistics (record counts, growth rates, table sizes)
+    - Object diffing and comparison
+    - Export to JSON, YAML, and HTML
+    - Smart pagination for large collections
+  DESC
+  spec.homepage      = "https://github.com/yourusername/rails_console_pro"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/yourusername/rails_console_pro"
+  spec.metadata["changelog_uri"] = "https://github.com/yourusername/rails_console_pro/blob/main/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  rescue
+    # Fallback if git is not available
+    Dir.glob("{lib,exe}/**/*", File::FNM_DOTMATCH).select { |f| File.file?(f) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Dependencies
+  spec.add_dependency "pastel", "~> 0.8.0"
+  spec.add_dependency "tty-color", "~> 0.6.0"
+  # Pry is optional - gem works with or without it
+  # Users can install pry-rails separately if they want Pry as default console
+  spec.add_dependency "pry", ">= 0.14.0", "< 0.16.0"
+
+  # Development dependencies
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "rails", ">= 6.0"
+  spec.add_development_dependency "sqlite3", "~> 2.1"
+end
+

metadata

@@ -0,0 +1,240 @@
+--- !ruby/object:Gem::Specification
+name: rails_console_pro
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Harsh
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: tty-color
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 0.16.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 0.16.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+description: |
+  Rails Console Pro enhances your Rails console with powerful debugging tools:
+  - Beautiful colored formatting for ActiveRecord objects
+  - Schema inspection with columns, indexes, associations, validations
+  - SQL explain analysis with performance recommendations
+  - Interactive association navigation
+  - Model statistics (record counts, growth rates, table sizes)
+  - Object diffing and comparison
+  - Export to JSON, YAML, and HTML
+  - Smart pagination for large collections
+email:
+- harsh.patel.hp846@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".rspec"
+- ".rspec_status"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE.txt
+- QUICK_START.md
+- README.md
+- Rakefile
+- config/database.yml
+- docs/ASSOCIATION_NAVIGATION.md
+- docs/EXPORT.md
+- docs/FORMATTING.md
+- docs/MODEL_STATISTICS.md
+- docs/OBJECT_DIFFING.md
+- docs/SCHEMA_INSPECTION.md
+- docs/SQL_EXPLAIN.md
+- lib/generators/rails_console_pro/install_generator.rb
+- lib/generators/rails_console_pro/templates/rails_console_pro.rb
+- lib/rails_console_pro.rb
+- lib/rails_console_pro/active_record_extensions.rb
+- lib/rails_console_pro/association_navigator.rb
+- lib/rails_console_pro/base_printer.rb
+- lib/rails_console_pro/color_helper.rb
+- lib/rails_console_pro/commands.rb
+- lib/rails_console_pro/commands/base_command.rb
+- lib/rails_console_pro/commands/diff_command.rb
+- lib/rails_console_pro/commands/explain_command.rb
+- lib/rails_console_pro/commands/export_command.rb
+- lib/rails_console_pro/commands/schema_command.rb
+- lib/rails_console_pro/commands/stats_command.rb
+- lib/rails_console_pro/configuration.rb
+- lib/rails_console_pro/diff_result.rb
+- lib/rails_console_pro/error_handler.rb
+- lib/rails_console_pro/explain_result.rb
+- lib/rails_console_pro/format_exporter.rb
+- lib/rails_console_pro/global_methods.rb
+- lib/rails_console_pro/initializer.rb
+- lib/rails_console_pro/model_validator.rb
+- lib/rails_console_pro/paginator.rb
+- lib/rails_console_pro/printers/active_record_printer.rb
+- lib/rails_console_pro/printers/collection_printer.rb
+- lib/rails_console_pro/printers/diff_printer.rb
+- lib/rails_console_pro/printers/explain_printer.rb
+- lib/rails_console_pro/printers/relation_printer.rb
+- lib/rails_console_pro/printers/schema_printer.rb
+- lib/rails_console_pro/printers/stats_printer.rb
+- lib/rails_console_pro/pry_commands.rb
+- lib/rails_console_pro/pry_integration.rb
+- lib/rails_console_pro/railtie.rb
+- lib/rails_console_pro/schema_inspector_result.rb
+- lib/rails_console_pro/serializers/active_record_serializer.rb
+- lib/rails_console_pro/serializers/array_serializer.rb
+- lib/rails_console_pro/serializers/base_serializer.rb
+- lib/rails_console_pro/serializers/diff_serializer.rb
+- lib/rails_console_pro/serializers/explain_serializer.rb
+- lib/rails_console_pro/serializers/relation_serializer.rb
+- lib/rails_console_pro/serializers/schema_serializer.rb
+- lib/rails_console_pro/serializers/stats_serializer.rb
+- lib/rails_console_pro/services/column_stats_calculator.rb
+- lib/rails_console_pro/services/index_analyzer.rb
+- lib/rails_console_pro/services/stats_calculator.rb
+- lib/rails_console_pro/services/table_size_calculator.rb
+- lib/rails_console_pro/stats_result.rb
+- lib/rails_console_pro/version.rb
+- lib/tasks/rails_console_pro.rake
+- rails_console_pro.gemspec
+homepage: https://github.com/yourusername/rails_console_pro
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/yourusername/rails_console_pro
+  source_code_uri: https://github.com/yourusername/rails_console_pro
+  changelog_uri: https://github.com/yourusername/rails_console_pro/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Enhanced Rails console with schema inspection, SQL explain, association navigation,
+  and beautiful formatting
+test_files: []