cw_card_utils 0.1.0

data/lib/cw_card_utils/curve_calculator.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module CwCardUtils
+  class CurveCalculator
+    def initialize(deck)
+      @deck = deck
+      @deck_size = deck.size
+      @raw_curve = {}
+      @normalized_curve = {}
+    end
+
+    def curve
+      calculate_curve if @raw_curve.empty?
+      @raw_curve
+    end
+
+    def normalized_curve
+      normalize_curve if @normalized_curve.empty?
+      @normalized_curve
+    end
+
+    private
+
+    def calculate_curve
+      @deck.each do |card|
+        cmc = card.cmc
+        
+        # If CMC is nil, and it is a land, skip it, otherwise add it to the curve in the
+        # zero cost bucket. (Handles X to cast cards.)
+        if cmc.nil? || cmc == 0
+          if card.type.include?("Land")
+            next
+          else
+            bucket = 0
+          end
+        else
+          bucket = cmc.ceil
+        end
+
+        @raw_curve[bucket] ||= 0
+        @raw_curve[bucket] += card.count
+      end
+    end
+
+    def normalize_curve
+      @normalized_curve = curve.sort_by { |cmc, _| cmc }.to_h.transform_values do |count|
+        (count / @deck_size.to_f).round(4)
+      end
+    end
+  end
+end

data/lib/cw_card_utils/decklist_parser.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+module CwCardUtils
+  # Parses a decklist and returns a Deck object.
+  class DecklistParser
+    attr_reader :deck
+
+    def initialize(desklist, cmc_data_source = ScryfallCmcData.new)
+      @decklist = desklist.is_a?(IO) ? desklist.read : desklist
+      @deck = Deck.new(cmc_data_source)
+    end
+
+    def inspect
+      "<DecklistParser: #{@decklist.length}>"
+    end
+    
+
+    # Parses the decklist and returns a Deck object.
+    def parse
+      return @deck if @deck.any?
+
+      sideboard = false
+
+      @decklist.each_line do |line|
+        line = line.strip
+        next if line.empty?
+
+        sideboard = true if line.downcase.start_with?("sideboard") && (sideboard == false)
+
+        if line.match?(/^(Deck|Sideboard|About|Commander|Creatures|Lands|Spells|Artifacts|Enchantments|Planeswalkers|Mainboard|Maybeboard|Companion)/i)
+          next
+        end
+        next if line.start_with?("#") # skip comment-style lines
+        next if line.start_with?("//") # skip comment-style lines
+        next if line.start_with?("Name") # skip deck name
+
+        # Match patterns like: "4 Lightning Bolt", "2 Sol Ring (CMM) 452", "1 Atraxa, Praetors' Voice"
+        next unless match = line.match(/^(\d+)\s+(.+?)(?:\s+\(.*?\)\s+\d+)?$/)
+
+        count = match[1].to_i
+        name = match[2].strip
+        target = sideboard ? :sideboard : :mainboard
+        @deck.add({ count: count, name: name }, target)
+      end
+
+      @deck
+    end
+
+    # A Deck is a collection of cards.
+    class Deck
+      # A Card is a single card in a deck.
+      class Card
+        def initialize(name, count, cmc_data_source)
+          @name = name
+          @count = count
+          @cmc_data_source = cmc_data_source
+        end
+
+        attr_reader :name, :count
+
+        def cmc
+          @cmc ||= @cmc_data_source.cmc_for_card(@name)
+        end
+
+        def type
+          @type ||= @cmc_data_source.type_for_card(@name) || "Land"
+        end
+
+        def inspect
+          "<Card: #{@name} (#{@count}) #{cmc}>"
+        end
+
+        def to_h
+          { name: @name, count: @count, cmc: cmc, type: type }
+        end
+
+        def to_json
+          to_h.to_json
+        end
+      end
+
+      def initialize(cmc_data_source)
+        @main = []
+        @sideboard = []
+        @cmc_data_source = cmc_data_source
+      end
+
+      def to_h
+        {
+          mainboard: @main.map { |c| Card.new(c[:name], c[:count], @cmc_data_source).to_h },
+          sideboard: @sideboard.map { |c| Card.new(c[:name], c[:count], @cmc_data_source).to_h }
+        }
+      end
+
+      def to_json
+        to_h.to_json
+      end
+
+      def inspect
+        "<Deck: main: #{@main.size} sideboard: #{@sideboard.size}>"
+      end
+
+      def empty?
+        @main.empty? && @sideboard.empty?
+      end
+
+      def any?
+        !empty?
+      end
+
+      def each(&block)
+        @main.each do |c|
+          c = Card.new(c[:name], c[:count], @cmc_data_source)
+          block.call(c)
+        end
+      end
+
+      attr_reader :main, :sideboard
+
+      def add(card, target = :mainboard)
+        reset_counters
+        if target == :mainboard
+          @main << card
+        else
+          @sideboard << card
+        end
+      end
+
+      def reset_counters
+        @mainboard_size = nil
+        @sideboard_size = nil
+        @cards_count = nil
+      end
+
+      def mainboard_size
+        @mainboard_size ||= main.sum { |card| card[:count] }
+      end
+
+      def sideboard_size
+        @sideboard_size ||= sideboard.sum { |card| card[:count] }
+      end
+
+      def cards_count
+        @cards_count ||= mainboard_size + sideboard_size
+      end
+
+      def size
+        cards_count
+      end
+    end
+  end
+end

data/lib/cw_card_utils/scryfall_cmc_data.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "json"
+
+module CwCardUtils
+  # Handles conversion mana cost (CMC) data for Magic: The Gathering cards
+  class ScryfallCmcData
+    def initialize
+      @raw_data = File.read(File.expand_path("../../data/scryfall.cards.cmc.json", __dir__))
+      @data = JSON.parse(@raw_data)
+    end
+
+    def cmc_for_card(name)
+      @data.find { |card| card["name"] == name }["cmc"]
+    rescue StandardError
+      nil
+    end
+
+    def type_for_card(name)
+      @data.find { |card| card["name"] == name }["type_line"]
+    rescue StandardError
+      nil
+    end
+
+    def cmc_data
+      @data
+    end
+  end
+end

data/lib/cw_card_utils/version.rb

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

data/lib/cw_card_utils.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "cw_card_utils/version"
+require_relative "cw_card_utils/curve_calculator"
+require_relative "cw_card_utils/decklist_parser"
+require_relative "cw_card_utils/scryfall_cmc_data"
+
+module CwCardUtils
+  class Error < StandardError; end
+end

data/sig/cw_card_utils.rbs

@@ -0,0 +1,4 @@
+module CwCardUtils
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: cw_card_utils
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ryan Stenhouse
+bindir: exe
+cert_chain: []
+date: 2025-07-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- hello@ryanstenhouse.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- data/scryfall.cards.cmc.json
+- lib/cw_card_utils.rb
+- lib/cw_card_utils/curve_calculator.rb
+- lib/cw_card_utils/decklist_parser.rb
+- lib/cw_card_utils/scryfall_cmc_data.rb
+- lib/cw_card_utils/version.rb
+- sig/cw_card_utils.rbs
+homepage: https://cracklingwit.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://cracklingwit.com
+  source_code_uri: https://github.com/cracklingwit/card_utils
+  changelog_uri: https://github.com/cracklingwit/card_utils/commits/main/
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.4
+specification_version: 4
+summary: 'Crackling Wit Card Utils - For working with Magic: The Gathering cards.'
+test_files: []