/luhn

A base-independent implementation of the Luhn algorithm for Swift. Useful for generating and verifying check digits in arbitrary bases.

Primary LanguageSwiftMIT LicenseMIT

Base indipendent Luhn

Twitter: @serluca License Carthage compatible CocoaPods Compatible Platform Build Status codecov

A base-independent implementation of the Luhn algorithm for Swift. Useful for generating and verifying check digits in arbitrary bases.

To consider a porting of https://github.com/benhodgson/baluhn in swift.

From Wikipedia:

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

Installation

Cocoapods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate Luhn into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
use_frameworks!

pod 'Luhn'

Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Luhn into your Xcode project using Carthage, specify it in your Cartfile file:

github "serluca/Luhn"

Swift Package Manager

Swift Package Manager coming soon.

Manually

Download the project and copy the Sources folder content into your project to use it in.

Usage

Luhn provides two functions: verify and generate.

generate calculates the Luhn check character for the given input string in the given base. This character should be appended to the input string to produce a valid Luhn string.

verify tests whether or not a string is a valid Luhn string in the given base. By default, luhn operates in base 10:

To use it, just import Luhn in your projectimport Luhn

Example

Clone and open the playground to see a live usage of the library.

// Genereta a value to have a valid luhn using the decimal alphabet
try Luhn.generate(baseString: "7992739871") // Generate 3

// Verify if the string is a valid luhn using the decimal alphabet
try Luhn.verify(string: "79927398713") // A valid lunh
try Luhn.verify(string: "79927398714") // An invalid luhn

// Using a defined alphabet
let alphabet = "abcdefghijklmnopqrstuvwxyz"
try Luhn.generate(baseString: "swift", alphabet: alphabet) // Returns l
try Luhn.verify(string: "swiftl", alphabet: alphabet) // A valid luhn
try Luhn.verify(string: "swiftz", alphabet: alphabet) // An invalid luhn

Special Thanks

Special thanks to @benhodgson

License

Luhn is released under the MIT license. See LICENSE for details.