ISIN is both an executable binary that can be run, and a library that can be used in Rust programs.

Installing the `isin-tool` executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install isin

It will make the isin-tool command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall isin uninstalls.

Adding `isin` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add isin

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

isin = "0.1.19"

The isin library will be automatically available globally. Read the isin library documentation.

Back to the crate overview.

Readme

isin

An ISIN type for working with validated International Security Identifiers (ISINs) as defined in ISO 6166.

The checksum calculation uses a table-driven algorithm to minimize overhead vs. a direct translation of the formula definition.

This crate is part of the Financial Identifiers series:

CIK: Central Index Key (SEC EDGAR)
CUSIP: Committee on Uniform Security Identification Procedures (ANSI X9.6-2020)
ISIN: International Securities Identification Number (ISO 6166:2021)
LEI: Legal Entity Identifier (ISO 17442:2020)

Usage

Add this to your Cargo.toml:

[dependencies]
isin = "0.1"

Example

use isin;
let isin_string = "US0378331005";
match isin::parse(isin_string) {
    Ok(isin) => {
        println!("Parsed ISIN: {}", isin.to_string()); // "US0378331005"
        println!("  Prefix: {}", isin.prefix()); // "US"
        println!("  Basic code: {}", isin.basic_code()); // "037833100"
        println!("  Check digit: {}", isin.check_digit()); // '5'
    }
    Err(err) => panic!("Unable to parse ISIN {}: {}", isin_string, err),
}

License

Licensed under either of

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Installing the isin-tool executable

Adding isin library as a dependency

Installing the `isin-tool` executable

Adding `isin` library as a dependency