Project

luhn

0.04
No release in over 3 years
Low commit activity in last 3 years
A small implementation of the Luhn algorithm.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

~> 2.6.0
 Project Readme

Ruby class for handling basic Luhn number generation and verification

Includes a class to handle Swedish personal identity numbers (Personnummer).

The interface supports checking validity (length, valid date and satisfies luhn), returning the sex, the control digit, and generating random identity numbers.

Install

$ gem install luhn

Usage:

Basic Luhn

Luhn.valid?("0465827879483596")       # true
Luhn.control_digit("046582787948359") # 6
Luhn.generate(n)                      # returns a random number of n length that satisfies luhn

Swedish personal identity numbers

number = Luhn::PersonalIdentityNumber.new("19391030-3183")
number.valid?        # true
number.sex           # "male"
number.male?         # true
number.control_digit # 3

About the Luhn algorithm

The following is an excerpt from the Wikipedia article on the Luhn algorithm.

The Luhn algorithm or Luhn formula, also known as the "modulus 10" or "mod 10" algorithm, is a simple checksum formula used to validate a variety of identification numbers, such as credit card numbers, IMEI numbers, National Provider Identifier numbers in US and Canadian Social Insurance Numbers, and even South African ID numbers.

It was created by IBM scientist Hans Peter Luhn and described in U.S. Patent No. 2,950,048, filed on January 6, 1954, and granted on August 23, 1960.

Copyright

Copyright (c) 2010 Joel Junström. See LICENSE for details.