Skip to content
/ ex_nric Public

Validation for National Registration Identity Card numbers (NRIC)

License

Notifications You must be signed in to change notification settings

falti/ex_nric

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ExNric

Hex.pm Version

About

Validation for Singapore National Registration Identity Card numbers (NRIC)

Installation

If available in Hex, the package can be installed by adding ex_nric to your list of dependencies in mix.exs:

def deps do
  [
    {:ex_nric, "~> 0.2.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/ex_nric.

Usage

import ExNric

{:ok, "S7343684B"} = validate("S7343684B")

{:error, :invalid_format} = validate("x")
{:error, :invalid_format} = validate("x")
{:error, :checksum_error} = validate("G0047750U")

Contributing

Pull requests to contribute new or improved features, and extend documentation are most welcome.

Please follow the existing coding conventions, or refer to the Elixir style guide.

You should include unit tests to cover any changes. Run mix test to execute the test suite. You should also ensure that dialyzer checks pass. Run mix dialyzer to verify.