cusip
====
An `CUSIP` type for working with validated Committee on Uniform Security Identification Procedures (CUSIP) identifiers
as defined in [ANSI X9.6-2020](https://webstore.ansi.org/standards/ascx9/ansix92020). There is also a companion type
`CINS` for working with the subset of CUSIP identifiers that conform to the CINS standard.

This crate is part of the Financial Identifiers series:

* [CIK](https://crates.io/crates/cik): Central Index Key (SEC EDGAR)
* [CUSIP](https://crates.io/crates/cusip): Committee on Uniform Security Identification Procedures (ANSI X9.6-2020)
* [ISIN](https://crates.io/crates/isin): International Securities Identification Number (ISO 6166:2021)
* [LEI](https://crates.io/crates/lei): Legal Entity Identifier (ISO 17442:2020)

## Usage

Add this to your `Cargo.toml`:

```toml
[dependencies]
cusip = "0.2"
```


## Example

```rust
use cusip;
let cusip_string = "023135106"; // Amazon.com Inc - Common Stock
match cusip::parse(cusip_string) {
    Ok(cusip) => {
        println!("Parsed CUSIP: {}", cusip.to_string()); // "023135106"
        println!("  Issuer number: {}", cusip.issuer_num()); // "023135"
        println!("  Issue number: {}", cusip.issue_num()); // "10"
        println!("  Check digit: {}", cusip.check_digit()); // '6'
    }
    Err(err) => panic!("Unable to parse CUSIP {}: {}", cusip_string, err),
}
```


## License

Licensed under either of

 * Apache License, Version 2.0
   ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license
   ([LICENSE-MIT](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.