jelovirt/hetu

Finnish SSN validator in Rust

HETU validator and generator in Rust

Simple crate for validating and generating Finnish Personal Identity Code (HETU).

Supports the 1.1.2023 format.

Works with rust 1.8 stable.

Usage

Add this to your Cargo.toml

[dependencies.hetu]
git = "https://github.com/jelovirt/hetu.git"

To validate:

extern crate hetu;
use hetu::Ssn;

pub fn main() {
  if Ssn::parse("121212-121D").is_ok() {
    println!("Valid HETU")
  } else {
    println!("Invalid")
  }
}

To generate:

extern crate hetu;
use hetu::Ssn;

pub fn main() {
  println!("{}", Ssn::generate());
}

To generate by pattern:

extern crate hetu;
use hetu::Ssn;
use hetu::SsnPattern;

pub fn main() {
  let pattern = SsnPattern::parse("111111-111?").unwrap();
  println!("{}", Ssn::generate_by_pattern(pattern).unwrap());
}

CLI

Command line tool hetu can be used to either validate or randomly generate identifiers.

To validate:

$ hetu 121212-121D
$ echo 121212-121D | hetu -
$ hetu 121212-121C
Error: Invalid checksum: expected D
  
  121212-121C
            ^

To generate:

$ hetu
121212-121D

To generate by pattern that can contain wildcards:

$ hetu -p "121212-121?"
121212-121D
$ hetu -p "121212-???D"
121212-028D
$ hetu -p "??????-???D"
241151-028D