Taiwanese Id Validator for Ruby on Rails
台灣身分證字號 驗證&產生 的 Gem
Features
- Rails model 內驗證 (Rails 3+/4/5/6/7)
- Rails model 外驗證
- 新式統一證號驗證
- 產生符合格式的身分證字號，可選擇男女
Installation
Add this line to your application's Gemfile:
gem 'taiwanese_id_validator'
And then execute:
$ bundle
Or install it yourself as:
$ gem install taiwanese_id_validator
Usage
Rails Model Validation
基本使用
class User < ActiveRecord::Base
validates :twid, taiwanese_id: true
endOptions
-
allow_nilorallow_blank
class User < ActiveRecord::Base
validates :twid, taiwanese_id: { allow_nil: true }
end- Case sensitive, default is true
class User < ActiveRecord::Base
validates :twid, taiwanese_id: { case_sensitive: false }
endValidation outside the model
驗證身分證字號
TwidValidator.valid?('A123456789') #=> trueTwidValidator.valid?('A123456777') #=> false產生假身分證字號
Generator 是沒有被自動 require 的，所以要使用前要先 require:
require 'taiwanese_id_validator/twid_generator'
TwidGenerator.generate #=> 隨機產生身分證字號可以指定要產生男性或是女性的身分證字號
TwidGenerator.generate("male") #=> 男性的身分證字號TwidGenerator.generate("female") #=> 女性的身分證字號驗證統一證號
ItidValidator.valid?('A800000014') #=> trueItidValidator.valid?('A800000015') #=> falseOthers
Contributing
Check DEVELOPMENT.md
LICENSE
This project rocks and uses MIT-LICENSE.