cyluhn 0.2.0

Fast library to validate and generate check digits using the Luhn algorithm

Cyluhn

A simple, fast library for verifying and calculating Luhn check digits, as well as generating random serial numbers with valid Luhn check digits for testing.

Cyluhn is mostly a Cython port of the pure-Python luhn library, acheiving a boost in speed while still being easy to install with pip. Cyluhn is intended to reduce the amount of time needed to validate a large number of Luhn-validated numbers such as credit card numbers or IMEIs during batch processing.

Compatible with Python 2.7 and Python 3.

Installation

pip install cyluhn

Usage

Cyluhn module

import cyluhn

cyluhn.generate_valid_luhn_str(ndigits=15)
# '136260325312871'

cyluhn.verify('136260325312871')
# True

cyluhn.get_check_digit('13626032531287')
# 1

cyluhn.append_check_digit('13626032531287')
# '136260325312871'

cyluhn-generate Command-Line Utility

cyluhn-generate -h
usage: cyluhn-generate [-h] -d NDIGITS -n NSERIALS

Generate serial numbers with valid Luhn check digit

optional arguments:
  -h, --help            show this help message and exit
  -d NDIGITS, --ndigits NDIGITS
                        Number of digits in each generated serial number
  -n NSERIALS, --nserials NSERIALS
                        Number of serial numbers to generate

Example:
cyluhn-generate -d 16 -n 10
7781801660482648
3204945043783442
6774339190776602
7715248262106681
7482722928054759
0435980693667196
6857863506381286
7743440795032247
8555647107058638
9772875170328167

Runtime comparisons with luhn

%timeit cyluhn.generate_valid_luhn_str(15)
638 ns ± 1.1 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each)

%timeit luhn.append(''.join(random.choices('0123456789', k=14)))
6.48 µs ± 15.8 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each)
---
%timeit cyluhn.verify('136260325312871')
192 ns ± 0.122 ns per loop (mean ± std. dev. of 7 runs, 10000000 loops each)

%timeit luhn.verify('136260325312871')
3.26 µs ± 18.2 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each)
---
%timeit cyluhn.get_check_digit('13626032531287')
220 ns ± 1.1 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each)

%timeit luhn.generate('13626032531287')
3.34 µs ± 13.7 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each)
---
%timeit cyluhn.append_check_digit('13626032531287')
367 ns ± 1.01 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each)

%timeit luhn.append('13626032531287')
3.62 µs ± 15.6 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each)