cataract 0.1.3 → 0.1.4

data/scripts/fuzzer/worker.rb

@@ -1,99 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Fuzzer worker process - runs in subprocess and parses CSS inputs from stdin
-# Communicates via length-prefixed protocol
-
-require 'cataract'
-require 'cataract/color_conversion'
-
-# Configure aggressive GC to help identify memory leaks
-# Disable auto_compact - it can cause issues with C extensions holding pointers
-GC.auto_compact = false
-GC.config(
-  malloc_limit: 1_000_000,
-  malloc_limit_growth_factor: 1.1,   # Grow very slowly
-  oldmalloc_limit_growth_factor: 1.1 # Grow very slowly
-)
-
-# Enable GC.stress mode if requested (VERY slow, but makes GC bugs reproducible)
-if ENV['FUZZ_GC_STRESS'] == '1'
-  GC.stress = true
-  warn '[Worker] GC.stress enabled - expect 100-1000x slowdown'
-end
-
-COLOR_FORMATS = %i[hex rgb hsl hwb oklab oklch lab lch].freeze
-
-# Read length-prefixed inputs and parse them
-loop do
-  # Read 4-byte length prefix (network byte order)
-  len_bytes = $stdin.read(4)
-  break if len_bytes.nil? || len_bytes.bytesize != 4
-
-  length = len_bytes.unpack1('N')
-
-  # Read CSS input
-  css = $stdin.read(length)
-  break if css.nil? || css.bytesize != length
-
-  # Parse CSS (crash will kill subprocess)
-  begin
-    stylesheet = Cataract.parse_css(css)
-    rules = stylesheet.rules.to_a
-    merge_tested = false
-    to_s_tested = false
-    color_converted = false
-
-    # Test merge with valid CSS followed by fuzzed CSS
-    # This tests merge error handling when second rule set is invalid
-    begin
-      valid_stylesheet = Cataract.parse_css('body { margin: 0; color: red; }')
-      valid_stylesheet.add_block(css) # Add fuzzed CSS to valid stylesheet
-      valid_stylesheet.merge # Call merge on the stylesheet
-      merge_tested = true
-    rescue Cataract::Error
-      # Expected - merge might fail on invalid CSS
-    end
-
-    # Test to_s on parsed rules occasionally
-    # This tests serialization on fuzzed data
-    if !rules.empty? && rand < 0.01
-      stylesheet.to_s
-      to_s_tested = true
-    end
-
-    if !rules.empty? && rand < 0.02
-      stylesheet.to_formatted_s
-      to_s_tested = true
-    end
-
-    # Test color conversion occasionally (10% chance)
-    # This tests color parsing/conversion on fuzzed color values
-    if rand < 0.1
-      begin
-        # Try random color format conversions
-        from_format = COLOR_FORMATS.sample
-        to_format = COLOR_FORMATS.sample
-        stylesheet.convert_colors!(from: from_format, to: to_format)
-        color_converted = true
-      rescue Cataract::Error, ArgumentError
-        # Expected - color conversion might fail on invalid colors
-      end
-    end
-
-    # Report what was tested: PARSE [+MERGE] [+TOS] [+COLOR]
-    output = 'PARSE'
-    output += '+MERGE' if merge_tested
-    output += '+TOS' if to_s_tested
-    output += '+COLOR' if color_converted
-    $stdout.write("#{output}\n")
-  rescue Cataract::DepthError
-    $stdout.write("DEPTH\n")
-  rescue Cataract::SizeError
-    $stdout.write("SIZE\n")
-  rescue StandardError
-    $stdout.write("ERR\n")
-  end
-
-  $stdout.flush
-end

data/scripts/generate_benchmarks_md.rb

@@ -1,155 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'json'
-require 'erb'
-require 'fileutils'
-
-# Generate BENCHMARKS.md from benchmark JSON results
-class BenchmarkDocGenerator
-  RESULTS_DIR = File.expand_path('../benchmarks/.results', __dir__)
-  TEMPLATE_PATH = File.expand_path('../benchmarks/templates/benchmarks.md.erb', __dir__)
-  OUTPUT_PATH = File.expand_path('../BENCHMARKS.md', __dir__)
-
-  def initialize(results_dir: RESULTS_DIR, output_path: OUTPUT_PATH, verbose: true)
-    @results_dir = results_dir
-    @output_path = output_path
-    @verbose = verbose
-    @metadata = load_metadata
-    @parsing_data = load_benchmark_data('parsing')
-    @serialization_data = load_benchmark_data('serialization')
-    @specificity_data = load_benchmark_data('specificity')
-    @merging_data = load_benchmark_data('merging')
-    @yjit_data = load_benchmark_data('yjit')
-  end
-
-  def generate
-    # Check if we have any data to generate
-    if !@parsing_data && !@serialization_data &&
-       !@specificity_data && !@merging_data && !@yjit_data
-      # :nocov:
-      if @verbose
-        puts '⚠ Warning: No benchmark data found. Run benchmarks first: rake benchmark'
-        puts 'Available data files:'
-        Dir.glob(File.join(@results_dir, '*.json')).each do |file|
-          puts "  - #{File.basename(file)}"
-        end
-      end
-      # :nocov:
-      return
-    end
-
-    template = ERB.new(File.read(TEMPLATE_PATH), trim_mode: '-')
-    output = template.result(binding)
-
-    File.write(@output_path, output)
-
-    return unless @verbose
-
-    # :nocov:
-    puts '✓ Generated BENCHMARKS.md'
-    puts '  Included benchmarks:'
-    puts '    - Parsing' if @parsing_data
-    puts '    - Serialization' if @serialization_data
-    puts '    - Specificity' if @specificity_data
-    puts '    - Merging' if @merging_data
-    puts '    - YJIT' if @yjit_data
-
-    missing = []
-    missing << 'Parsing' unless @parsing_data
-    missing << 'Serialization' unless @serialization_data
-    missing << 'Specificity' unless @specificity_data
-    missing << 'Merging' unless @merging_data
-    missing << 'YJIT' unless @yjit_data
-
-    return unless missing.any?
-
-    puts '  Missing benchmarks:'
-    missing.each { |name| puts "    - #{name}" }
-    # :nocov:
-  end
-
-  private
-
-  def load_metadata
-    metadata_path = File.join(@results_dir, 'metadata.json')
-    if File.exist?(metadata_path)
-      JSON.parse(File.read(metadata_path))
-    else
-      # :nocov:
-      warn '⚠ Warning: metadata.json not found. Run benchmarks first.'
-      {}
-      # :nocov:
-    end
-  end
-
-  def load_benchmark_data(name)
-    path = File.join(@results_dir, "#{name}.json")
-    return nil unless File.exist?(path)
-
-    JSON.parse(File.read(path))
-  rescue JSON::ParserError => e
-    # :nocov:
-    warn "⚠ Warning: Failed to parse #{name}.json: #{e.message}"
-    nil
-    # :nocov:
-  end
-
-  # Formatting helpers for ERB template
-
-  def format_ips(result, short: false)
-    ips = result['central_tendency']
-
-    formatted = if ips >= 1_000_000
-                  "#{(ips / 1_000_000.0).round(2)}M"
-                elsif ips >= 1_000
-                  "#{(ips / 1_000.0).round(2)}K"
-                else
-                  ips.round(1).to_s
-                end
-
-    if short
-      "#{formatted} i/s"
-    else
-      time_per_op = format_time_per_op(result)
-      "#{formatted} i/s (#{time_per_op})"
-    end
-  end
-
-  def format_time_per_op(result)
-    ips = result['central_tendency']
-    time_us = 1_000_000.0 / ips
-
-    if time_us >= 1_000
-      "#{(time_us / 1_000).round(2)} ms"
-    else
-      "#{time_us.round(2)} μs"
-    end
-  end
-
-  def format_speedup(speedup)
-    "#{speedup.round(2)}x faster"
-  end
-
-  def format_number(num)
-    num.to_s.reverse.gsub(/(\d{3})(?=\d)/, '\\1,').reverse
-  end
-
-  # Access instance variables for ERB
-  attr_reader :metadata, :parsing_data, :serialization_data,
-              :specificity_data, :merging_data, :yjit_data
-end
-
-# Run if called directly
-# :nocov:
-if __FILE__ == $PROGRAM_NAME
-  unless Dir.exist?(BenchmarkDocGenerator::RESULTS_DIR)
-    puts "Error: No benchmark results found at #{BenchmarkDocGenerator::RESULTS_DIR}"
-    puts 'Run benchmarks first: rake benchmark'
-    exit 1
-  end
-
-  generator = BenchmarkDocGenerator.new
-  generator.generate
-end
-# :nocov: