4 releases

0.1.3 Mar 29, 2020
0.1.2 Mar 27, 2020
0.1.1 Jul 25, 2019
0.1.0 Jul 24, 2019

#1746 in Parser implementations

35 downloads per month

MIT license

26KB
441 lines

Travis Build Status AppVeyor Build status

PESEL is a simple Rust library to validate PESEL numbers.

What is PESEL number?

PESEL is national identification number used in Poland. Every citizen of Republic of Poland is assigned PESEL when being born (and since 2015 this should also apply to foreigners living in Poland for more than 2 months).

There are some interesting facts about the PESEL number - find more on Wikipedia

Usage & Examples

This library offers two main features:

a) creating PESEL from String (and performing some checks to make sure PESEL is valid)

use std::str::FromStr;

let pesel_number = "44051401458";
let result = PESEL::from_str(pesel_number);
match result {
    Ok(pesel) => println!("PESEL: {}", pesel),
    _ => println!("invalid PESEL provided"),
}

// alternatively, pass a string literal:

let result = PESEL::from_str("44051401458");
match result {
    OK(pesel) => println!("PESEL: {}", pesel),
    _ => println!("invalid PESEL string"),
}

b) generating PESEL number, based on date of birth of a person and their biological gender


let result = PESEL::new(1980, 05, 26, PeselGender::Male);
match result {
    Ok(pesel) => println!("generated PESEL: {}", pesel),
    _ => println!("unable to create PESEL for specified date"),
}

Note: behavior of this method changed. It used to return PESEL, now returns Result<PESEL, PeselParsingError>. Errors are usually due to:

  • provided date of birth being out of range for PESEL (earlier than 1800, later than 2299)
  • provided date of birth is not valid i.e.: 30th of February, 31st of April...

Please note that after PESEL number structure is constructed there is no way to change it - it stays immutable forever.

TODO

  • validate date before PESEL is created to avoid creation of PESEL for invalid date (31st of February, 31st of April, 31st of June...)
  • validate PESEL numbers in bulk (ideally: reading from file)

Dependencies

~1.5MB
~28K SLoC