dixon 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fd4287564dded1221c414b3d82f74530a455bc32
+  data.tar.gz: 354729bdd37756951627dda36db658f57e07c009
+SHA512:
+  metadata.gz: 4fac674805c6df5e41ffdf367c56568c4abe746ebde49ae664f0c132e52434f7f21c73f57f68eb5d9ee29f51008622c8695c0599ba574a71a995813b02a3c5af
+  data.tar.gz: 766eabfa151d89352b72ba8cca0f0ee75953cc95e01021e0abfda90225353d977a54eb60b51148b162972610092b540d0a79e0a01ee1b00d8d131f97269bb37b

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.pryrc

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Juanito Fatas
+
+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,54 @@
+# Dixon
+
+[Frank] Dixon checks your ID number.
+
+Now only supports identification number for Taiwan, more are coming up.
+
+## Requirements
+
+Ruby 2.0+
+
+## Installation
+
+    $ gem install dixon
+
+## API
+
+Provides three instance methods: `checks`, `gender`, and `issued_by`.
+
+* `checks` checks if given ID is a valid Taiwan identification number.
+
+* `gender` returns gender of given ID.
+
+* `issued_by` returns which local agencies issued this ID.
+
+## Usage
+
+    Dixon::Validators::Taiwan.new.checks 'A123456789'
+    => true
+
+    Dixon::Validators::Taiwan.new.gender 'A123456789'
+    => "male"
+
+    Dixon::Validators::Taiwan.new.issued_by 'A123456789'
+    => "Taipei City"
+
+## 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
+
+## TODO
+
+* add tests.
+
+## Author
+
+Juanito Fatas
+
+## License
+
+MIT License

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/dixon.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dixon/version'
+
+Gem::Specification.new do |spec|
+  spec.platform      = Gem::Platform::RUBY
+
+  spec.name          = "dixon"
+  spec.version       = Dixon::VERSION
+
+  spec.authors       = ["Juanito Fatas"]
+  spec.email         = ["katehuang0320@gmail.com"]
+
+  spec.description   = %q{Dixon checks your identification number!}
+  spec.summary       = spec.description
+  spec.homepage      = "https://github.com/JuanitoFatas/dixon"
+
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/dixon.rb

@@ -0,0 +1,3 @@
+require 'dixon/version'
+require 'dixon/validators/helpers'
+require 'dixon/validators/taiwan'

data/lib/dixon/validators/helpers.rb

@@ -0,0 +1,11 @@
+module Dixon
+  module ArrayHelpers
+    def element_of_same_size
+      self.all? { |a| a.size == self.first.size }
+    end
+  end
+end
+
+class Array
+  include Dixon::ArrayHelpers
+end

data/lib/dixon/validators/taiwan.rb

@@ -0,0 +1,133 @@
+module Dixon
+  module Validators
+    class Taiwan
+
+      INVALID_MESSAGE = 'Invalid ID number.'
+
+      LETTER_ISSUED_BY = {
+        # Active Letters
+        'A' => 'Taipei City'     , 'B' => 'Taichung City',
+        'C' => 'Keelung City'    , 'D' => 'Tainan City',
+        'E' => 'Kaohsiung City'  , 'F' => 'New Taipei City',
+        'G' => 'Yilan County'    , 'H' => 'Taoyuan County',
+        'I' => 'Chiayi City'     , 'J' => 'Hsinchu County',
+        'K' => 'Miaoli County'   , 'M' => 'Nantou County',
+        'N' => 'Changhua County' , 'O' => 'Hsinchu City',
+        'P' => 'Yunlin County'   , 'Q' => 'Chiayi County',
+        'T' => 'Pingtung County' , 'U' => 'Hualien County',
+        'V' => 'Taitung County'  , 'W' => 'Kinmen County',
+        'X' => 'Penghu County'   , 'Z' => 'Lienchiang County',
+        # Letters no longer issued
+        'L' => 'Taichung County' ,
+        'R' => 'Tainan County'   ,
+        'S' => 'Kaohsiung County',
+        'Y' => 'Yangmingshan Management Bureau'
+      }
+
+      LETTER_NUMBERS = {
+        'A' => '10', 'B' => '11', 'C' => '12', 'D' => '13', 'E' => '14',
+        'F' => '15', 'G' => '16', 'H' => '17', 'J' => '18', 'K' => '19',
+        'L' => '20', 'M' => '21', 'N' => '22', 'P' => '23', 'Q' => '24',
+        'R' => '25', 'S' => '26', 'T' => '27', 'U' => '28', 'V' => '29',
+        'X' => '30', 'Y' => '31', 'W' => '32', 'Z' => '33', 'I' => '34',
+        'O' => '35'
+      }
+
+      RULE_NUMBERS = [1, 9, 8, 7, 6, 5, 4, 3, 2, 1, 1]
+
+      ## Check if a given ID is valid.
+      # `id` must be a string, case is insensitive.
+      # First convert ID into all numbers, then multiply to RULE_NUMBERS
+      # element by element. Sum up and take a 10 modulo then check
+      # if remainder is 0. If it's, return true, false otherwise.
+      def checks(id)
+        # "F127337575" => [1, 5, 1, 2, 7, 3, 3, 7, 5, 7, 5]
+        converted = convert id.to_s
+        #    [1,  5,  1,  2,  7,  3,  3,  7,  5,  7, 5]
+        #  * [1,  9,  8,  7,  6,  5,  4,  3,  2,  1, 1]
+        #  --------------------------------------------
+        # sum 1, 45,  8, 14, 43, 15, 12, 21, 10,  7, 5
+        # => 180
+        # 180 mod 10, is the remainder equal to zero? If so, return true.
+        #
+        return (mapcar(-> (a,b) { a * b }, converted, RULE_NUMBERS).reduce(:+).divmod 10)[1] == 0
+      end
+
+      ## Returns gender for given ID.
+      # By check the second digit of ID.
+      # 1 is male, 2 is female.
+      def gender(id)
+        case id[1]
+          when '1' then 'male'
+          when '2' then 'female'
+          else puts INVALID_MESSAGE
+        end
+      end
+
+      ## Returns local agencies who issued your id.
+      def issued_by(id)
+        LETTER_ISSUED_BY[id[0]]
+      end
+
+      private
+
+      ## Convert array of strings into integer array.
+      def to_i_array(str_arr)
+        str_arr.map(&:to_i)
+      end
+
+      ## Convert an identification number to array of strings
+      # First letter conversion rules is defined in LETTER_NUMBERS
+      # `convert 'F127337575'` will result in
+      # [1, 5, 1, 2, 7, 3, 3, 7, 5, 7, 5]
+      def convert(id)
+        to_i_array((LETTER_NUMBERS[id[0]] + id[1..-1]).split(''))
+      end
+
+      ## mapcar operates on successive elements of the arrays.
+      # fn is applied to the first element of each array, then to the second element of each array, and so on. The iteration terminates when the shortest array runs out, and excess elements in other arrays are ignored. The value returned by mapcar is a array of the results of successive calls to function
+      def mapcar(fn, *arrs)
+        return [] if arrs.empty? or arrs.include? []
+        transposed = if arrs.element_of_same_size
+                       arrs.transpose
+                     else
+                       arrs[0].zip(*arrs.drop(1))
+                     end
+        transposed.map do |e|
+          e.reduce(&fn) unless e.include? nil
+        end
+      end
+    end
+  end
+end
+
+module ValidateFormat
+
+  TAIWAN_ID_REGEXP = /[a-zA-Z][1|2][0-9]+/i
+
+  ## Check if given id's format is valid.
+  # The current ID number has exact 10 digits
+  # The first digit is one capital English letter and
+  # is followed by nine Arabic numerals.
+  def valid_format?(id)
+    return true if id =~ TAIWAN_ID_REGEXP and id.size == 10
+    puts 'Invalid ID number.'
+    false
+  end
+
+  %i(checks gender issued_by convert).each do |m|
+    define_method(m) { |id| super(id) if valid_format? id }
+  end
+
+  private :convert
+
+end
+
+module Dixon
+  module Validators
+    class Taiwan
+      prepend ValidateFormat
+    end
+  end
+end
+

data/lib/dixon/version.rb

@@ -0,0 +1,3 @@
+module Dixon
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: dixon
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Juanito Fatas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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'
+description: Dixon checks your identification number!
+email:
+- katehuang0320@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- dixon.gemspec
+- lib/dixon.rb
+- lib/dixon/validators/helpers.rb
+- lib/dixon/validators/taiwan.rb
+- lib/dixon/version.rb
+homepage: https://github.com/JuanitoFatas/dixon
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.6
+signing_key: 
+specification_version: 4
+summary: Dixon checks your identification number!
+test_files: []
+has_rdoc: