MAC Address lookup tool
=========================
[![Linux Arm7](https://github.com/marirs/mac-oui/actions/workflows/linux_arm.yml/badge.svg)](https://github.com/marirs/mac-oui/actions/workflows/linux_arm.yml)
[![Linux x86_64](https://github.com/marirs/mac-oui/actions/workflows/linux_x86_64.yml/badge.svg)](https://github.com/marirs/mac-oui/actions/workflows/linux_x86_64.yml)
[![macOS](https://github.com/marirs/mac-oui/actions/workflows/macos.yml/badge.svg)](https://github.com/marirs/mac-oui/actions/workflows/macos.yml)
[![Windows](https://github.com/marirs/mac-oui/actions/workflows/windows.yml/badge.svg)](https://github.com/marirs/mac-oui/actions/workflows/windows.yml)
![Crates.io](https://img.shields.io/crates/v/mac_oui)
[![Documentation](https://docs.rs/mac_oui/badge.svg)](https://docs.rs/mac_oui)

Lookup the MAC Address for a corresponding details (eg: org, created, etc...)

## Requirements

- Rust 1.70+ (edition 2021)

## Compile
- Dev
```bash
cargo b
```
- Release
```bash 
cargo b --release
```

## Usage

You can include this in your Cargo.toml file:
```toml
[dependencies]
mac_oui = "0.4.10"
```

If you want to use it with the inbuilt oui db; then:
```toml
[dependencies]
mac_oui = { version = "0.4.10", features = ["with-db"] }
```

and then

```rust
use mac_oui::Oui;

fn main () {
    let oui_db = Oui::default();
    assert!(oui_db.is_ok());
}
```

## Running the Example
You can run the default example that is included in the following manner.
- `cargo run --example mac_lookup <mac address>` eg:
```bash
cargo run --features="with-db" --example mac_lookup '70:B3:D5:e7:4f:81'
    Finished dev [optimized + debuginfo] target(s) in 1.54s
     Running `target/debug/examples/mac_lookup '70:B3:D5:e7:4f:81'`
Entry {
    oui: "70:B3:D5",
    is_private: false,
    company_name: "Ieee Registration Authority",
    company_address: "445 Hoes Lane Piscataway NJ 08554 US",
    country_code: "US",
    assignment_block_size: "MA-L",
    date_created: "2014-01-12",
    date_updated: "2016-04-27",
}
```
- Example of lookup by Manufacturer
```bash
$ cargo run --features="with-db" --example manufacturer_lookup "Apple, Inc"
    Finished dev [optimized + debuginfo] target(s) in 0.02s
     Running `target/debug/examples/manufacturer_lookup 'Apple, Inc'`
[
    Entry {
        oui: "...",
        is_private: false,
        company_name: "Apple, Inc",
        company_address: "1 Infinite Loop Cupertino CA 95014 US",
        country_code: "US",
        assignment_block_size: "MA-L",
        date_created: "2017-02-21",
        date_updated: "2017-02-21",
    },
    <clip>....
]
```

- Example Getting a list of Manufacturers
```bash
$ cargo run --features="with-db" --example db_stats
    Finished dev [optimized + debuginfo] target(s) in 0.06s
     Running `target/debug/examples/db_stats`
Total Records= 51615
Total Manufacturers= 30840
Total MAC Addrs= 51615

====Manufacturers====
[
    "\"Azimut\" Production Association Jsc",
    "\"Continent\" Co Ltd",
    "\"Meta-chrom\" Co Ltd",
    "\"Rpc \"Energoautomatika\" Ltd",
    "(UN)Manned",
    "+plugg srl",
    "01db-Metravib",
    "1.A Connect GmbH",
    "1000eyes GmbH",
    "100fio networks Tech Llc",
    "10net Communications/Dca",
    "11811347 Canada Inc",
    "11wave Technonlogy Co, Ltd",
    "12Sided Tech, Llc",
    "1394 Printer Working Group",
    "1394 Trade Association",
    "16063",
    "1Net Corp",
    "1Verge Internet Tech (Beijing) Co, Ltd",
    "1more",
]
...
[
    "杭州德澜科技有限公司（HangZhou Delan Tech Co, Ltd）",
    "\u{200b}Asung Techno Co, Ltd",
    "éolane",
    "Östling Marking Systems GmbH",
    "Öresundskraft AB",
    "Åmic AB",
    "µTech Tecnologia Ltda",
    "«Intellect module» Llc",
    "zxsolution",
    "zte Corp",
    "zhejiang yuanwang communication technolgy Co, Ltd",
    "zhejiang ebang communication Co, Ltd",
    "zhejiang Dusun Electron Co, Ltd",
    "zhejiang Anhong Tech Co, Ltd",
    "z-max mediasolution",
    "yLez Tech Pte Ltd",
    "xxter b.v.",
    "xvtec Ltd",
    "xn systems",
    "xmi systems",
]
```
---