use socrates_rs;

socrates_rs::validate_id("14349483 0 ZV3", socrates::country::Code::PT);

let citizen = socrates_rs::extract_information("2820819398814 09", socrates::country::Code::FR).unwrap();
assert_eq!(citizen.gender, 'F');
assert_eq!(citizen.year_of_birth, 1982);
assert_eq!(citizen.month_of_birth.unwrap(), 8);
assert_eq!(citizen.place_of_birth.unwrap(), "Corrèze");

Introduction

This rust crate is a port of the php package socrates.

socrates-rs allows you to validate and retrieve personal data from National Identification Numbers across the world with the goal of eventually supporting as many countries in the world as possible.

Some countries also encode personal information of the citizen, such as gender or the place of birth. This package allows you to extract that information in a consistent way.

This crate can be useful for many things, such as validating a user's ID for finance related applications or verifying a user's age without asking for it explicitly. However, we recommend you review your country's data protection laws before storing any information.

Usage

Currently, due to a dependency on assoc_char_funcs, this crate requires rust nightly to run.

Two functions are available with socrates-rs:

• validate_id which returns a boolean indicating if an id is valid in a specific country
• extract_information which returns an Optional Citizen with information retrievable from the identifier (gender, date of birth, ...)

The list of supported countries is available via the Country::code enum.

Contributing

Did you find a problem in any of the algorithms? Do you know how to implement a country which we have missed? Are there any improvements that you think should be made to the codebase? Any help is appreciated! Take a look at our contributing guidelines.

License

The MIT License (MIT). Please see License File for more information.