crispr 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e22eb1dbacaba9bb6d1e3cb3397f53f1d38eb8c4fec6b8f9296faafb17f1bec
-  data.tar.gz: 650c04d67c82db6c211a98da8d8e0cfcd01d6b8c442f3425fd0bd34814dd8098
+  metadata.gz: 205d5b57e819c5c2e07a085ea24e98907d2f4b669036455840e03381a23e7e69
+  data.tar.gz: 23151bd8e26ad94e8e2cf2b914e62aace2e9e851b9b418b54a18341981db7fec
 SHA512:
-  metadata.gz: 88583c8997c5c85c7d57fe26c779cd6f7fb86fd96c1559cf97174539f8d0c15d1baa58134752ad3f26d469bfc1cb2d7390dbfb1bd46876e95d6709b286db5fc7
-  data.tar.gz: df10e617deb154c9568707a4d2649213d3a82ff0244b26c1d61e7409843155e4c668f8462209dcfffc719f6c7c80187713f789d0dce0cc97e41aabe1ea5b7c03
+  metadata.gz: 2c48c9bbe4748591fc70b8b9c455f91b3c90bffc912843534dbe47ea7359f77fad1a19af270681e47659d5d485f168fb42236bfa78b71e82f9f4393a722b6cc3
+  data.tar.gz: e541dc13fc8fe3da01a1fc550960ba3c922cc65af0c6b8f59d9afa356c1e182bc5e28e8af5537d1ada229064ba9c5a4941217afaade3f8f0766a38ea5de1c872

data/.rubocop.yml

@@ -6,15 +6,27 @@ AllCops:
   NewCops: enable
   TargetRubyVersion: 3.1
 
+Layout/LineLength:
+  Enabled: false
+
 Metrics/AbcSize:
-  Max: 30
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
 
 Metrics/MethodLength:
   Max: 100
 
+Metrics/PerceivedComplexity:
+  Enabled: false
+
 RSpec/ExampleLength:
   Max: 20
 
+RSpec/MultipleExpectations:
+  Enabled: false
+
 Style/StringLiterals:
   EnforcedStyle: double_quotes
 

data/lib/crispr/cli.rb

@@ -2,6 +2,7 @@
 
 require "crispr/mutator"
 require "crispr/runner"
+require "crispr/reporter"
 
 module Crispr
   # Provides the command-line interface for the Crispr gem.
@@ -11,26 +12,40 @@ module Crispr
       command = argv.shift
       case command
       when "run"
-        path = argv.shift
-        unless path && File.exist?(path)
-          puts "Error: Please specify a valid Ruby file to mutate."
+        input_path = argv.shift
+        unless input_path && File.exist?(input_path)
+          puts "Error: Please specify a valid Ruby file or directory to mutate."
           exit 1
         end
 
-        source = File.read(path)
-        mutator = Crispr::Mutator.new(source)
-        mutations = mutator.mutations
+        paths = File.directory?(input_path) ? Dir.glob("#{input_path}/**/*.rb") : [input_path]
 
-        if mutations.empty?
-          puts "No mutations found."
-          exit 0
-        end
+        reporter = Crispr::Reporter.new
+
+        paths.each do |path|
+          source = File.read(path)
+          mutator = Crispr::Mutator.new(source)
+          mutations = mutator.mutations
 
-        mutations.each_with_index do |mutated, index|
-          puts "Running mutation #{index + 1}/#{mutations.size}..."
-          killed = Crispr::Runner.run_mutation(path: path, mutated_source: mutated)
-          puts killed ? "💥 Mutation killed" : "⚠️ Mutation survived"
+          if mutations.empty?
+            puts "No mutations found in #{path}."
+            next
+          end
+
+          mutations.each_with_index do |mutated, index|
+            puts "Running mutation #{index + 1}/#{mutations.size} on #{path}..."
+            killed = Crispr::Runner.run_mutation(path: path, mutated_source: mutated)
+            reporter.record(killed: killed)
+            puts killed ? "💥 Mutation killed" : "⚠️ Mutation survived"
+          end
         end
+
+        summary = reporter.summary
+        puts
+        puts "Mutations: #{summary[:mutations]}"
+        puts "💥 Killed: #{summary[:killed]}"
+        puts "⚠️ Survived: #{summary[:survived]}"
+        puts "Score: #{summary[:score]}%"
       else
         puts "Usage: crispr run path/to/file.rb"
         exit 1

data/lib/crispr/mutations/base.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Crispr
+  module Mutations
+    # Abstract base class for all mutation strategies.
+    # Subclasses must implement the `#mutations_for` method.
+    class Base
+      # Returns an array of mutated AST nodes for a given node.
+      #
+      # @param node [Parser::AST::Node] the node to mutate
+      # @return [Array<Parser::AST::Node>] mutations
+      def mutations_for(node)
+        raise NotImplementedError, "#{self.class} must implement #mutations_for"
+      end
+    end
+  end
+end

data/lib/crispr/mutations/{boolean_mutations.rb → boolean.rb}

@@ -1,16 +1,18 @@
 # rubocop:disable Lint/BooleanSymbol
 # frozen_string_literal: true
 
+require_relative "base"
+
 module Crispr
   module Mutations
     # Provides boolean-specific AST mutations.
     # Currently supports toggling `true` to `false` and `false` to `true`.
-    module BooleanMutations
+    class Boolean < Base
       # Returns a list of stringified mutated forms for the given boolean AST node.
       #
       # @param node [Parser::AST::Node] the AST node to inspect
       # @return [Array<String>] mutated Ruby source code strings
-      def self.mutations_for(node)
+      def mutations_for(node)
         return [] unless node.is_a?(Parser::AST::Node)
 
         case node.type

data/lib/crispr/mutations/numeric.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Crispr
+  module Mutations
+    # The Numeric class defines mutations for integer literals.
+    # It generates alternative integer nodes by applying small transformations,
+    # such as incrementing, decrementing, zeroing, or negating the value.
+    class Numeric < Base
+      # Applies numeric mutations to the given AST node.
+      #
+      # @param node [Parser::AST::Node] the node to mutate
+      # @return [Array<Parser::AST::Node>] an array of mutated nodes
+      def mutations_for(node)
+        return [] unless node.type == :int
+
+        value = node.children[0]
+
+        # Generate a set of numeric mutations
+        mutations = []
+        mutations << replace(node, value + 1)
+        mutations << replace(node, value - 1)
+        mutations << replace(node, 0) unless value.zero?
+        mutations << replace(node, -value) unless value.zero?
+
+        mutations
+      end
+
+      private
+
+      # Creates a new AST node with the given integer value.
+      #
+      # @param node [Parser::AST::Node] the original node
+      # @param new_value [Integer] the new integer value
+      # @return [Parser::AST::Node] the mutated node
+      def replace(node, new_value)
+        Parser::AST::Node.new(:int, [new_value], location: node.location)
+      end
+    end
+  end
+end

data/lib/crispr/mutator.rb

@@ -2,12 +2,18 @@
 
 require "parser/current"
 require "unparser"
-require_relative "mutations/boolean_mutations"
+require_relative "mutations/boolean"
+require_relative "mutations/numeric"
 
 module Crispr
   # Mutator performs simple AST mutations on Ruby source code.
-  # Currently, it supports changing `true` literals to `false` and vice versa.
+  # It delegates to multiple mutation strategies (Boolean, Numeric, etc.)
   class Mutator
+    MUTATORS = [
+      Crispr::Mutations::Boolean.new,
+      Crispr::Mutations::Numeric.new
+    ].freeze
+
     def initialize(source_code)
       @source_code = source_code
     end
@@ -24,8 +30,11 @@ module Crispr
     def find_mutations(node)
       return [] unless node.is_a?(Parser::AST::Node)
 
-      local_mutations = Crispr::Mutations::BooleanMutations.mutations_for(node)
-      child_mutations = node.children.flat_map { |child| find_mutations(child) }
+      local_mutations =
+        MUTATORS.flat_map { |mutator| mutator.mutations_for(node) }
+
+      child_mutations =
+        node.children.flat_map { |child| find_mutations(child) }
 
       local_mutations + child_mutations
     end

data/lib/crispr/reporter.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Crispr
+  # Reporter collects mutation testing results and prints a summary.
+  class Reporter
+    # Initializes a new Reporter.
+    def initialize
+      @killed = 0
+      @survived = 0
+    end
+
+    # Records the result of a mutation test.
+    #
+    # @param killed [Boolean] whether the mutation was killed
+    # @return [void]
+    def record(killed:)
+      killed ? @killed += 1 : @survived += 1
+    end
+
+    # Returns the mutation score as a percentage.
+    #
+    # @return [Float] the mutation score
+    def score
+      total = @killed + @survived
+      total.zero? ? 0.0 : (@killed.to_f / total * 100).round(2)
+    end
+
+    # Returns a summary of mutation results.
+    #
+    # @return [Hash] summary statistics including totals and score
+    def summary
+      total = @killed + @survived
+      {
+        mutations: total,
+        killed: @killed,
+        survived: @survived,
+        score: score
+      }
+    end
+  end
+end

data/lib/crispr/runner.rb

@@ -11,14 +11,16 @@ module Crispr
     #
     # @param path [String] the path to the source file to mutate
     # @param mutated_source [String] the mutated version of the file's source code
+    # @param test_path [String, nil] optional path to a specific test file to run
     # @return [Boolean] true if the mutation was killed (test suite failed), false otherwise
-    def self.run_mutation(path:, mutated_source:)
+    def self.run_mutation(path:, mutated_source:, test_path: nil)
       original_source = File.read(path)
 
       begin
         File.write(path, mutated_source)
 
-        stdout, stderr, status = Open3.capture3("bundle exec rspec")
+        test_cmd = test_path ? "bundle exec rspec #{test_path}" : "bundle exec rspec"
+        stdout, stderr, status = Open3.capture3(test_cmd)
         killed = !status.success?
 
         puts stdout unless status.success?

data/lib/crispr/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Crispr
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/crispr.rb

@@ -5,6 +5,10 @@ require_relative "crispr/mutator"
 require_relative "crispr/runner"
 require_relative "crispr/cli"
 
+require_relative "crispr/mutations/base"
+require_relative "crispr/mutations/boolean"
+require_relative "crispr/mutations/numeric"
+
 module Crispr
   class Error < StandardError; end
   # Your code goes here...

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: crispr
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Aaron F Stanton
@@ -54,8 +54,11 @@ files:
 - bin/crispr
 - lib/crispr.rb
 - lib/crispr/cli.rb
-- lib/crispr/mutations/boolean_mutations.rb
+- lib/crispr/mutations/base.rb
+- lib/crispr/mutations/boolean.rb
+- lib/crispr/mutations/numeric.rb
 - lib/crispr/mutator.rb
+- lib/crispr/reporter.rb
 - lib/crispr/runner.rb
 - lib/crispr/version.rb
 - sig/crispr.rbs