card_number_validator 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 792adead3f31ccece3c62f991b8964f92dc4e3e4
+  data.tar.gz: 5fa9c34c2610a977061f73c83a836b267fafb709
+SHA512:
+  metadata.gz: ead04a8bd9acdd54ed661e692c77557830b456125c196cf504765ea05c6c130fa3a4d3dd3e30e96e1ff0e6f61f843bdf3a87309658ee04ae5279672557fe7a8a
+  data.tar.gz: 80ab605c24bc73ecd7c9c3977c06e7fd5dd75a8a748305b4ec511842b3cd0ff042d24d6b487ea6ee91ed59e74edc939998f01418b676e9812f31936f78cac899

data/.gitignore

@@ -0,0 +1 @@
+coverage/**/*

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation

data/.travis.yml

@@ -0,0 +1,17 @@
+env:
+  global:
+    - CC_TEST_REPORTER_ID=0068493eada9bebcf78849cdb6abeb964653cd7646a000519cf148c9731de82a
+language: ruby
+rvm:
+  - 2.3.3
+before_install: gem install bundler -v 1.16.1
+notifications:
+  - false
+before_script:
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+scripts:
+  - bundle exec rspec spec
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,49 @@
+PATH
+  remote: .
+  specs:
+    card_number_validator (0.1.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ansi (1.5.0)
+    diff-lcs (1.3)
+    docile (1.3.0)
+    hirb (0.7.3)
+    json (2.1.0)
+    rake (12.3.1)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-console (0.4.2)
+      ansi
+      hirb
+      simplecov
+    simplecov-html (0.10.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  card_number_validator!
+  rake
+  rspec
+  simplecov
+  simplecov-console
+
+BUNDLED WITH
+   1.16.1

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright © 2007-2008 Sharon Rosner Copyright © 2008-2018 Jeremy Evans
+
+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 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,78 @@
+# card_number_validator [![Build Status][travis-badge]][travis] [![Code Climate][code-climate-badge]][code-climate]
+
+Card Validator provides you some methods to validate the most used card flags in the world.
+In addition, you can generate fake card numbers for development and tests purposes.
+
+## Installation
+
+Add `card_number_validator` to `Gemfile`
+`Gemfile`:
+
+```ruby
+gem 'card_number_validator', '0.1.0'
+```
+
+Download and install by running:
+
+```
+bundle install
+```
+
+----
+
+## Usage
+
+### CardNumberValidator.flag(card_number)
+Returns flag name to provided card number or :unknown
+when the provided number is invalid
+
+See Example:
+``` ruby
+  CardNumberValidator.flag('378282246310005') # :amex 
+  CardNumberValidator.flag('30569309025904') # :diners 
+  CardNumberValidator.flag('6363683839698868') # :elo 
+  CardNumberValidator.flag('6062826289081176') # :hipercard 
+  CardNumberValidator.flag('4012888888881881') # :visa 
+  CardNumberValidator.flag('5223358786371817') # :mastercard
+  CardNumberValidator.flag('111') # :unknown
+```
+### CardNumberValidator.valid?(card_number)
+Returns if provided card number is valid or not
+
+See Example:
+``` ruby
+  CardNumberValidator.valid?('378282246310005') # true
+  CardNumberValidator.valid?('30569309025904') # true
+  CardNumberValidator.valid?('6363683839698868') # true
+  CardNumberValidator.valid?('6062826289081176') # true
+  CardNumberValidator.valid?('4012888888881881') # true
+  CardNumberValidator.valid?('5223358786371817') # true
+  CardNumberValidator.valid?('111') # false
+```
+
+### CardNumberValidator.generate(:flag_name)
+Returns fake card number by provided flag name
+
+See Example:
+``` ruby
+  CardNumberValidator.generate(:amex) # '378282246310005'
+```
+
+## Contributing
+
+Card Validator is open source, and we are grateful for
+[everyone][contributors] who's contributed so far.
+
+## License
+
+It is free software, and may be redistributed under the terms specified in the [MIT-LICENSE](MIT-LICENSE) file.
+
+## Feature Requests & Bugs
+
+See <http://github.com/pauloh-silva/card_number_validator/issues>
+
+[contributors]: https://github.com/pauloh-silva/card_number_validator/contributors
+[travis]: https://travis-ci.org/pauloh-silva/card_number_validator
+[travis-badge]: https://travis-ci.org/pauloh-silva/card_number_validator.svg?branch=master
+[code-climate]: https://codeclimate.com/github/pauloh-silva/card_number_validator
+[code-climate-badge]: https://codeclimate.com/github/codeclimate/codeclimate/badges/gpa.svg

data/card_number_validator.gemspec

@@ -0,0 +1,17 @@
+Gem::Specification.new do |s|
+  s.name        = 'card_number_validator'
+  s.version     = '0.1.1'
+  s.authors     = ['Paulo Henrique da Silva']
+  s.email       = ['paulo.silva1337@gmail.com']
+  s.homepage    = 'https://github.com/pauloh-silva/card_number_validator'
+  s.summary     = 'Ruby library to validate payment card numbers'
+  s.license     = 'MIT'
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- spec/*`.split("\n")
+
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'simplecov'
+  s.add_development_dependency 'simplecov-console'
+end

data/lib/card_number_validator.rb

@@ -0,0 +1,40 @@
+require 'securerandom'
+require 'card_number_validator/cards/amex'
+require 'card_number_validator/cards/diners'
+require 'card_number_validator/cards/elo'
+require 'card_number_validator/cards/hiper'
+require 'card_number_validator/cards/hipercard'
+require 'card_number_validator/cards/mastercard'
+require 'card_number_validator/cards/visa'
+
+module CardNumberValidator
+
+  FLAGS = %i(
+    amex diners elo hiper hipercard mastercard visa
+  )
+
+  def self.flag(card_number)
+    card_number = card_number.to_s
+    self::FLAGS.each do |flag|
+      flag_found = flag_class(flag).send('validate', card_number)
+      return flag if flag_found
+    end
+    :unknown
+  end
+
+  def self.valid?(card_number)
+    flag(card_number) != :unknown
+  end
+
+  def self.generate(flag)
+    flag = flag.to_sym
+    return unless self::FLAGS.include?(flag)
+    flag_class(flag).send('generate')
+  end
+
+  def self.flag_class(flag)
+    flag_class = "CardNumberValidator::Cards::#{flag.to_s.capitalize}"
+    flag_class = 'CardNumberValidator::Cards::Diners' if flag == :diners
+    Kernel.const_get flag_class
+  end
+end

data/lib/card_number_validator/cards/amex.rb

@@ -0,0 +1,14 @@
+module CardNumberValidator
+  module Cards
+    class Amex
+
+      def self.validate(card_number)
+        card_number ? /^3(7|4)\d{13}/.match(card_number) : false
+      end
+      
+      def self.generate
+        "37#{rand(10**14).to_s.rjust(14,rand(1..9).to_s)}"
+      end
+    end
+  end
+end

data/lib/card_number_validator/cards/diners.rb

@@ -0,0 +1,14 @@
+module CardNumberValidator
+  module Cards
+    class Diners
+
+      def self.validate(card_number)
+        card_number ? /^3\d{13}/.match(card_number) : false
+      end
+      
+      def self.generate
+        "3#{rand(10**13).to_s.rjust(13,rand(1..9).to_s)}"
+      end
+    end
+  end
+end

data/lib/card_number_validator/cards/elo.rb

@@ -0,0 +1,21 @@
+module CardNumberValidator
+  module Cards
+    class Elo
+      ELO_BINS = %w[
+        401178 401179 431274 438935 451416
+        457393 457631 457632 504175 627780
+        636297 636368 636369
+      ].freeze
+
+      def self.validate(card_number)
+        return unless card_number && card_number.size == 16
+        self::ELO_BINS.include? card_number[0..5]
+      end
+      
+      def self.generate
+        card_prefix = self::ELO_BINS[rand(0..self::ELO_BINS.size-1)]
+        "#{card_prefix}#{rand(10**10).to_s.rjust(10,rand(1..9).to_s)}"
+      end
+    end
+  end
+end

data/lib/card_number_validator/cards/hiper.rb

@@ -0,0 +1,17 @@
+module CardNumberValidator
+  module Cards
+    class Hiper
+      HIPER_BINS = %w[637095 637612 637599 637609 637568].freeze
+
+      def self.validate(card_number)
+        return unless card_number && card_number.size == 16
+        self::HIPER_BINS.include? card_number[0..5]
+      end
+      
+      def self.generate
+        card_prefix = self::HIPER_BINS[rand(0..self::HIPER_BINS.size-1)]
+        "#{card_prefix}#{rand(10**10).to_s.rjust(10,rand(1..9).to_s)}"
+      end
+    end
+  end
+end

data/lib/card_number_validator/cards/hipercard.rb

@@ -0,0 +1,19 @@
+module CardNumberValidator
+  module Cards
+    class Hipercard
+
+      def self.validate(card_number)
+        return unless card_number
+        [
+          /^606282\d{10}$/,
+          /^3841(0|4|6)0\d{13}$/
+        ].each { |rgx| return true if rgx.match(card_number) }
+        false
+      end
+      
+      def self.generate
+        "606282#{rand(10**10).to_s.rjust(10,rand(1..9).to_s)}"
+      end
+    end
+  end
+end

data/lib/card_number_validator/cards/mastercard.rb

@@ -0,0 +1,29 @@
+module CardNumberValidator
+  module Cards
+    class Mastercard
+
+      MASTERCARD_RANGES = [
+        [222_100, 272_099]
+      ].freeze
+
+      def self.validate(card_number)
+        return unless card_number
+        /5\d{15}/.match(card_number) || valid_master_bin?(card_number)
+      end
+
+      def self.valid_master_bin?(card_number)
+        return unless card_number.size > 5
+        self::MASTERCARD_RANGES.each do |mc_range|
+          next unless (mc_range[0]..mc_range[1]).include?(card_number[0..5].to_i)
+          return true
+        end
+        false
+      end
+      
+      def self.generate
+        master_range = self::MASTERCARD_RANGES[rand(0..self::MASTERCARD_RANGES.size-1)]
+        "#{rand(master_range[0]..master_range[1])}#{rand(10**10).to_s.rjust(10,rand(1..9).to_s)}"
+      end
+    end
+  end
+end

data/lib/card_number_validator/cards/visa.rb

@@ -0,0 +1,14 @@
+module CardNumberValidator
+  module Cards
+    class Visa
+
+      def self.validate(card_number)
+        /^4\d{15}/.match(card_number)
+      end
+      
+      def self.generate
+        "4#{rand(10**15).to_s.rjust(15,rand(1..9).to_s)}"
+      end
+    end
+  end
+end

data/spec/lib/card_number_validator_spec.rb

@@ -0,0 +1,62 @@
+RSpec.describe CardNumberValidator do
+  before do
+    @valid_card_numbers = {
+      amex: '378282246310005',
+      diners: '30569309025904',
+      elo: '6363683839698868',
+      hipercard: '6062826289081176',
+      visa: '4012888888881881',
+      mastercard: '5223358786371817'
+    }
+  end
+
+  context 'Checking card flag' do
+    describe 'Valid card numbers' do
+      it 'Should returns card flag name' do
+        @valid_card_numbers.each do |flag, number|
+          expect(CardNumberValidator.flag(number)).to eq flag
+        end
+      end
+    end
+
+    describe 'Invalid card numbers' do
+      it 'Should returns :unknow as card flag name' do
+        expect(CardNumberValidator.flag(111)).to eq :unknown
+      end
+    end
+  end
+
+  context 'Checking card validity' do
+    describe 'Valid card numbers' do
+      it 'Should returns true' do
+        @valid_card_numbers.each do |flag, number|
+          expect(CardNumberValidator.valid?(number)).to be_truthy
+        end
+      end
+    end
+
+    describe 'Invalid card numbers' do
+      it 'Should returns false' do
+        expect(CardNumberValidator.valid?(111)).to be_falsey
+      end
+    end
+  end
+
+  context 'Checking card generation' do
+    describe 'Valid flags' do
+      it 'Should create a valid card number to provided flag' do
+        @valid_card_numbers.each do |flag, _number|
+          generated_card_number = CardNumberValidator.generate(flag)
+          expect(CardNumberValidator.flag(generated_card_number)).to eq flag
+        end
+      end
+    end
+
+    describe 'Invalid flags' do
+      it 'Should returns empty response' do
+        generated_card_number = CardNumberValidator.generate(:invalid_flag)
+        expect(generated_card_number).to be_nil
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,27 @@
+require 'simplecov'
+require 'simplecov-console'
+
+require "#{Dir.getwd}/lib/card_number_validator"
+SimpleCov.formatter = SimpleCov::Formatter::Console
+SimpleCov.start
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+  config.filter_run_when_matching :focus
+  config.disable_monkey_patching!
+  config.warnings = true
+
+  config.profile_examples = 1
+  config.order = :random
+end

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: card_number_validator
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Paulo Henrique da Silva
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-04-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- paulo.silva1337@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- README.md
+- bin/versions/card_validator-0.1.0.gem
+- card_number_validator.gemspec
+- lib/card_number_validator.rb
+- lib/card_number_validator/cards/amex.rb
+- lib/card_number_validator/cards/diners.rb
+- lib/card_number_validator/cards/elo.rb
+- lib/card_number_validator/cards/hiper.rb
+- lib/card_number_validator/cards/hipercard.rb
+- lib/card_number_validator/cards/mastercard.rb
+- lib/card_number_validator/cards/visa.rb
+- spec/lib/card_number_validator_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/pauloh-silva/card_number_validator
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Ruby library to validate payment card numbers
+test_files:
+- spec/lib/card_number_validator_spec.rb
+- spec/spec_helper.rb