cw_credit_card_validations 3.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e1941b4388616c9c9c9b918c90ad8e34851c4eb1
+  data.tar.gz: 13b338b1b100f3417faf93d894f0642846d3a8a6
+SHA512:
+  metadata.gz: a70bcec1d3353715b44dcfd02a168580d0358b2724dbeb7ff5406c4b33071b571d339f405546fb6c1153f019726be0ef216b7b6ab6184bc958c79d8419edb23a
+  data.tar.gz: a5de82d23064e50834e4261c10d4131903ed90492ef15a2d4bdd5bc2d9a0b0f244e703e676d32dca9c17cbc55b4ec30246e1fb72bad7fd76f820e66e54fd9100

data/.hound.yml

@@ -0,0 +1,2 @@
+StringLiterals:
+  EnforcedStyle: single_quotes

data/.travis.yml

@@ -0,0 +1,26 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.9
+  - 2.2.5
+  - 2.3.1
+  - jruby-9.1.6.0
+gemfile:
+  - gemfiles/rails1-4.gemfile
+  - gemfiles/rails5.gemfile
+matrix:
+  exclude:
+    - gemfile: gemfiles/rails5.gemfile
+      rvm: 1.9.3
+    - gemfile: gemfiles/rails5.gemfile
+      rvm: 2.0.0
+    - gemfile: gemfiles/rails5.gemfile
+      rvm: 2.1.9
+    - gemfile: gemfiles/rails5.gemfile
+      rvm: jruby-9.1.6.0
+before_install:
+  - gem update --system
+  - rvm @global do gem uninstall bundler -a -x
+  - rvm @global do gem install bundler -v 1.13.7
+  - gem --version

data/Changelog.md

@@ -0,0 +1,115 @@
+# 3.4.0
+   * Elo support enhanced, PR #75
+   
+# 3.3.0
+   * Added support for MIR card brand
+
+# 3.2.2
+   * Relaxing dependency requirements to support Rails 5
+
+# 3.2.1
+   * Improved support for new Mastercard range (222100 – 272099)
+
+# 3.2.0
+   * Added support for new Mastercard range (222100 – 272099)
+
+# 3.1.0
+   * Added support for ELO brand
+
+# 3.0.0
+   * Remove Laser brand because Laser cards were withdrawn from the market on February 28 2014
+   * Remove Diners US brand for similar reason
+   * Move Laser ranges to Maestro. Add 6390 range to Maestro
+   * Add plugins for removed brands
+
+# 2.0.2
+   * fix using ActiveModel Validator's message option
+
+# 2.0.1
+   * fix typo dankrot -> dankort
+
+# 2.0.0
+
+  * added support for full brand names
+  * added possibility to remove card brands globally
+  * support for procs using :brand option for CreditCardNumberValidator
+  * :only and :except options for CreditCardNumberValidator
+  * credit card generator
+  * test unit -> specs migration
+  * card rules structure changed to allow custom options
+  * yaml storage implemented
+  * Maestro detection fix
+  * JCB detection fix
+
+
+# 1.5.1
+
+  * Maestro detection fix
+
+# 1.5.0
+
+  * Rupay detection support
+  * Hipercard detection support
+
+# 1.4.7
+
+  * Maestro and Switch detection fix
+
+# 1.4.6
+
+  * JCB detection fix
+
+# 1.4.5
+
+  * Diners detection fix
+
+# 1.4.4
+
+  * Visa detection fix
+
+# 1.4.3
+
+  * fix for Rails 4.+ dependency
+  * Maestro detection fixes
+
+# 1.4.2
+
+  * fix for Rails 4.1 dependency
+  * UnionPay and Discover detection fixes
+
+# 1.4.1
+
+  * fixed ActiveModel Validator syntax
+
+# 1.4.0
+
+  *  Dankort brand support
+
+# 1.3.0
+
+  * MMI detection support
+
+# 1.2.0
+
+  * Allow brand restriction when detecting brand
+  * fix for Rails 4.0 dependency
+  * Allow to skip Luhn validation for certain brands
+
+# 1.1.2
+
+  * Credit card number sanitizing fix
+  * :any instead of brand name can be used with ActiveModel Validator
+
+# 1.1.1
+
+  * ActiveModel Validator was moved from root namespace
+
+# 1.1.0
+
+  * Added rules for Maestro brand
+  * String extension added
+
+# 1.0.1
+
+  * Dependency fixes
+  * Added usage instructions to README

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+group :test do
+  gem 'coveralls', require: false # Test coverage website. Go to https://coveralls.io
+end
+# 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,162 @@
+# CreditCardValidations
+
+[![Build Status](http://img.shields.io/travis/Fivell/credit_card_validations.svg)](https://travis-ci.org/Fivell/credit_card_validations)
+[![Dependency Status](http://img.shields.io/gemnasium/Fivell/credit_card_validations.svg)](https://gemnasium.com/Fivell/credit_card_validations)
+[![Coverage Status](http://img.shields.io/coveralls/Fivell/credit_card_validations.svg)](https://coveralls.io/r/Fivell/credit_card_validations)
+[![Code Climate](http://img.shields.io/codeclimate/github/Fivell/credit_card_validations.svg)](https://codeclimate.com/github/Fivell/credit_card_validations)
+[![Gem Version](http://img.shields.io/gem/v/credit_card_validations.svg)](https://rubygems.org/gems/credit_card_validations)
+[![License](http://img.shields.io/:license-mit-blue.svg)](http://Fivell.mit-license.org)
+
+
+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.
+
+More info about card BIN numbers http://en.wikipedia.org/wiki/Bank_card_number
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```sh
+$ gem 'credit_card_validations'
+```
+
+And then execute:
+
+```sh
+$ bundle
+```
+
+Or install it yourself as:
+
+```sh
+$ gem install credit_card_validations
+```
+
+## Usage
+
+
+The following issuing institutes are accepted:
+    
+|    Name   |    Key     | 
+---------------------   | ------------| 
+[American Express](http://en.wikipedia.org/wiki/American_Express) | :amex
+[China UnionPay](http://en.wikipedia.org/wiki/China_UnionPay)    | :unionpay 
+[Dankort](http://en.wikipedia.org/wiki/Dankort)      | :dankort
+[Diners Club](http://en.wikipedia.org/wiki/Diners_Club_International)  | :diners   
+[Elo](https://pt.wikipedia.org/wiki/Elo_Participa%C3%A7%C3%B5es_S/A)      | :elo
+[Discover](http://en.wikipedia.org/wiki/Discover_Card) | :discover   
+[Hipercard](http://pt.wikipedia.org/wiki/Hipercard) | :hipercard  
+[JCB](http://en.wikipedia.org/wiki/Japan_Credit_Bureau)  | :jcb
+[Maestro](http://en.wikipedia.org/wiki/Maestro_%28debit_card%29)    | :maestro
+[MasterCard](http://en.wikipedia.org/wiki/MasterCard)  |   :mastercard
+[MIR](http://www.nspk.ru/en/cards-mir/)  |   :mir
+[Rupay](http://en.wikipedia.org/wiki/RuPay) |   :rupay 
+[Solo](http://en.wikipedia.org/wiki/Solo_(debit_card))     | :solo
+[Switch](http://en.wikipedia.org/wiki/Switch_(debit_card)) | :switch 
+[Visa](http://en.wikipedia.org/wiki/Visa_Inc.)      | :visa  
+
+
+
+The following are supported with with plugins
+
+|    Name   |    Key     | 
+---------------------   | ------------| 
+[Diners Club US](http://en.wikipedia.org/wiki/Diners_Club_International#MasterCard_alliance)  | :diners_us  
+[EnRoute](https://en.wikipedia.org/wiki/EnRoute_(credit_card)) | :en_route
+[Laser](https://en.wikipedia.org/wiki/Laser_%28debit_card%29)      | :laser
+
+
+
+### Examples using string monkey patch
+
+```ruby
+require 'credit_card_validations/string'
+'5274 5763 9425 9961'.credit_card_brand   #=> :mastercard
+'5274 5763 9425 9961'.credit_card_brand_name   #=> "MasterCard"
+'5274 5763 9425 9961'.valid_credit_card_brand?(:mastercard, :visa) #=> true
+'5274 5763 9425 9961'.valid_credit_card_brand?(:amex) #=> false
+'5274 5763 9425 9961'.valid_credit_card_brand?('MasterCard') #=> true
+```
+
+### ActiveModel support
+
+only for certain brands
+
+```ruby
+class CreditCardModel
+  attr_accessor :number
+  include ActiveModel::Validations
+  validates :number, credit_card_number: {brands: [:amex, :maestro]}
+end
+```
+
+for all known brands
+
+```ruby
+validates :number, presence: true, credit_card_number: true
+```
+
+### Examples using CreditCardValidations::Detector class
+
+```ruby
+number = "4111111111111111"
+detector = CreditCardValidations::Detector.new(number)
+detector.brand #:visa
+detector.visa? #true
+detector.valid?(:mastercard,:maestro) #false
+detector.valid?(:visa, :mastercard) #true
+detector.issuer_category  #"Banking and financial"
+```
+
+### Also You can add your own brand rules to detect other credit card brands/types
+passing name,length(integer/array of integers) and prefix(string/array of strings)
+Example
+
+```ruby
+CreditCardValidations.add_brand(:voyager, {length: 15, prefixes: '86'})
+voyager_test_card_number = '869926275400212'
+CreditCardValidations::Detector.new(voyager_test_card_number).brand #:voyager
+CreditCardValidations::Detector.new(voyager_test_card_number).voyager? #true
+```
+
+### Remove brands also supported
+
+```ruby
+CreditCardValidations::Detector.delete_brand(:maestro)
+```
+
+### Check luhn
+
+```ruby
+CreditCardValidations::Detector.new(@credit_card_number).valid_luhn?
+#or
+CreditCardValidations::Luhn.valid?(@credit_card_number)
+```  
+
+### Generate credit card numbers that pass validation
+
+```ruby
+CreditCardValidations::Factory.random(:amex)
+# => "348051773827666"
+CreditCardValidations::Factory.random(:maestro)
+# => "6010430241237266856"
+```
+
+### Plugins 
+
+```ruby
+require 'credit_card_validations/plugins/en_route'
+require 'credit_card_validations/plugins/laser'
+require 'credit_card_validations/plugins/diners_us'
+```
+
+## 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 => [:specs]
+
+desc "Run basic specs"
+Rake::TestTask.new("specs") { |t|
+  t.pattern = 'spec/*_spec.rb'
+  t.verbose = true
+  t.warning = true
+}

data/credit_card_validations.gemspec

@@ -0,0 +1,29 @@
+# -*- 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          = "cw_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}
+  gem.summary       = "gem should be used for credit card numbers validation, card brands detections, luhn checks"
+  gem.homepage      = "http://fivell.github.io/credit_card_validations/"
+  gem.license     = "MIT"
+
+  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", "<= 6"
+  gem.add_dependency "activesupport", ">= 3", "<= 6"
+
+
+  gem.add_development_dependency "mocha", '1.1.0'
+  gem.add_development_dependency 'rake', '~> 10'
+
+end

data/gemfiles/rails1-4.gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+
+gem "activemodel", ">= 3", '< 5'
+gem "activesupport", ">= 3", '< 5'
+group :test do
+  gem 'tins', '< 1.3.4', platforms: [:ruby_19, :jruby]
+  gem 'term-ansicolor', '~> 1.3.0', platforms: [:ruby_19, :jruby]
+  gem 'coveralls', require: false # Test coverage website. Go to https://coveralls.io
+end
+
+gemspec :path => "../"

data/gemfiles/rails5.gemfile

@@ -0,0 +1,10 @@
+source "https://rubygems.org"
+
+gem "activemodel", ">= 5"
+gem "activesupport", ">= 5"
+
+group :test do
+  gem 'coveralls', require: false # Test coverage website. Go to https://coveralls.io
+end
+
+gemspec :path => "../"

data/lib/active_model/credit_card_number_validator.rb

@@ -0,0 +1,81 @@
+# == ActiveModel Validations CreditCardNumberValidator
+#  Can  be used in combination with the +validates+ method
+#
+#   Only Amex and Maestro
+#
+#   class CreditCard
+#     attr_accessor :number
+#     include ActiveModel::Validations
+#     validates :number, credit_card_number: {only: [:amex, :maestro]}
+#   end
+#
+#   All numbers are valid except Maestro
+#
+#  class CreditCard
+#     attr_accessor :number
+#     include ActiveModel::Validations
+#     validates :number, credit_card_number: {except: [:maestro]}
+#  end
+#
+#  Proc can be used as well
+#
+#  class CreditCard
+#     attr_accessor :number, :card_type
+#     include ActiveModel::Validations
+#     validates :number, credit_card_number: {brands: ->{|record|  Array(record.accepted_brands) }  }
+#
+#     def accepted_brands
+#       if card_type == 'Maestro'
+#         :maestro
+#       elsif card_type == 'American Express'
+#         :amex
+#       else
+#         :visa
+#       end
+#     end
+#
+#  end
+#
+#
+
+module ActiveModel
+  module Validations
+    class CreditCardNumberValidator < EachValidator
+
+      def validate_each(record, attribute, value)
+        record.errors.add(attribute, options[:message] || :invalid) unless credit_card_valid?(value, extract_brands(record, options))
+      end
+
+      def credit_card_valid?(number, brands = [])
+        CreditCardValidations::Detector.new(number).valid?(*brands)
+      end
+
+      protected
+
+      def extract_brands(record, options)
+        if options.has_key?(:brands)
+          with_brands(record, options[:brands])
+        elsif options.has_key?(:only)
+          Array(options[:only])
+        elsif options.has_key?(:except)
+          Array(CreditCardValidations::Detector.brands.keys) - Array(options[:except])
+        else
+          []
+        end
+
+      end
+
+      def with_brands(record, brands)
+        if brands.is_a?(Proc)
+          brands.call(record)
+        elsif options[:brands] == :any
+          []
+        else
+          Array(options[:brands])
+        end
+      end
+
+    end
+  end
+end
+