bank-barcode 0.2.0

Generate Finnish virtual bank barcodes
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

# bank-barcode

Generate Finnish virtual bank barcodes (*pankkiviivakoodi*) in Rust.

This crate produces the digit string for both version 4 and version 5 of the
Finnish virtual bank barcode as defined in the
[Finanssiala specification][spec]. Bank barcodes may only be printed for IBAN
accounts in the `FI` country.

[spec]: https://www.finanssiala.fi/wp-content/uploads/2021/03/Pankkiviivakoodi-opas.pdf

## Usage

Add the crate to your `Cargo.toml`:

```toml
[dependencies]
bank-barcode = "0.2"
```

Then build a barcode through `BarcodeBuilder` and format it via its
`Display` implementation:

```rust
let barcode = bank_barcode::Barcode::builder()
    .version(bank_barcode::BarcodeVersion::V4)
    .account_number("FI16 8000 1400 0502 67")
    .reference(12345)
    .calendar_due_date(2025, 2, 26)
    .euros(123)
    .cents(45)
    .build()
    .expect("Builder failed");

println!("{barcode}");
```

A runnable end-to-end example lives in [`examples/basic.rs`](examples/basic.rs)
and can be invoked with:

```sh
cargo run --example basic
```

## Minimum supported Rust version

`bank-barcode` builds on Rust **1.88** and later.

## License

Licensed under the [MIT License](LICENSE).