credit_officer 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format Fuubar

data/.rvmrc

@@ -0,0 +1 @@
+rvm gemset use credit_officer --create

data/Gemfile

@@ -0,0 +1,24 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+gem "activemodel", ">= 3.0.3"
+gem "luhney_bin"
+
+group :development do
+  gem "timecop", "0.3.5"
+  gem "ruby-debug"
+  gem "factory_girl"
+  gem "rspec", "~> 2.3.0"
+  gem "remarkable_activemodel", ">=4.0.0.alpha4"
+  gem "yard", "~> 0.6.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.1"
+  gem "rcov", ">= 0"
+  gem "reek", "~> 1.2.8"
+  gem "roodi", "~> 2.1.0"
+  gem "fuubar"
+end

data/Gemfile.lock

@@ -0,0 +1,79 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activesupport (3.0.3)
+    builder (2.1.2)
+    columnize (0.3.1)
+    diff-lcs (1.1.2)
+    factory_girl (1.3.2)
+    fuubar (0.0.3)
+      rspec (~> 2.0)
+      rspec-instafail (~> 0.1.4)
+      ruby-progressbar (~> 0.0.9)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    linecache (0.43)
+    luhney_bin (0.1.0)
+    rake (0.8.7)
+    rcov (0.9.9)
+    reek (1.2.8)
+      ruby2ruby (~> 1.2)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    remarkable (4.0.0.alpha4)
+      rspec (>= 2.0.0.alpha11)
+    remarkable_activemodel (4.0.0.alpha4)
+      remarkable (~> 4.0.0.alpha4)
+      rspec (>= 2.0.0.alpha11)
+    roodi (2.1.0)
+      ruby_parser
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-instafail (0.1.5)
+    rspec-mocks (2.3.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    ruby-progressbar (0.0.9)
+    ruby2ruby (1.2.5)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    ruby_parser (2.0.5)
+      sexp_processor (~> 3.0)
+    sexp_processor (3.0.5)
+    timecop (0.3.5)
+    yard (0.6.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activemodel (>= 3.0.3)
+  bundler (~> 1.0.0)
+  factory_girl
+  fuubar
+  jeweler (~> 1.5.1)
+  luhney_bin
+  rcov
+  reek (~> 1.2.8)
+  remarkable_activemodel (>= 4.0.0.alpha4)
+  roodi (~> 2.1.0)
+  rspec (~> 2.3.0)
+  ruby-debug
+  timecop (= 0.3.5)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Dan Pickett
+
+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,102 @@
+= credit_officer
+
+An ActiveModel port of ActiveMerchant's credit card validations. 
+
+Use only with Rails 3/ActiveModel supported applications
+
+== The Basics
+
+Use this library so that you can validate credit card information before sending it to your payment processor
+
+Checks credit card number formats, checksums, and other required details. Supports i18n for better message
+customization
+
+  cc = CreditOfficer::CreditCard.new(
+    :number => "411111111111111",
+    :provider_name => "visa",
+    :name_on_card => "John Doe",
+    :expiration_year => 2010,
+    :expiration_month => 1,
+    :verification_value => "343"
+  }).valid? => true
+  
+  cc.number = ""
+  cc.valid? => false 
+  cc.errors.full_messages => ["Number can't be blank"]
+
+== Configuring verification
+  
+If you want to turn requiring verification values off, make it so:
+
+  CreditOfficer::CreditCard.require_verification_value = false
+  cc = CreditOfficer::CreditCard.new(
+    :number => "411111111111111",
+    :provider_name => "visa",
+    :name_on_card => "John Doe",
+    :expiration_year => 2010,
+    :expiration_month => 1,
+    :verification_value => ""
+  }).valid? => true
+
+
+== Configuring Providers
+
+Want to only support certain credit cards and card number formats? Make it so:
+
+  CreditOfficer::CreditCard.supported_providers = [
+    'mastercard',
+    'amex'
+  ]
+
+  cc = CreditOfficer::CreditCard.new(
+    :number => "411111111111111",
+    :provider_name => "visa",
+    :name_on_card => "John Doe",
+    :expiration_year => 2010,
+    :expiration_month => 1,
+    :verification_value => ""
+  }).valid? => false
+
+== i18n
+
+Error messages can be customized with i18n translations
+
+  credit_officer:
+    errors:
+       messages:
+         expired: "is expired"
+         exceeds_recent_future: "is not a valid year"
+         invalid_format: "is not a valid card number"
+         unsupported_provider: "is not supported"
+         invalid_issue_number: "is not valid"
+         futuristic_start_date: "is in the future"
+
+== Why?
+
+ActiveMerchant has a ton of functionality and it's a great library. I just wanted the ability to validate
+information before sending it to a payment processor. I don't want all the payment processor logic, etc
+bloating my applications. Lean, simple, extensible, and up to date - that's how I like it!
+
+I've also added some of the niceties that an activemodel compliant architecture provides (i18n, for example)
+
+== A note on persistence
+
+Do not store this data yourself unless you absolutely must. Your payment processors should have a way for you
+to transmit this information and have them store it for you. Otherwise, you're beholden to all kinds of
+PCI compliance issues.
+
+== Contributing to credit_officer
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2010 Dan Pickett. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "credit_officer"
+  gem.homepage = "http://github.com/dpickett/credit_officer"
+  gem.license = "MIT"
+  gem.summary = %Q{An activemodel compliant credit card validator}
+  gem.description = %Q{An upgrade/port of ActiveMerchant's credit card class}
+  gem.email = "dpickett@enlightsolutions.com"
+  gem.authors = ["Dan Pickett"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+require 'reek/rake/task'
+Reek::Rake::Task.new do |t|
+  t.fail_on_error = true
+  t.verbose = false
+  t.source_files = 'lib/**/*.rb'
+end
+
+require 'roodi'
+require 'roodi_task'
+RoodiTask.new do |t|
+  t.verbose = false
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/credit_officer/base.rb

@@ -0,0 +1,34 @@
+require "active_model"
+
+module CreditOfficer
+  class Base
+    extend ActiveModel::Naming
+    include ActiveModel::Validations
+    extend ActiveModel::Translation
+    
+    def initialize(attributes = {})
+
+    end
+    
+    def to_model
+      self
+    end
+    
+    def persisted?
+      false
+    end
+    
+    def to_key
+      nil
+    end
+    
+    def to_param
+      nil
+    end
+    
+    protected
+    def translate(key, options = {})
+      I18n.t key, options
+    end
+  end
+end

data/lib/credit_officer/credit_card.rb

@@ -0,0 +1,235 @@
+require "active_support/core_ext/class/attribute_accessors"
+require "active_support/ordered_hash"
+require "luhney_bin"
+
+module CreditOfficer
+  #ActiveModel compliant class that represents credit card information
+  #Use this to populate and validate credit card details
+  #
+  #It is not recommended that you persist credit card information unless
+  #you absolutely must. Many payment processors proviider you with a mechanism to
+  #store this private information
+  #
+  #@example
+  #  cc = CreditOfficer::CreditCard.new(
+  #    :number => "411111111111111",
+  #    :provider_name => "visa",
+  #    :name_on_card => "John Doe",
+  #    :expiration_year => 2010,
+  #    :expiration_month => 1
+  #  }).valid? => true
+  #
+  #  cc.number = ""
+  #  cc.valid? => false 
+  #  cc.errors.full_messages => ["Number can't be blank"]
+  class CreditCard < Base
+    PROVIDERS_AND_FORMATS = [
+      ['visa'               , /^4\d{12}(\d{3})?$/],
+      ['master'             , /^(5[1-5]\d{4}|677189)\d{10}$/],
+      ['discover'           , /^(6011|65\d{2}|64[4-9]\d)\d{12}|(62\d{14})$/],
+      ['american_express'   , /^3[47]\d{13}$/],
+      ['diners_club'        , /^3(0[0-5]|[68]\d)\d{11}$/],
+      ['jcb'                , /^35(28|29|[3-8]\d)\d{12}$/],
+      ['switch'             , /^6759\d{12}(\d{2,3})?$/],
+      ['solo'               , /^6767\d{12}(\d{2,3})?$/],
+      ['dankort'            , /^5019\d{12}$/],
+      ['maestro'            , /^(5[06-8]|6\d)\d{10,17}$/],
+      ['forbrugsforeningen' , /^600722\d{10}$/],
+      ['laser'              , /^(6304|6706|6771|6709)\d{8}(\d{4}|\d{6,7})?$/]
+    ].inject(ActiveSupport::OrderedHash.new) do |ordered_hash, name_format_pair|
+      ordered_hash[name_format_pair[0]] = name_format_pair[1]
+      ordered_hash
+    end
+
+    SWITCH_OR_SOLO_PROVIDERS = [
+      'switch',
+      'solo'
+    ]
+    
+    #[String] the number found on card
+    attr_accessor :number
+
+    #[String] the name found on the front of the card
+    attr_accessor :name_on_card
+
+    #[Integer] the integer based representation of the month when the credit card expires (1-12 e.g)
+    attr_accessor :expiration_month
+
+    #[Integer] the year when the credit card expires
+    #@note paired with the month, this must be in the future for the credit card to be valid
+    attr_accessor :expiration_year
+
+    #[String] the CVV/CVV2 value found on the back or front of cards depending on their brand
+    #validation of this string can be turned off via class setting require_verification_value
+    attr_accessor :verification_value
+
+    #[String] downcased name of the credit card provider 
+    #(see {PROVIDERS_AND_FORMATS} for a valid list
+    attr_accessor :provider_name
+    
+    #[Integer] Solo or Switch card attribute representing the start date found on the card
+    attr_accessor :start_month
+
+    #[Integer] Solo or Switch card attribute representing the start year found on the card
+    attr_accessor :start_year
+
+    #[String] Solo or Switch Card attribute representing the issue number found on the card
+    attr_accessor :issue_number
+
+    alias_method :brand, :provider_name
+    
+    validates_presence_of :number
+    validates_presence_of :name_on_card
+    
+    validates_presence_of :verification_value, 
+      :if => proc{|p| p.class.verification_value_required? }
+    
+    validates_inclusion_of :expiration_month, 
+      :in => 1..12  
+
+    validates_presence_of :expiration_year
+    
+    validate :expiration_date_is_in_future
+    validate :expiration_date_is_in_recent_future
+    validate :number_is_valid
+    validate :provider_name_is_supported
+
+    #SOLO or Switch validations
+    validates_presence_of :start_month,
+      :if => proc{|cc| cc.switch_or_solo? }
+
+    validates_presence_of :start_year,
+      :if => proc{|cc| cc.switch_or_solo? }
+    
+    validate :issue_number_is_valid,
+      :if => proc{|cc| cc.switch_or_solo? }
+
+    validate :start_date_is_in_the_past,
+      :if => proc{|cc| cc.switch_or_solo? }
+
+    #set this flag accordingly to enable/disable validating verification codes (CVV/CVV2)
+    cattr_accessor :require_verification_value
+    self.require_verification_value = true
+ 
+    #checks the configuration setting require_verification_value to see if 
+    #verification is required
+    def self.verification_value_required?
+      require_verification_value
+    end
+    
+    #@return [CreditOfficer::MonthYearPair] month year pair that represents the expiration date
+    def expiration_date
+      CreditOfficer::MonthYearPair.new(:month => expiration_month, 
+        :year => expiration_year)
+    end
+
+    #@return [CreditOfficer::MonthYearPair] month year pair that represents the start date
+    #@note this applies to switch and solo cards only
+    def start_date
+      CreditOfficer::MonthYearPair.new(:month => start_month,
+        :year => start_year)
+    end
+    
+    #sets the provider name 
+    #@param [String] the provider name you wish to set
+    #sets the provider name to its downcased equivalent
+    #@example note the downcase
+    #  credit_card.provider_name = "VISA" => "visa"
+    def provider_name=(provider)
+      unless provider.nil?
+        @provider_name = provider.downcase
+      end
+    end
+    
+    #configure your list of supported providers
+    #@param Array<String> providers you wish to support (amex, visa, etc) (refer to {PROVIDERS_AND_FORMATS})
+    #@note matches specified providers against the supported whitelist {PROVIDERS_AND_FORMATS}
+    def self.supported_providers=(providers)
+      @supported_providers = providers.collect{|i| i.downcase} & PROVIDERS_AND_FORMATS.keys
+    end
+
+    #@return [Array<String>] list of providers
+    #@note defaults to {PROVIDERS_AND_FORMATS}.keys
+    def self.supported_providers
+      @supported_providers
+    end
+
+    self.supported_providers = PROVIDERS_AND_FORMATS.keys
+
+    #@return [Boolean] whether or not the provider name indicates the card is a switch or solo card
+    def switch_or_solo?
+      SWITCH_OR_SOLO_PROVIDERS.include?(provider_name)
+    end
+
+    protected
+    I18N_ERROR_SCOPE = [:credit_officer, :errors, :messages]
+
+    def expiration_date_is_in_future
+      if expiration_date.valid? && expiration_date.end_is_in_past?
+        errors.add(:expiration_year, 
+          translate(:expired, 
+            :scope   => I18N_ERROR_SCOPE, 
+            :default => "is expired"))
+      end
+    end
+    
+    def expiration_date_is_in_recent_future
+      if expiration_date.valid? && expiration_date.exceeds_recent_future?
+        errors.add(:expiration_year, translate(:exceeds_recent_future, 
+          :scope   => I18N_ERROR_SCOPE, 
+          :default => "is not a valid year"))
+      end
+    end
+    
+    def number_is_valid
+      if provider_name.present? && number.present? 
+        if self.class.supported_providers_and_formats[provider_name].nil? || 
+          !(number =~ self.class.supported_providers_and_formats[provider_name]) || 
+          !checksum_valid?
+
+          errors.add(:number, translate(:invalid_format, 
+            :scope   => I18N_ERROR_SCOPE, 
+            :default => "is not a valid card number"))
+        end
+      end
+    end
+
+    def provider_name_is_supported
+      unless self.class.supported_providers.include?(provider_name.downcase)
+        errors.add(:provider_name, translate(:unsupported_provider,
+          :scope   => I18N_ERROR_SCOPE,
+          :default => "is not supported"))
+      end
+    end
+
+    def issue_number_is_valid
+      unless issue_number =~ /^\d{1,2}$/
+        errors.add(:issue_number, translate(:invalid_issue_number,
+          :scope   => I18N_ERROR_SCOPE,
+          :default => "is not valid"))
+      end
+    end
+
+    def start_date_is_in_the_past
+      if start_date.valid? && start_date.start_is_in_future?
+        errors.add(:start_year, translate(:futuristic_start_date,
+          :scope => I18N_ERROR_SCOPE,
+          :default => "is in the future"))
+      end
+    end
+
+    def checksum_valid?
+      LuhneyBin.validate(number)
+    end
+
+    def self.supported_providers_and_formats
+      #match supported providers against constant's whitelist
+      valid_supported_providers = supported_providers & PROVIDERS_AND_FORMATS.keys
+
+      supported_providers.inject(ActiveSupport::OrderedHash.new) do |ordered_hash, provider_name|
+        ordered_hash[provider_name] = PROVIDERS_AND_FORMATS[provider_name]
+        ordered_hash
+      end
+    end
+  end
+end

data/lib/credit_officer/month_year_pair.rb

@@ -0,0 +1,62 @@
+require 'active_support/core_ext/time/calculations'
+
+module CreditOfficer
+  #ActiveModel compliant abstraction representing the month/year pairs often found on credit cards
+  #
+  #For most, the only one found on the front is an expiration date
+  #
+  #For switch and solo cards, an additional start date might be specified
+  class MonthYearPair < Base
+    #[Integer] the year (required for validity)
+    attr_accessor :year
+    
+    #[Integer] the numberic representation of the month (1-12) (required for validity)
+    attr_accessor :month
+
+    validates_inclusion_of :month,
+      :in => 1..12
+
+    validates_presence_of :year
+
+    #@param [Hash] hash of attributes to set
+    def initialize(attrs = {})
+      self.year = attrs[:year].to_i
+      self.month = attrs[:month].to_i
+    end
+    
+    #@return [Boolean] whether the last minute of the month is in the past
+    def end_is_in_past? #:nodoc:
+      Time.now.utc > end_of_month
+    end
+
+    #@return [Boolean] whether the first minute of the month is in the future
+    def start_is_in_future?
+      Time.now.utc < start_of_month
+    end
+    
+    RECENT_FUTURE_YEAR_LIMIT = 20
+
+    #@return [Boolean] whether the last minute of the month is within the bound of {RECENT_FUTURE_YEAR_LIMIT}
+    def exceeds_recent_future?
+      end_of_month <= Time.now.utc.advance(:years => RECENT_FUTURE_YEAR_LIMIT)
+    end
+
+    #@return [Time, nil] the first minute of the month in UTC or nil if an invalid pair was specified
+    def start_of_month 
+      begin
+        Time.utc(year, month, 1, 0, 0, 1)
+      rescue ArgumentError
+        nil
+      end
+    end
+
+    #@return [Time, nil] the last minute of the month in UTC or nil if an invalid pair was specified
+    def end_of_month 
+      begin
+        Time.utc(year, month, Time.days_in_month(month, year), 23, 59, 59)
+      rescue ArgumentError
+        nil
+      end
+    end
+  end
+end

data/lib/credit_officer.rb

@@ -0,0 +1,6 @@
+module CreditOfficer 
+end
+
+require "credit_officer/base"
+require "credit_officer/month_year_pair"
+require "credit_officer/credit_card"

data/spec/credit_officer/credit_card_spec.rb

@@ -0,0 +1,127 @@
+require 'spec_helper'
+
+describe CreditOfficer::CreditCard do
+  subject { Factory.build(:credit_card) }
+  it_should_behave_like "ActiveModel"
+  
+  should_validate_presence_of :number
+  should_validate_presence_of :name_on_card
+  should_validate_inclusion_of :expiration_month, :in => 1..12
+  should_validate_presence_of :expiration_year
+  
+  it "validates that the expiration year is on or after this year" do
+   subject.expiration_year = Time.now.year - 1 
+   subject.should_not be_valid
+   subject.errors[:expiration_year].should_not be_blank
+  end
+  
+  it "validates that the expiration year is within 20 years from now" do
+    subject.expiration_year = Time.now.utc.year + 20
+    subject.should_not be_valid
+    subject.errors[:expiration_year].should_not be_blank
+  end
+  
+  it "validates that the expiration month and year is in the future" do
+    Timecop.freeze(Time.utc(2010, 11, 1, 1)) do
+      subject.expiration_year = "2010"
+      subject.expiration_month = "10"
+      subject.should_not be_valid
+      subject.errors[:expiration_year].should_not be_blank
+    end
+  end
+  
+  it "validates the presence of a verification value if it's enabled" do
+    old_setting = CreditOfficer::CreditCard.require_verification_value
+    CreditOfficer::CreditCard.require_verification_value = true
+    subject.verification_value = ""
+    subject.should_not be_valid
+    subject.errors[:verification_value].should_not be_blank
+    
+    CreditOfficer::CreditCard.require_verification_value = old_setting
+  end
+  
+  it "does not validate the presence of a verification if it's not enabled" do
+    old_setting = subject.class.require_verification_value
+      subject.class.require_verification_value = false
+    subject.verification_value = ""
+    subject.should be_valid
+  end
+  
+  it "validates the credit card number based on its provider name's format" do
+    subject.provider_name = 'visa'
+    subject.number = '68293421'
+    subject.should_not be_valid
+    subject.errors[:number].should_not be_blank
+  end
+  
+  it "checks the checksum of the number" do
+    subject.number = "4123456789012345"
+    subject.should_not be_valid
+    subject.errors[:number].should_not be_blank
+  end
+
+  context "supported providers" do
+    it "validates that my provider is in the list of supported providers" do
+      old_supported_providers = subject.class.supported_providers.dup
+      subject.class.supported_providers = ['master']
+      subject.should_not be_valid
+      subject.errors[:provider_name].should_not be_blank
+
+      #reset supported providers
+      subject.class.supported_providers = old_supported_providers
+    end
+
+    it "rejects a provider that is not in the whitelist" do
+      old_supported_providers = subject.class.supported_providers
+      subject.class.supported_providers = ["gaga", "ohlala"]     
+      subject.class.supported_providers.should be_empty
+
+      #reset supported providers
+      subject.class.supported_providers = old_supported_providers
+    end
+
+    it "defaults to the large list of providers" do
+      subject.class.supported_providers.should eql(subject.class::PROVIDERS_AND_FORMATS.keys)
+    end
+  end
+
+  context "switch or solo cards" do
+    subject { Factory.build(:switch_credit_card) } 
+   
+    it { should be_valid }
+
+    it "is switch or solo if the provider name reflects that" do
+      [
+        "switch",
+        "solo"
+      ].each do |provider_name|
+        subject.provider_name = provider_name
+        subject.should be_switch_or_solo
+      end
+    end
+
+    it "requires a start month" do
+      subject.start_month = ""
+      subject.should_not be_valid
+      subject.errors[:start_month].should_not be_blank
+    end
+
+    it "requires a start year" do
+      subject.start_year = ""
+      subject.should_not be_valid
+      subject.errors[:start_year].should_not be_blank
+    end
+
+    it "requires a valid issue number" do
+      subject.issue_number = ""
+      subject.should_not be_valid
+      subject.errors[:issue_number].should_not be_blank
+    end
+
+    it "requires that the start month is not in the future" do
+      subject.start_year = Time.now.year + 1
+      subject.should_not be_valid
+      subject.errors[:start_year].should_not be_blank
+    end
+  end
+end

data/spec/credit_officer/month_year_pair_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+describe CreditOfficer::MonthYearPair do
+  should_validate_presence_of :year
+  should_validate_inclusion_of :month, :in => 1..12
+
+  subject { Factory.build(:month_year_pair) }
+
+  it "indicates when the end of the month is in the past" do
+    freeze_time do
+      subject.year = 2009   
+      subject.end_is_in_past?.should be_true
+    end
+  end
+
+  it "indicates when the end of hte month is not in the past" do
+    freeze_time do 
+      subject.year = 2011
+      subject.end_is_in_past?.should be_false
+    end
+  end
+
+  it "indicates when the start of the month is in the future" do
+    freeze_time do
+      subject.year = 2011
+      subject.start_is_in_future?.should be_true
+    end
+  end
+
+  it "indicates when the start of the month is not in the future" do
+    freeze_time do
+      subject.year = 2009
+      subject.start_is_in_future?.should be_false
+    end
+  end
+
+  it "has a nil start of month if the date doesn't make sense" do
+    subject.month = 49
+    subject.start_of_month.should be_nil
+  end
+
+  it "has a nil end of month if the date doesn't make sense" do
+    subject.month = 49
+    subject.end_of_month.should be_nil
+  end
+
+  def freeze_time(time = Time.utc(2010, 1, 1, 0, 0, 1), &block)
+    Timecop.freeze(time) do
+      yield
+    end
+  end
+end

data/spec/credit_officer_spec.rb

@@ -0,0 +1,5 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "CreditOfficer" do
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'credit_officer'
+require 'remarkable/active_model'
+require 'timecop'
+require 'factory_girl'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/spec/support/active_model_shared_examples.rb

@@ -0,0 +1,21 @@
+# activemodel compliance test courtesy of https://gist.github.com/665629
+
+# adapted from rspec-rails http://github.com/rspec/rspec-rails/blob/master/spec/rspec/rails/mocks/mock_model_spec.rb
+
+shared_examples_for "ActiveModel" do
+  require 'test/unit/assertions'
+  require 'active_model/lint'
+  include Test::Unit::Assertions
+  include ActiveModel::Lint::Tests
+
+  # to_s is to support ruby-1.9
+  ActiveModel::Lint::Tests.public_instance_methods.map{|m| m.to_s}.grep(/^test/).each do |m|
+    example m.gsub('_',' ') do
+      send m
+    end
+  end
+
+  def model
+    subject
+  end
+end

data/spec/support/factories.rb

@@ -0,0 +1,21 @@
+Factory.define :credit_card, :class => CreditOfficer::CreditCard do |c|
+  c.number "4111111111111111"
+  c.provider_name 'visa'
+  c.expiration_month 1
+  c.expiration_year { Time.now.advance(:year => 1) }
+  c.name_on_card "John Smith"
+  c.verification_value "1434"
+end
+
+Factory.define :switch_credit_card, :parent => :credit_card do |c|
+  c.number '675900000000000000'
+  c.provider_name 'switch'
+  c.start_month "01"
+  c.start_year "1990"
+  c.issue_number "01"
+end
+
+Factory.define :month_year_pair, :class => CreditOfficer::MonthYearPair do |c|
+  c.month 1
+  c.year 2010
+end

metadata

@@ -0,0 +1,307 @@
+--- !ruby/object:Gem::Specification 
+name: credit_officer
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Dan Pickett
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-22 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: activemodel
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 3
+        - 0
+        - 3
+        version: 3.0.3
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: luhney_bin
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: timecop
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 0
+        - 3
+        - 5
+        version: 0.3.5
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: ruby-debug
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: factory_girl
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id005
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rspec
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  requirement: *id006
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: remarkable_activemodel
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: -1710980466
+        segments: 
+        - 4
+        - 0
+        - 0
+        - alpha4
+        version: 4.0.0.alpha4
+  requirement: *id007
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: yard
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  requirement: *id008
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: bundler
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id009
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: jeweler
+  version_requirements: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 1
+        - 5
+        - 1
+        version: 1.5.1
+  requirement: *id010
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rcov
+  version_requirements: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id011
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: reek
+  version_requirements: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 2
+        - 8
+        version: 1.2.8
+  requirement: *id012
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: roodi
+  version_requirements: &id013 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 2
+        - 1
+        - 0
+        version: 2.1.0
+  requirement: *id013
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: fuubar
+  version_requirements: &id014 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id014
+description: An upgrade/port of ActiveMerchant's credit card class
+email: dpickett@enlightsolutions.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/credit_officer.rb
+- lib/credit_officer/base.rb
+- lib/credit_officer/credit_card.rb
+- lib/credit_officer/month_year_pair.rb
+- spec/credit_officer/base_spec.rb
+- spec/credit_officer/credit_card_spec.rb
+- spec/credit_officer/month_year_pair_spec.rb
+- spec/credit_officer_spec.rb
+- spec/spec_helper.rb
+- spec/support/active_model_shared_examples.rb
+- spec/support/factories.rb
+has_rdoc: true
+homepage: http://github.com/dpickett/credit_officer
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+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: An activemodel compliant credit card validator
+test_files: 
+- spec/credit_officer/base_spec.rb
+- spec/credit_officer/credit_card_spec.rb
+- spec/credit_officer/month_year_pair_spec.rb
+- spec/credit_officer_spec.rb
+- spec/spec_helper.rb
+- spec/support/active_model_shared_examples.rb
+- spec/support/factories.rb