credit_card_validations 1.0.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in credit_card_validations.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Igor Fedoronchuk
+
+MIT License
+
+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.md

@@ -0,0 +1,75 @@
+# CreditCardValidations
+
+Gem adds validator  to check whether or not a given number actually falls within the ranges of possible numbers prior to performing such verification, and, as such, CreditCardValidations simply verifies that the credit card number provided is well-formed.
+This is a port of Zend Framework `Zend\Validator\CreditCard` .
+
+The following issuing institutes are accepted:
+
+
+    American Express
+    China UnionPay
+    Diners Club
+    Dinner Club US
+    Discover
+    JCB
+    Maestro
+    MasterCard
+    Solo
+    Visa
+
+
+
+Also You can add your own rules to detect other credit card brands/types
+passing name,length(integer/array of integers) and prefix(string/array of strings)
+Example
+
+    CreditCardValidations::Detector.add_rule(:voyager, 15, '86')
+  	voyager_test_card_number = '869926275400212'
+    CreditCardValidations::Detector.new(voyager_test_card_number).brand #:voyager
+    CreditCardValidations::Detector.new(voyager_test_card_number).voyager? #true
+ 
+
+
+AvtiveModel support
+	
+only for certain brads	
+	
+	class CreditCardModel
+  		attr_accessor :number
+  		include ActiveModel::Validations
+  		validates :number, presence: true, credit_card_number: {brands: [:amex, :maestro]}
+	end
+	
+for all known brands
+	
+	validates :number, presence: true, credit_card_number: true
+
+  
+
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'credit_card_validations'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install credit_card_validations
+
+## Usage
+
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler/gem_tasks'
+
+require 'rake'
+require 'rake/testtask'
+
+task :default => [:test_units]
+
+desc "Run basic tests"
+Rake::TestTask.new("test_units") { |t|
+  t.pattern = 'test/*_test.rb'
+  t.verbose = true
+  t.warning = true
+}

data/credit_card_validations.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'credit_card_validations/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "credit_card_validations"
+  gem.version       = CreditCardValidations::VERSION
+  gem.authors       = ["Igor"]
+  gem.email         = ["fedoronchuk@gmail.com"]
+  gem.description   = %q{A ruby gem for validating credit card numbers (a port of ZF2 Zend\Validator\CreditCard) —}
+  gem.summary       = "gem for credit card numbers validation, card brands detections"
+  gem.homepage      = "https://github.com/Fivell/credit_card_validations"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency('activemodel', '~> 3.0')
+  gem.add_dependency('activesupport', '~> 3.0')
+end

data/lib/credit_card_number_validator.rb

@@ -0,0 +1,11 @@
+class CreditCardNumberValidator < ActiveModel::EachValidator
+
+  def validate_each(record, attribute, value)
+    brands = options.fetch(:brands)
+    record.errors[attribute] << (options[:message] || "is not valid") unless credit_card_valid?(value, Array.wrap(brands))
+  end
+
+  def credit_card_valid?(number, brands = [])
+    CreditCardValidations::Detector.new(number).valid?(*brands)
+  end
+end

data/lib/credit_card_validations.rb

@@ -0,0 +1,13 @@
+require 'credit_card_validations/version'
+require 'active_model'
+require 'active_support/all'
+require 'active_model/validations'
+require 'credit_card_number_validator'
+
+module CreditCardValidations
+   extend ActiveSupport::Autoload
+   autoload :VERSION, 'credit_card_validations/version'
+   autoload :Luhn, 'credit_card_validations/luhn'
+   autoload :CardRules , 'credit_card_validations/card_rules'
+   autoload :Detector , 'credit_card_validations/detector'
+end  

data/lib/credit_card_validations/card_rules.rb

@@ -0,0 +1,58 @@
+module CreditCardValidations
+  module CardRules
+    ########  most used brands #########
+
+
+    VISA = [
+        {length: [16], prefixes: ['4']}
+    ]
+    MASTERCARD = [
+        {length: [16], prefixes: ['51', '52', '53', '54', '55']}
+    ]
+    ######## other brands ########
+    AMEX = [
+        {length: [15], prefixes: ['34', '37']}
+    ]
+
+    DINERS = [
+        {length: [14], prefixes: ['300', '301', '302', '303', '304', '305', '36']},
+    ]
+
+    #There are Diners Club (North America) cards that begin with 5. These are a joint venture between Diners Club and MasterCard, and are processed like a MasterCard
+    DINERS_US = [
+        {length: [16], prefixes: ['54', '55']}
+    ]
+
+    DISCOVER = [
+        {length: [16], prefixes: ['6011', '622126', '622127', '622128', '622129', '62213',
+                                '62214', '62215', '62216', '62217', '62218', '62219',
+                                '6222', '6223', '6224', '6225', '6226', '6227', '6228',
+                                '62290', '62291', '622920', '622921', '622922', '622923',
+                                '622924', '622925', '644', '645', '646', '647', '648',
+                                '649', '65']}
+    ]
+
+    JCB = [
+        {length: [16], prefixes: ['3528', '3529', '353', '354', '355', '356', '357', '358']}
+    ]
+
+
+    LASER = [
+        {length: [16, 17, 18, 19], prefixes: ['6304', '6706', '6771', '6709']}
+    ]
+
+    MAESTRO = [
+        {length: [12, 13, 14, 15, 16, 17, 18, 19], prefixes: ['5018', '5020', '5038', '6304', '6759', '6761', '6763']}
+    ]
+
+    SOLO = [
+        {length: [16, 18, 19], prefixes: ['6334', '6767']}
+    ]
+
+    UNIONPAY = [
+        {length: [16, 17, 18, 19], prefixes: ['620', '621', '623', '625', '626']}
+    ]
+
+
+  end
+end

data/lib/credit_card_validations/detector.rb

@@ -0,0 +1,72 @@
+module CreditCardValidations
+  class Detector
+    class_attribute :rules
+    self.rules = {}
+
+    attr_reader :number
+
+    def initialize(number)
+      @number = number.to_s.delete(' ')
+    end
+
+    # credit card number
+    def valid?(*brands)
+       !!valid_number?(*brands)
+    end
+
+    #brand name
+    def brand
+       valid_number?
+    end
+
+    def valid_number?(*brands)
+      return nil unless valid_luhn?
+      number_length = number.length
+      brand_rules = brands.blank? ? self.rules : self.rules.slice(*brands.map{|el| el.downcase  })
+      unless brand_rules.blank?
+        brand_rules.each do |brand_name, rules|
+          rules.each do |rule|
+            return brand_name if (rule[:length].include?(number_length) and number.match(rule[:regexp]))
+          end
+        end
+      end
+      nil
+    end
+
+    #check if luhn valid
+    def valid_luhn?
+      Luhn.valid?(number)
+    end
+
+    class << self
+
+      #create regexp by array of prefixes
+      def compile_regexp(prefixes)
+          Regexp.new("^((#{prefixes.join(")|(")}))")
+      end
+
+      #create rule for detecting brand
+      def add_rule(brand, length, prefixes)
+        prefixes = Array.wrap(prefixes)
+        length = Array.wrap(length)
+        rules[brand] = [] if rules[brand].blank?
+        rules[brand] << {length: length,  regexp: compile_regexp(prefixes), prefixes: prefixes}
+        #create methods like  visa? mastercard? etc
+        class_eval <<-BOOLEAN_RULE, __FILE__, __LINE__
+          def #{brand}?
+             valid?(:#{brand})
+          end
+        BOOLEAN_RULE
+      end
+    end
+
+    CardRules.constants.each do |const_name|
+      CardRules.const_get(const_name).each do |const_value|
+        self.add_rule(const_name.to_s.downcase.to_sym , const_value[:length], const_value[:prefixes])
+      end
+
+    end
+  end
+
+
+end

data/lib/credit_card_validations/luhn.rb

@@ -0,0 +1,17 @@
+module CreditCardValidations
+  class Luhn
+    def self.valid?(number)
+      s1 = s2 = 0
+      number.to_s.reverse.chars.each_slice(2) do |odd, even|
+        s1 += odd.to_i
+
+        double = even.to_i * 2
+        double -= 9 if double >= 10
+        s2 += double
+      end
+      (s1 + s2) % 10 == 0
+    end
+  end
+end  
+  
+  

data/lib/credit_card_validations/version.rb

@@ -0,0 +1,3 @@
+module CreditCardValidations
+  VERSION = "1.0.0"
+end

data/test/credit_card_validations_test.rb

@@ -0,0 +1,92 @@
+require 'test/unit'
+lib = File.expand_path("#{File.dirname(__FILE__)}/../lib")
+unit_tests = File.expand_path("#{File.dirname(__FILE__)}/../test")
+$:.unshift(lib)
+$:.unshift(unit_tests)
+
+require 'credit_card_validations'
+
+class CreditCardValidationsTest < Test::Unit::TestCase
+
+  class CreditCardModel
+    attr_accessor :number
+    include ActiveModel::Validations
+    validates :number, presence: true, credit_card_number: {brands: [:amex, :maestro]}
+  end
+
+
+  def initialize name
+    super name
+    @test_numbers = {
+        visa: '4012 8888 8888 1881',
+        mastercard: '5274 5763 9425 9961',
+        diners: '3020 4169 3226 43',
+        amex: '3400 0000 0000 009',
+        discover: '6011 1111 1111 1117',
+        maestro: '6759 6498 2643 8453',
+        jcb: '3575 7591 5225 4876',
+        solo: '6767 6222 2222 2222 222',
+        unionpay: '6264185212922132067',
+
+    }
+  end
+
+  def test_card_brand_detection
+    @test_numbers.each do |key, value|
+      assert_equal key, detector(value).brand
+      assert detector(value).send("#{key}?")
+    end
+  end
+
+  def test_card_brand_is_nil_if_credit_card_invalid
+    assert_nil detector('1111111111111111').brand
+  end
+
+  def test_card_valid_method
+    @test_numbers.each do |key, value|
+      assert detector(value).valid?(key)
+      assert detector(value).valid?
+    end
+    assert !detector('1111111111111111').valid?
+  end
+
+
+  def test_card_particular_brand_valid
+    assert !detector(@test_numbers[:visa]).valid?(:mastercard)
+    assert !detector(@test_numbers[:mastercard]).valid?(:visa)
+  end
+
+
+  def test_card_particular_brands_valid
+    assert detector(@test_numbers[:visa]).valid?(:mastercard, :visa)
+    assert !detector(@test_numbers[:visa]).valid?(:mastercard, :amex)
+  end
+
+  #add rules which were not present before
+  def test_card_valid_after_rules_added
+    voyager_test_card_number = '869926275400212'
+    assert !detector(voyager_test_card_number).valid?
+    CreditCardValidations::Detector.add_rule(:voyager, 15, '86')
+    assert detector(voyager_test_card_number).valid?
+    assert_equal :voyager, detector(voyager_test_card_number).brand
+    assert detector(voyager_test_card_number).voyager?
+    assert !detector(voyager_test_card_number).visa?
+    assert !detector(voyager_test_card_number).mastercard?
+  end
+
+  def test_active_model_validator
+     cc = CreditCardModel.new
+     cc.number = @test_numbers[:mastercard]
+     assert !cc.valid?
+     cc.number = @test_numbers[:amex]
+     assert cc.valid?
+  end
+  
+  protected
+
+  def detector(number)
+    CreditCardValidations::Detector.new(number)
+  end
+
+
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: credit_card_validations
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Igor
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: &70262684219780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70262684219780
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: &70262684219080 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70262684219080
+description: A ruby gem for validating credit card numbers (a port of ZF2 Zend\Validator\CreditCard)
+  —
+email:
+- fedoronchuk@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- credit_card_validations.gemspec
+- lib/credit_card_number_validator.rb
+- lib/credit_card_validations.rb
+- lib/credit_card_validations/card_rules.rb
+- lib/credit_card_validations/detector.rb
+- lib/credit_card_validations/luhn.rb
+- lib/credit_card_validations/version.rb
+- test/credit_card_validations_test.rb
+homepage: https://github.com/Fivell/credit_card_validations
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: gem for credit card numbers validation, card brands detections
+test_files:
+- test/credit_card_validations_test.rb
+has_rdoc: