Latest 2.1.0
Homepage https://github.com/serluca/luhn
License MIT
Platforms ios 8.0, osx 10.9, tvos 9.0, watchos 2.0
Authors

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.

Latest podspec

{
    "name": "Luhn",
    "version": "2.1.0",
    "license": "MIT",
    "summary": "A base-independent implementation of the Luhn algorithm for Swift. Useful for generating and verifying check digits in arbitrary bases.",
    "homepage": "https://github.com/serluca/luhn",
    "social_media_url": "http://twitter.com/serluca",
    "authors": {
        "Luca Serpico": "[email protected]"
    },
    "source": {
        "git": "https://github.com/serluca/luhn.git",
        "tag": "2.1.0"
    },
    "platforms": {
        "ios": "8.0",
        "osx": "10.9",
        "tvos": "9.0",
        "watchos": "2.0"
    },
    "source_files": "Sources/*.swift"
}

Pin It on Pinterest

Share This