ein 0.3.0

U.S. Employer Identification Number (EIN) parsing and validation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# ein

U.S. Employer Identification Number (EIN) parsing and validation for Rust.

[![Crates.io](https://img.shields.io/crates/v/ein.svg)](https://crates.io/crates/ein)
[![Documentation](https://docs.rs/ein/badge.svg)](https://docs.rs/ein)
[![CI](https://github.com/gideonsolutions/ein/actions/workflows/ci.yml/badge.svg)](https://github.com/gideonsolutions/ein/actions/workflows/ci.yml)

## Usage

```rust
use ein::Ein;

// Parse from string with dash
let ein: Ein = "12-3456789".parse().unwrap();
assert_eq!(ein.to_string(), "12-3456789");

// Parse from string without dash
let ein: Ein = "123456789".parse().unwrap();
assert_eq!(ein.to_string(), "12-3456789");

// Access components
assert_eq!(ein.prefix(), 12);
assert_eq!(ein.serial(), 3_456_789);

// Create from components
let ein = Ein::new(12, 3_456_789).unwrap();
```

## Validation

Validates that the 2-digit prefix is an IRS-assigned prefix. The following prefixes are **invalid** (never assigned by the IRS):

`00`, `07`, `08`, `09`, `17`, `18`, `19`, `28`, `29`, `49`, `69`, `70`, `78`, `79`, `89`, `96`, `97`

```rust
use ein::{Ein, ParseError};

// Invalid prefix
assert!(matches!(
    "00-1234567".parse::<Ein>(),
    Err(ParseError::InvalidPrefix(0))
));

// Invalid format
assert!(matches!(
    "12+3456789".parse::<Ein>(),
    Err(ParseError::InvalidFormat(_))
));
```

## Privacy

The `Debug` implementation masks the serial number, showing only the prefix:

```rust
let ein: Ein = "12-3456789".parse().unwrap();
assert_eq!(format!("{:?}", ein), "Ein(12-XXXXXXX)");
```

## License

Apache-2.0