spec_scout 0.1.0

data/lib/spec_scout/testprof_integration.rb

@@ -0,0 +1,206 @@
+# frozen_string_literal: true
+
+require 'test_prof'
+
+module SpecScout
+  # Handles TestProf integration, execution, and data extraction
+  class TestProfIntegration
+    class TestProfError < StandardError; end
+
+    def initialize(config = nil)
+      @config = config || ::SpecScout.configuration
+      @enabled = false
+    end
+
+    # Enable and execute TestProf profiling
+    def execute_profiling(_spec_location = nil)
+      return nil unless @config.use_test_prof
+
+      begin
+        enable_testprof_profilers
+        @enabled = true
+
+        # Extract profile data immediately after enabling
+        extract_profile_data
+      rescue StandardError => e
+        raise TestProfError, "Failed to enable TestProf: #{e.message}"
+      end
+    end
+
+    # Extract structured profile data from TestProf results
+    def extract_profile_data
+      return {} unless @enabled
+
+      begin
+        {
+          factory_prof: extract_factory_prof_data,
+          event_prof: extract_event_prof_data,
+          db_queries: extract_db_query_data
+        }
+      rescue StandardError => e
+        raise TestProfError, "Failed to extract TestProf data: #{e.message}"
+      end
+    end
+
+    # Check if TestProf is available and properly configured
+    def testprof_available?
+      defined?(TestProf) && TestProf.respond_to?(:config)
+    end
+
+    private
+
+    def enable_testprof_profilers
+      raise TestProfError, 'TestProf not available' unless testprof_available?
+
+      # Enable FactoryProf
+      TestProf::FactoryProf.init if defined?(TestProf::FactoryProf)
+
+      # Configure TestProf settings
+      configure_testprof_settings
+    end
+
+    def configure_testprof_settings
+      return unless defined?(TestProf)
+
+      # Set up basic TestProf configuration
+      TestProf.configure do |config|
+        config.output_dir = 'tmp/test_prof'
+        config.timestamps = true
+      end
+    end
+
+    def extract_factory_prof_data
+      return {} unless defined?(TestProf::FactoryProf)
+
+      # Extract FactoryProf results if available
+      if TestProf::FactoryProf.respond_to?(:stats)
+        stats = TestProf::FactoryProf.stats
+        return {} unless stats
+
+        {
+          total_count: stats.values.sum { |s| s[:total] || 0 },
+          total_time: stats.values.sum { |s| s[:time] || 0.0 },
+          stats: extract_factory_stats_from_hash(stats)
+        }
+      else
+        {}
+      end
+    rescue StandardError => e
+      # Log error but don't fail the entire extraction
+      { error: "FactoryProf extraction failed: #{e.message}" }
+    end
+
+    def extract_factory_stats_from_hash(stats)
+      return {} unless stats.is_a?(Hash)
+
+      result = {}
+      stats.each do |factory_name, factory_data|
+        result[factory_name.to_sym] = {
+          count: factory_data[:total] || factory_data[:count] || 0,
+          time: factory_data[:time] || 0.0,
+          strategy: detect_factory_strategy(factory_data)
+        }
+      end
+      result
+    rescue StandardError
+      {}
+    end
+
+    def detect_factory_strategy(factory_data)
+      # Try to detect if factory used create, build, or build_stubbed
+      # This is a simplified detection - real implementation would need
+      # more sophisticated analysis of TestProf data
+      if factory_data[:create_count]&.positive?
+        :create
+      elsif factory_data[:build_count]&.positive?
+        :build
+      else
+        :unknown
+      end
+    end
+
+    def extract_event_prof_data
+      return {} unless defined?(TestProf::EventProf)
+
+      # EventProf doesn't have a simple results API like FactoryProf
+      # Return empty data for now - this would need to be implemented
+      # based on how EventProf actually stores its results
+      {}
+    rescue StandardError => e
+      # Log error but don't fail the entire extraction
+      { error: "EventProf extraction failed: #{e.message}" }
+    end
+
+    def extract_event_stats(results)
+      return {} unless results.respond_to?(:each)
+
+      events = {}
+      results.each do |event_name, event_data|
+        events[event_name.to_sym] = {
+          count: event_data[:count] || 0,
+          time: event_data[:time] || 0.0,
+          examples: event_data[:examples] || []
+        }
+      end
+      events
+    rescue StandardError
+      {}
+    end
+
+    def extract_db_query_data
+      # Extract database query information
+      # This would typically come from EventProf sql.active_record events
+      # or other TestProf database profiling features
+
+      db_data = {
+        total_queries: 0,
+        inserts: 0,
+        selects: 0,
+        updates: 0,
+        deletes: 0
+      }
+
+      # Try to get SQL event data from EventProf
+      event_data = extract_event_prof_data
+      if event_data[:events] && event_data[:events][:'sql.active_record']
+        sql_events = event_data[:events][:'sql.active_record']
+        db_data[:total_queries] = sql_events[:count] || 0
+
+        # Parse examples to categorize query types
+        categorize_sql_queries(sql_events[:examples], db_data) if sql_events[:examples]
+      end
+
+      db_data
+    rescue StandardError => e
+      # Return default structure on error
+      {
+        total_queries: 0,
+        inserts: 0,
+        selects: 0,
+        updates: 0,
+        deletes: 0,
+        error: "DB query extraction failed: #{e.message}"
+      }
+    end
+
+    def categorize_sql_queries(examples, db_data)
+      examples.each do |example|
+        next unless example.is_a?(Hash) && example[:sql]
+
+        sql = example[:sql].to_s.upcase
+        case sql
+        when /^INSERT/
+          db_data[:inserts] += 1
+        when /^SELECT/
+          db_data[:selects] += 1
+        when /^UPDATE/
+          db_data[:updates] += 1
+        when /^DELETE/
+          db_data[:deletes] += 1
+        end
+      end
+    rescue StandardError
+      # Ignore categorization errors
+    end
+  end
+end

data/lib/spec_scout/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SpecScout
+  VERSION = '0.1.0'
+end

data/lib/spec_scout.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative 'spec_scout/version'
+require_relative 'spec_scout/profile_data'
+require_relative 'spec_scout/agent_result'
+require_relative 'spec_scout/recommendation'
+require_relative 'spec_scout/base_agent'
+require_relative 'spec_scout/configuration'
+require_relative 'spec_scout/safety_validator'
+require_relative 'spec_scout/enforcement_handler'
+require_relative 'spec_scout/testprof_integration'
+require_relative 'spec_scout/profile_normalizer'
+require_relative 'spec_scout/consensus_engine'
+require_relative 'spec_scout/output_formatter'
+
+# Agents
+require_relative 'spec_scout/agents/database_agent'
+require_relative 'spec_scout/agents/factory_agent'
+require_relative 'spec_scout/agents/intent_agent'
+require_relative 'spec_scout/agents/risk_agent'
+
+# Main orchestration class
+require_relative 'spec_scout/spec_scout'
+require_relative 'spec_scout/cli'
+
+# Main module for Spec Scout, a tool for analyzing and optimizing test suite database and factory usage.
+module SpecScout
+  class Error < StandardError; end
+
+  # Main entry point for Spec Scout functionality
+  def self.configure
+    yield(configuration) if block_given?
+    configuration
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.reset_configuration!
+    @configuration = nil
+  end
+end

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: spec_scout
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ajeet Kumar
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-12-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: test-prof
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: prop_check
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !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: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: Spec Scout transforms TestProf profiling data into actionable optimization
+  recommendations using specialized agents
+email:
+- akv1087@gmail.com
+executables:
+- spec_scout
+extensions: []
+extra_rdoc_files: []
+files:
+- ".idea/.gitignore"
+- ".idea/Projects.iml"
+- ".idea/copilot.data.migration.ask2agent.xml"
+- ".idea/modules.xml"
+- ".idea/vcs.xml"
+- ".rspec_status"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- examples/README.md
+- examples/best_practices.md
+- examples/configurations/basic_config.rb
+- examples/configurations/ci_config.rb
+- examples/configurations/conservative_config.rb
+- examples/configurations/development_config.rb
+- examples/configurations/performance_focused_config.rb
+- examples/output_formatter_demo.rb
+- examples/sample_outputs/console_output_high_confidence.txt
+- examples/sample_outputs/console_output_medium_confidence.txt
+- examples/sample_outputs/console_output_no_action.txt
+- examples/sample_outputs/console_output_risk_detected.txt
+- examples/sample_outputs/json_output_high_confidence.json
+- examples/sample_outputs/json_output_no_action.json
+- examples/workflows/basic_workflow.md
+- examples/workflows/ci_integration.md
+- exe/spec_scout
+- lib/spec_scout.rb
+- lib/spec_scout/agent_result.rb
+- lib/spec_scout/agents/database_agent.rb
+- lib/spec_scout/agents/factory_agent.rb
+- lib/spec_scout/agents/intent_agent.rb
+- lib/spec_scout/agents/risk_agent.rb
+- lib/spec_scout/base_agent.rb
+- lib/spec_scout/cli.rb
+- lib/spec_scout/configuration.rb
+- lib/spec_scout/consensus_engine.rb
+- lib/spec_scout/enforcement_handler.rb
+- lib/spec_scout/output_formatter.rb
+- lib/spec_scout/profile_data.rb
+- lib/spec_scout/profile_normalizer.rb
+- lib/spec_scout/recommendation.rb
+- lib/spec_scout/safety_validator.rb
+- lib/spec_scout/spec_scout.rb
+- lib/spec_scout/testprof_integration.rb
+- lib/spec_scout/version.rb
+homepage: https://github.com/ajeet-g2/spec-scout
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/ajeet-g2/spec-scout
+  source_code_uri: https://github.com/ajeet-g2/spec-scout
+  changelog_uri: https://github.com/ajeet-g2/spec-scout/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Intelligent test optimization advisor built on TestProf
+test_files: []