NifVal

Description

NifVal is a simple gem which adds a Spanish NIF/NIE/CIF validator to ActiveModel. You simply have to validate ":nif" for "true" for a specific field.

Installation

Simply add this gem to your Gemfile:

gem "nifval"

and execute bundle.

Note: It appears that if we load NifVal after Devise, Nifval won't work. In order to make everything work, simply add Nifval before Devise in the Gemfile.

Then run the generator in order to install the I18n template:

rails generate nifval:install

If you want to validate a Nif via Javascript, you can also add:

rails generate nifval:javascript

And you are done!

Usage

On your model

Let's see an example:

class Person
  validates :nif, :nif => true
  attr_accessor :nif
end

Then if we create an instance and see if it is valid, the validation will be checked.

Let's see one example for each case. A successful validation (correct control digit T for 00000000):

p = Person.new("00000000T")
p.valid? # will return true

And an unsuccessful one (mistaken control digit C for A2345678):

p = Person.new("A2345678C")
p.valid? # will return false

### Via Javascript ###

Please refer to the Installation section on how to get Nifval's Javascript file.

You only have to add nifval.js to your application layout. Assuming the use of HAML:

= javascript_include_tag "nifval"

And then execute the nifval(nifToCheck) function, which returns a boolean.

nifval("00000000T") // returns true
nifval("A2345678C") // returns false

Example

You can see both situations via the test application included in this gem. This test app is also available at http://nifvalapp.heroku.com.

Changelog

• v0.1.0 First version, basic Spanish NIF validation.
• v0.1.1 Some fixes on regexps taht would allow invalid NIFs.
• v0.1.2 Compatible with Ruby 1.8.7 and 1.9.2.
• v0.1.3 Adding I18n support for error messages.
• v0.1.4 Several fixes.
• v0.2.0 Added test app, and providing a Javascript version too.
• v0.2.1 Accepting strings with smaller than 9 chars.
• v0.2.2 Core refactor, thanks to @ritxi.

Contributors

Thanks to @ritxi for the refactoring in v0.2.2.

Documentation

Adapted from here.

You can also find more information on Wikipedia.