plastic 0.2.1

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+*.gemspec
+*.log
+*.pid
+*.sqlite3
+*.tmproj
+.DS_Store
+log/*
+pkg/*

data/HISTORY.rdoc

@@ -0,0 +1,20 @@
+=== Version 0.2.1 2010-07-18
+
+Initial public release.
+
+
+=== Version 0.2.0
+
+Updated with additional validations and brand support.
+
+* PAN validations.
+* More robust expiration year / month accessors.
+* Support American Express PAN format with spaces.
+* Brand detection.
+
+
+=== Version 0.1.0
+
+Internal preview release of Plastic.
+
+* Basic gem + project framework.

data/LICENSE.txt

@@ -0,0 +1,7 @@
+Copyright © 2010 Square, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,21 @@
+= Plastic
+
+Credit card “plastic” library for Ruby. Parses track 1, track 2 and individual arguments. For ease of integration, Plastic duck-types an {ActiveMerchant}[http://www.activemerchant.org/] {CreditCard}[http://activemerchant.rubyforge.org/classes/ActiveMerchant/Billing/CreditCard.html] model.
+
+== Prerequisites
+
+* Money and a FICA score > 600.
+
+== Testing
+
+Testing requires the RSpec gem:
+
+* {Rspec}[http://rspec.info/]
+
+To test, run:
+  rake spec
+
+== License
+
+Copyright © 2010 Square, Inc.
+See LICENSE.txt in this directory.

data/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+require 'rake'
+require 'spec/rake/spectask'
+
+require File.join(File.dirname(__FILE__), 'lib', 'plastic', 'version')
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.version = Plastic::VERSION::STRING
+    gem.name = "plastic"
+    gem.summary = "Credit card library for Ruby."
+    gem.description = "Handle credit, debit, bank and other cards."
+    gem.email = "github@squareup.com"
+    gem.homepage = "http://github.com/square/plastic"
+    gem.authors = [
+      "Randy Reddig",
+      "Cameron Walters",
+      "Chris Kampmeier",
+      "Erica Kwan",
+      "Matthew O'Connor",
+      "Damon McCormick",
+      "Brian Jenkins",
+    ]
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ["--options", "spec/spec.opts"]
+  t.spec_files = FileList["spec/**/*_spec.rb"]
+  t.rcov = ENV["RCOV"]
+  t.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/}
+  t.verbose = true
+end
+
+task :spec => :check_dependencies
+task :default => :spec
+
+desc "Remove trailing whitespace"
+task :whitespace do
+  sh %{find . -name '*.rb' -exec sed -i '' 's/ *$//g' {} \\;}
+end

data/lib/plastic.rb

@@ -0,0 +1,5 @@
+require 'plastic/version'
+require 'plastic/core'
+require 'plastic/track'
+require 'plastic/validations'
+require 'plastic/duck_type'

data/lib/plastic/core.rb

@@ -0,0 +1,80 @@
+class Plastic
+  BRANDS = [:visa, :mastercard, :american_express, :discover]
+
+  attr_accessor :pan, :expiration
+  attr_accessor :track_name, :surname, :given_name, :title
+  attr_accessor :service_code, :cvv2
+  attr_accessor :track_1, :track_2
+
+  def initialize(attributes={})
+    if attributes.kind_of? Hash
+      self.update! attributes
+      parse_tracks!
+    else
+      parse_track! attributes
+    end
+  end
+
+  def update!(attributes={})
+    attributes.each do |key, value|
+      setter_method_name = :"#{key}="
+      send(setter_method_name, value) if respond_to?(setter_method_name)
+    end
+  end
+
+  def name
+    [title, given_name, surname].flatten.compact.join(" ").strip
+  end
+
+  def expiration=(yymm)
+    @expiration = yymm.to_s[0..3]
+  end
+
+  def expiration_year
+    DateTime.strptime(expiration_yy, "%y").year
+  end
+
+  def expiration_month
+    expiration_mm.to_i
+  end
+
+  def brand
+    case pan
+    when /^4/      then :visa
+    when /^5[1-5]/ then :mastercard
+    when /^677189/ then :mastercard
+    when /^6011/   then :discover
+    when /^65/     then :discover
+    when /^3[47]/  then :american_express
+    end
+  end
+
+  def valid?
+    value_is_present?(pan) && value_is_present?(expiration) && valid_pan? && valid_expiration?
+  end
+
+private
+
+  def expiration_yy
+    @expiration.to_s[0..1]
+  end
+
+  def expiration_mm
+    @expiration.to_s[2..3]
+  end
+
+  def value_is_present?(value)
+    !value_is_blank?(value)
+  end
+
+  def value_is_blank?(value)
+    if value.respond_to?(:blank?)
+      value.blank?
+    elsif value.respond_to?(:empty?)
+      value.empty?
+    else
+      value.nil?
+    end
+  end
+
+end

data/lib/plastic/duck_type.rb

@@ -0,0 +1,27 @@
+class Plastic
+  # ActiveMerchant::Billing::CreditCard
+  DUCK_TYPE_INTERFACE = [
+    [:number, :pan],
+    [:first_name, :given_name],
+    [:last_name, :surname],
+    [:verification_value, :cvv2],
+    [:security_code, :cvv2],
+    [:expiration_date, :expiration],
+    [:track1, :track_1],
+    [:track2, :track_2],
+  ]
+
+  DUCK_TYPE_INTERFACE.each do |_alias, attribute_name|
+    alias_method _alias, attribute_name
+    alias_method :"#{_alias}=", :"#{attribute_name}="
+    define_method :"#{_alias}?", lambda { value_is_present?(send(_alias)) }
+  end
+
+  def year
+    expiration ? DateTime.new(expiration_year).strftime("%y") : nil
+  end
+
+  def month
+    expiration ? "%02d" % expiration_month : nil
+  end
+end

data/lib/plastic/track.rb

@@ -0,0 +1,86 @@
+# http://en.wikipedia.org/wiki/Magnetic_stripe
+
+class Plastic
+  def parse_tracks!
+    parse_track_2!
+    parse_track_1!
+  end
+
+  def parse_track!(value)
+    parse_track_2! value
+    parse_track_1! value
+  end
+
+  # Track 1, Format B
+  #
+  # Start sentinel — one character (generally '%')
+  # Format code="B" — one character (alpha only)
+  # Primary account number (PAN) — up to 19 characters. Usually, but not always, matches the credit card number printed on the front of the card.
+  # Field Separator — one character (generally '^')
+  # Name — two to 26 characters
+  # Field Separator — one character (generally '^')
+  # Expiration date — four characters in the form YYMM.
+  # Service code — three characters
+  # Discretionary data — may include Pin Verification Key Indicator (PVKI, 1 character), PIN Verification Value (PVV, 4 characters), Card Verification Value or Card Verification Code (CVV or CVK, 3 characters)
+  # End sentinel — one character (generally '?')
+
+  TRACK_1_PARSER = /
+    \A                                      # Start of string
+    %?                                      # Start sentinel
+    [bB]                                    # Format code
+    (\d{12,19}|\d{4}\ \d{6}\ \d{5})         # PAN
+    \^                                      # Field separator
+    (                                       # Name field
+      (?=[^^]{2,26})                        # Lookahead assertion
+      ([^\/]+)                              # Surname
+      (?:\/?([^.]+)(?:\.?([^^]+))?)?        # Given name and title
+    )                                       #
+    \^                                      # Field separator
+    (\d{4})                                 # Expiration
+    (\d{3})                                 # Service code
+    ([^?]*)                                 # Discretionary data
+    \??                                     # End sentinel
+    \z                                      # End of string
+  /x.freeze
+
+  def self.track_1_parser
+    TRACK_1_PARSER
+  end
+
+  def parse_track_1!(value=nil)
+    value ||= track_1
+    if matched = self.class.track_1_parser.match(value.to_s)
+      self.pan = matched[1].delete(' ')
+      self.track_name = matched[2]
+      self.surname = matched[3]
+      self.given_name = matched[4]
+      self.title = matched[5]
+      self.expiration = matched[6]
+      self.service_code = matched[7]
+    end
+  end
+
+  # Track 2
+  #
+  # Start sentinel — one character (generally ';')
+  # Primary account number (PAN) — up to 19 characters. Usually, but not always, matches the credit card number printed on the front of the card.
+  # Separator — one char (generally '=')
+  # Expiration date — four characters in the form YYMM.
+  # Service code — three characters
+  # Discretionary data — as in track one
+  # End sentinel — one character (generally '?')
+
+  TRACK_2_PARSER = /\A;?(\d{12,19})\=(\d{4})(.{3})([^\?]*)\??\z/.freeze
+
+  def self.track_2_parser
+    TRACK_2_PARSER
+  end
+
+  def parse_track_2!(value=nil)
+    value ||= track_2
+    if matched = self.class.track_2_parser.match(value.to_s)
+      self.pan = matched[1]
+      self.expiration = matched[2]
+    end
+  end
+end

data/lib/plastic/validations.rb

@@ -0,0 +1,43 @@
+require 'date'
+
+class Plastic
+  def valid_pan?
+    valid_pan_length? && valid_pan_checksum?
+  end
+
+  def valid_expiration?
+    return false unless valid_expiration_year? && valid_expiration_month?
+    this = Time.now.utc
+    if this.year == expiration_year
+      (this.month..12).include?(expiration_month)
+    elsif expiration_year > this.year
+      true
+    else
+      false
+    end
+  end
+
+private
+
+  def valid_pan_length?
+    pan.to_s.length >= 12
+  end
+
+  def valid_pan_checksum?
+    odd = false
+    sum = pan.reverse.chars.inject(0) do |checksum, d|
+      d = d.to_i
+      checksum + ((odd = !odd) ? d : (d * 2 > 9 ? d * 2 - 9 : d * 2))
+    end
+    sum % 10 == 0
+  end
+
+  def valid_expiration_month?
+    (1..12).include?(expiration_month)
+  end
+
+  def valid_expiration_year?
+    this = Time.now.utc
+    (this.year..this.year + 20).include?(expiration_year)
+  end
+end

data/lib/plastic/version.rb

@@ -0,0 +1,9 @@
+class Plastic
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 2
+    TINY  = 1
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/spec/plastic/core_spec.rb

@@ -0,0 +1,221 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+class OtherHash < Hash
+end
+
+describe Plastic do
+  subject { described_class.new }
+
+  [
+    :pan, :expiration,
+    :track_name, :surname, :given_name, :title,
+    :service_code, :cvv2,
+    :track_1, :track_2,
+  ].each do |accessor|
+    it "has accessor :#{accessor} and :#{accessor}=" do
+      subject.should respond_to(:"#{accessor}")
+      subject.should respond_to(:"#{accessor}=")
+    end
+  end
+
+  describe "new" do
+    it "returns an instance of #{described_class.name}" do
+      subject.should be_instance_of(described_class)
+    end
+  end
+
+  describe "#initialize" do
+    context "with no arguments" do
+      it "calls update! with an empty hash" do
+        subject.should_receive(:update!).with({})
+        subject.send :initialize
+      end
+    end
+
+    context "with a nil argument" do
+      it "calls parse_track!" do
+        subject.should_receive(:parse_track!).with(nil)
+        subject.send :initialize, nil
+      end
+    end
+
+    context "with a hash argument" do
+      subject { described_class.new(:track_1 => "%B123456789012345^Dorsey/Jack.Dr^1010123?") }
+      
+      it "calls update! with the hash argument" do
+        arg = {:foo => "bar"}
+        subject.should_receive(:update!).with(arg)
+        subject.send :initialize, arg
+      end
+
+      it "parses the track data if given" do
+        subject.track_1.should == "%B123456789012345^Dorsey/Jack.Dr^1010123?"
+        subject.pan.should == "123456789012345"
+        subject.expiration.should == "1010"
+        subject.name.should == "Dr Jack Dorsey"
+      end
+    end
+
+    context "with a string argument" do
+      it "calls parse_track! with the string argument" do
+        arg = "foo=bar"
+        subject.should_receive(:parse_track!).with(arg)
+        subject.send :initialize, arg
+      end
+    end
+  end
+
+  describe "#update!" do
+    context "with no arguments" do
+      it "calls update! with an empty hash" do
+        subject.should_not_receive(:send)
+        subject.update!
+      end
+    end
+
+    context "with a nil argument" do
+      it "raises an exception" do
+        expect { subject.update! nil }.to raise_error(NoMethodError)
+      end
+    end
+
+    context "with a hash argument" do
+      it "assigns the passed keys" do
+        arg = {:pan => "bar"}
+        subject.update! arg
+        subject.pan.should == "bar"
+      end
+
+      it "ignores parameters that do not correspond to a setter" do
+        subject.should_not respond_to(:foo=)
+        expect { subject.update! :foo => 97 }.to_not raise_error
+      end
+    end
+
+    context "with a subclass of hash" do
+      before do
+        @other_hash = OtherHash.new
+        @other_hash[:pan] = "bar"
+        @other_hash.should be_kind_of(Hash)
+      end
+
+      it "assigns the passed keys" do
+        subject.update! @other_hash
+        subject.pan.should == "bar"
+      end
+    end
+  end
+
+  describe "#name" do
+    it "returns a string" do
+      subject.name.should be_instance_of(String)
+    end
+
+    [
+      ["Prince", nil, nil, "Prince"],
+      ["Walters", "Cameron", nil, "Cameron Walters"],
+      ["Howser", "Doogie", "Dr", "Dr Doogie Howser"],
+    ].each do |surname, given_name, title, name|
+      it "returns #{name} for the given input" do
+        subject.surname = surname
+        subject.given_name = given_name
+        subject.title = title
+        subject.name.should == name
+      end
+    end
+  end
+
+  describe "#expiration_year" do
+    it "returns a year 2000s when two digit expiration is in the range 00-68, inclusive" do
+      (0..68).each do |y|
+        yy = "%02d" % y
+        Plastic.new(:expiration => "#{yy}01").expiration_year.should == 2000 + y
+      end
+    end
+
+    it "returns a year in 1900s when when two digit expiration is in the range 69-99, inclusive" do
+      (69..99).each do |y|
+        yy = "%02d" % y
+        Plastic.new(:expiration => "#{yy}01").expiration_year.should == 1900 + y
+      end
+    end
+  end
+
+  describe "expiration_month" do
+    it "returns an integer month" do
+      subject.expiration = "9901"
+      subject.expiration_month.should == 1
+      subject.expiration = "9912"
+      subject.expiration_month.should == 12
+    end
+  end
+
+  describe "#brand" do
+    it "recognizes Visa cards" do
+      Plastic.new(:pan => "4111111111111111").brand.should == :visa
+    end
+
+    it "recognizes MasterCard cards" do
+      Plastic.new(:pan => "5100000000000000").brand.should == :mastercard
+      Plastic.new(:pan => "5200000000000000").brand.should == :mastercard
+      Plastic.new(:pan => "5300000000000000").brand.should == :mastercard
+      Plastic.new(:pan => "5400000000000000").brand.should == :mastercard
+      Plastic.new(:pan => "5500000000000000").brand.should == :mastercard
+      Plastic.new(:pan => "6771890000000000").brand.should == :mastercard # TODO: confirm that 6771- is really MasterCard
+    end
+
+    it "returns nil for bogus pseudo-MasterCard cards" do
+      Plastic.new(:pan => "5000000000000000").brand.should be_nil
+      Plastic.new(:pan => "5600000000000000").brand.should be_nil
+      Plastic.new(:pan => "5700000000000000").brand.should be_nil
+      Plastic.new(:pan => "5800000000000000").brand.should be_nil
+      Plastic.new(:pan => "5900000000000000").brand.should be_nil
+    end
+
+    it "recognizes Discover cards" do
+      Plastic.new(:pan => "6011000000000000").brand.should == :discover
+      Plastic.new(:pan => "6500000000000000").brand.should == :discover
+    end
+
+    it "recognizes American Express cards" do
+      Plastic.new(:pan => "340000000000000").brand.should == :american_express
+      Plastic.new(:pan => "370000000000000").brand.should == :american_express
+    end
+  end
+
+  describe "BRANDS constant" do
+    it "returns a list of the brands as symbols" do
+      Plastic::BRANDS.should == [:visa, :mastercard, :american_express, :discover]
+    end
+  end
+
+  describe "#valid?" do
+    before do
+      @plastic = Plastic.new(:pan => "5480020605154711", :expiration => "1501")
+    end
+
+    it "is valid if it has both a valid pan and an expiration" do
+      @plastic.should be_valid
+    end
+
+    it "is not valid if the pan is missing" do
+      @plastic.pan = nil
+      @plastic.should_not be_valid
+    end
+
+    it "is not valid if the expiration is missing" do
+      @plastic.expiration = nil
+      @plastic.should_not be_valid
+    end
+
+    it "is not valid if the card is expired" do
+      @plastic.expiration = "0901"
+      @plastic.should_not be_valid
+    end
+
+    it "is not valid if the pan does not pass its checksum" do
+      @plastic.pan = "4001111111111"
+      @plastic.should_not be_valid
+    end
+  end
+end

data/spec/plastic/duck_type_spec.rb

@@ -0,0 +1,62 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Plastic do
+  subject { described_class.new }
+
+  [
+    [:number, :pan],
+    [:first_name, :given_name],
+    [:last_name, :surname],
+    [:verification_value, :cvv2],
+    [:security_code, :cvv2],
+    [:expiration_date, :expiration],
+    [:track1, :track_1],
+    [:track2, :track_2],
+  ].each do |_alias, method|
+    it "##{method} is aliased as ##{_alias}" do
+      subject.method(_alias).should == subject.method(method)
+    end
+
+    it "##{method} is aliased as ##{_alias}" do
+      subject.method("#{_alias}=").should == subject.method("#{method}=")
+    end
+
+    it "##{method}? checks blankness of ##{_alias}" do
+      subject.send(:"#{_alias}?").should be_false
+    end
+  end
+
+  describe "when expiration is set" do
+    before do
+      subject.expiration = "1501"
+    end
+
+    describe "#year" do
+      it "returns the two digit year as a string" do
+        subject.expiration_year.should == 2015
+        subject.year.should == "15"
+      end
+    end
+
+    describe "#month" do
+      it "returns the two digit month as a string" do
+        subject.expiration_month.should == 1
+        subject.month.should == "01"
+      end
+    end
+  end
+
+  describe "when expiration is not set" do
+    describe "#year" do
+      it "returns nil" do
+        subject.year.should be_nil
+      end
+    end
+
+    describe "#month" do
+      it "returns nil" do
+        subject.month.should be_nil
+      end
+    end
+  end
+end

data/spec/plastic/track_spec.rb

@@ -0,0 +1,126 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Plastic do
+  subject { described_class.new }
+
+  describe "#parse_tracks!" do
+    it "calls #parse_track_2, then #parse_track_1" do
+      subject.should_receive(:parse_track_2!).with().once
+      subject.should_receive(:parse_track_1!).with().once.and_raise(StandardError)
+      expect { subject.parse_tracks! }.to raise_error(StandardError)
+    end
+  end
+
+  describe "#parse_track!" do
+    it "calls #parse_track_2, then #parse_track_1" do
+      arg = "foo"
+      subject.should_receive(:parse_track_2!).with(arg).once
+      subject.should_receive(:parse_track_1!).with(arg).once.and_raise(StandardError)
+      expect { subject.parse_track! arg }.to raise_error(StandardError)
+    end
+  end
+
+  describe "self.track_1_parser" do
+    it "returns a regular expression" do
+      described_class.track_1_parser.should be_instance_of(Regexp)
+    end
+  end
+
+  describe "#parse_track_1!" do
+    def mock_track_1_parser
+      subject
+      parser = mock()
+      described_class.should_receive(:track_1_parser).once.and_return(parser)
+      parser
+    end
+
+    it "with no arguments parses the contents of #track_1" do
+      arg = "foo"
+      subject.should_receive(:track_1).once.and_return(arg)
+      mock_track_1_parser.should_receive(:match).with(arg).once
+      subject.parse_track_1!
+    end
+
+    it "with nil parses the contents of #track_1" do
+      arg = "foo"
+      subject.should_receive(:track_1).once.and_return(arg)
+      mock_track_1_parser.should_receive(:match).with(arg).once
+      subject.parse_track_1! nil
+    end
+
+    [0, 1, "foo", "bar", StandardError].each do |value|
+      it "with #{value} attempts to parse the string representation" do
+        mock_track_1_parser.should_receive(:match).with(value.to_s).once
+        subject.parse_track_1! value
+      end
+    end
+  end
+
+  describe "self.track_2_parser" do
+    it "returns a regular expression" do
+      described_class.track_2_parser.should be_instance_of(Regexp)
+    end
+  end
+
+  describe "#parse_track_2!" do
+    def mock_track_2_parser
+      subject
+      parser = mock()
+      described_class.should_receive(:track_2_parser).once.and_return(parser)
+      parser
+    end
+
+    it "with no arguments parses the contents of #track_2" do
+      arg = "foo"
+      subject.should_receive(:track_2).once.and_return(arg)
+      mock_track_2_parser.should_receive(:match).with(arg).once
+      subject.parse_track_2!
+    end
+
+    it "with nil parses the contents of #track_2" do
+      arg = "foo"
+      subject.should_receive(:track_2).once.and_return(arg)
+      mock_track_2_parser.should_receive(:match).with(arg).once
+      subject.parse_track_2! nil
+    end
+
+    [0, 1, "foo", "bar", StandardError].each do |value|
+      it "with #{value} attempts to parse the string representation" do
+        mock_track_2_parser.should_receive(:match).with(value.to_s).once
+        subject.parse_track_2! value
+      end
+    end
+  end
+
+  [
+    # Track 1
+    ["", nil, nil, ""],
+    ["foobar", nil, nil, ""],
+    ["B1^N^1230", nil, nil, ""],
+    ["%B1^N^1230?", nil, nil, ""],
+    ["B12345678901234567890^CW^1010123", nil, nil, ""],
+    ["B123456789012^CW^0909123", "123456789012", "0909", "CW"],
+    ["B123456789012345^Dorsey/Jack^1010123", "123456789012345", "1010", "Jack Dorsey"],
+    ["%B123456789012345^Dorsey/Jack^1010123?", "123456789012345", "1010", "Jack Dorsey"],
+    ["B123456789012345^Dorsey/Jack.Dr^1010123", "123456789012345", "1010", "Dr Jack Dorsey"],
+    ["%B123456789012345^Dorsey/Jack.Dr^1010123?", "123456789012345", "1010", "Dr Jack Dorsey"],
+    ["%B1234 567890 12345^Dorsey/Jack.Dr^1010123?", "123456789012345", "1010", "Dr Jack Dorsey"],
+
+    # Track 2
+    ["", nil, nil, ""],
+    ["foobar", nil, nil, ""],
+    ["1=1230", nil, nil, ""],
+    ["?1=1230?", nil, nil, ""],
+    ["12345678901234567890=1010123", nil, nil, ""],
+    ["123456789012=0909123", "123456789012", "0909", ""],
+    ["123456789012345=1010123", "123456789012345", "1010", ""],
+    [";123456789012345=1010123?", "123456789012345", "1010", ""],
+  ].each do |value, pan, expiration, name|
+    it "#parse_track!(\"#{value}\") correctly parses the track data" do
+      subject.parse_track! value
+      subject.pan.should == pan
+      subject.expiration.should == expiration
+      subject.name.should == name
+    end
+  end
+end

data/spec/plastic/validations_spec.rb

@@ -0,0 +1,165 @@
+require 'spec_helper'
+
+describe Plastic, "validations" do
+  describe "#valid_pan?" do
+    subject { Plastic.new(:pan => "4111111111111111") }
+
+    it "is true when #valid_pan_length? and #valid_pan_checksum? are true" do
+      subject.should be_valid_pan
+    end
+
+    it "is false when #valid_pan_length? is false" do
+      subject.should_receive(:valid_pan_length?).and_return(false)
+      subject.should_not be_valid_pan
+    end
+
+    it "is false when #valid_pan_checksum? is false" do
+      subject.should_receive(:valid_pan_checksum?).and_return(false)
+      subject.should_not be_valid_pan
+    end
+  end
+
+  describe "#valid_expiration?" do
+    subject { Plastic.new(:expiration => "1312") }
+
+    describe "when expiration_year is next year" do
+      it "is true for all values of expiration_month" do
+        next_year = (DateTime.now.year + 1).to_s[-2..-1]
+        (1..12).each do |month|
+          subject.expiration = "%02d%02d" % [next_year, month]
+          subject.should be_valid_expiration
+        end
+      end
+    end
+
+    describe "when expiration_year is this year" do
+      before do
+        @this_year = DateTime.now.year.to_s[-2..-1]
+      end
+
+      it "is true when expiration_month is this month and after" do
+        (DateTime.now.month..12).each do |month|
+          subject.expiration = "%02d%02d" % [@this_year, month]
+          subject.should be_valid_expiration
+        end
+      end
+
+      it "is false when expiration_month is earlier than this month" do
+        this_year = DateTime.now.year.to_s[-2..-1]
+        (1...DateTime.now.month).each do |month|
+          subject.expiration = "%02d%02d" % [@this_year, month]
+          subject.should_not be_valid_expiration
+        end
+      end
+    end
+
+    it "is false when #valid_expiration_year? is false" do
+      subject.should_receive(:valid_expiration_year?).and_return(false)
+      subject.should_not be_valid_expiration
+    end
+
+    it "is false when #valid_expiration_month? is false" do
+      subject.should_receive(:valid_expiration_month?).and_return(false)
+      subject.should_not be_valid_expiration
+    end
+  end
+
+  describe "valid_pan_length?" do
+    it "is true when card number is 12 or more digits" do
+      extra_numbers = %w[11 234 5678 99999999].each do |n|
+        Plastic.new(:pan => "0123456789#{n}").should be_valid_pan_length
+      end
+    end
+
+    it "is false when card number is less than 12 digits" do
+      Plastic.new(:pan => "0123456789").should_not be_valid_pan_length
+      Plastic.new(:pan => "01234567890").should_not be_valid_pan_length
+    end
+  end
+
+  describe "valid_pan_checksum?" do
+    %w[
+      5454545454545454
+      5480020605154711
+      3566002020190001
+      4111111111111111
+      4005765777003
+      371449635398456
+      6011000995504101
+      36438999910011
+      4055011111111111
+      5581111111111119
+    ].each do |pan|
+      it "is true with valid test PAN #{pan}" do
+        Plastic.new(:pan => pan).should be_valid_pan_checksum
+      end
+    end
+
+    %w[
+      5451666666666666
+      5480000000000000
+      3566333333333333
+      4222222222222222
+      4001111111111
+      371433333333333
+      6011444444444444
+      36435555555555
+      4055999999999999
+      5581777777777777
+    ].each do |pan|
+      it "is false with invalid PAN #{pan}" do
+        Plastic.new(:pan => pan).should_not be_valid_pan_checksum
+      end
+    end
+  end
+
+  describe "#valid_expiration_month?" do
+    it "is true when the month is any of 1-12" do
+      (1..12).each do |month|
+        expiration = "YY%02d" % month
+        expiration.should match(/^YY[01]\d$/)
+        Plastic.new(:expiration => expiration).should be_valid_expiration_month
+      end
+    end
+
+    it "is false when the month is outside the range 1-12" do
+      [0, 17, 31].each do |month|
+        expiration = "YY%02d" % month
+        expiration.should match(/^YY\d\d$/)
+        Plastic.new(:expiration => expiration).should_not be_valid_expiration_month
+      end
+    end
+  end
+
+  describe "#valid_expiration_year?" do
+    def format_expiration_year_as_track(year)
+      two_digit_year = year.to_s[-2..-1].to_i % 99
+      expiration = "%02dMM" % two_digit_year
+      expiration.should match(/^\d\dMM$/)
+      expiration
+    end
+
+    before do
+      @this = DateTime.now
+    end
+
+    it "is true when set to the current year and up to 20 years later" do
+      (@this.year..@this.year + 20).each do |year|
+        expiration = format_expiration_year_as_track(year)
+        Plastic.new(:expiration => expiration).should be_valid_expiration_year
+      end
+    end
+
+    it "is false when set to last year" do
+      invalid_year = DateTime.now.year - 1
+      expiration = format_expiration_year_as_track(invalid_year)
+      Plastic.new(:expiration => expiration).should_not be_valid_expiration_year
+    end
+
+    it "is false when set 21 years in the future" do
+      invalid_year = DateTime.now.year + 21
+      expiration = format_expiration_year_as_track(invalid_year)
+      Plastic.new(:expiration => expiration).should_not be_valid_expiration_year
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,4 @@
+--colour
+--format progress
+--loadby mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))
+
+require 'plastic'
+require 'spec/expectations'

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification 
+name: plastic
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
+platform: ruby
+authors: 
+- Randy Reddig
+- Cameron Walters
+- Chris Kampmeier
+- Erica Kwan
+- Matthew O'Connor
+- Damon McCormick
+- Brian Jenkins
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-18 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Handle credit, debit, bank and other cards.
+email: github@squareup.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .gitignore
+- HISTORY.rdoc
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- lib/plastic.rb
+- lib/plastic/core.rb
+- lib/plastic/duck_type.rb
+- lib/plastic/track.rb
+- lib/plastic/validations.rb
+- lib/plastic/version.rb
+- spec/plastic/core_spec.rb
+- spec/plastic/duck_type_spec.rb
+- spec/plastic/track_spec.rb
+- spec/plastic/validations_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/square/plastic
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Credit card library for Ruby.
+test_files: 
+- spec/plastic/core_spec.rb
+- spec/plastic/duck_type_spec.rb
+- spec/plastic/track_spec.rb
+- spec/plastic/validations_spec.rb
+- spec/spec_helper.rb