luhn_rs

A fast, minimal implementation of the Luhn algorithm.

• Generate Luhn numbers
• Validate Luhn numbers
• Generate random valid Luhn numbers
• No dependencies (except rand for random generation)
• Comprehensive error handling
• Fully tested and benchmarked

Installation

Add this to your Cargo.toml:

[dependencies]
luhn_tools = "0.2.1"

Usage

use luhn_tools::{generate, validate, random, GenerateOptions};

// Generate a checksum and return new Luhn number
let result = generate("7992739871", None).unwrap();
assert_eq!(result, "79927398713");

// Generate only the checksum
let options = Some(GenerateOptions { checksum_only: true });
let checksum = generate("7992739871", options).unwrap();
assert_eq!(checksum, "3");

// Validate a Luhn number
assert!(validate("79927398713").unwrap());

// Generate a random valid Luhn number of length 10
let random_number = random("10").unwrap();
assert!(validate(&random_number).unwrap());

# view docs
$ cargo doc --no-deps --open

# run tests
$ cargo test

# run benchmarks
$ cargo bench

Contributing

Contributions welcome! Please feel free to submit a Pull Request.

License

MIT