30 stable releases
1.6.0 | Dec 18, 2023 |
---|---|
1.5.2 | Sep 11, 2023 |
1.5.1 | Nov 4, 2022 |
1.5.0 | Mar 18, 2022 |
1.1.4 | Nov 14, 2018 |
#292 in Network programming
705 downloads per month
Used in 4 crates
29KB
579 lines
WHOIS Rust
This is a WHOIS client library for Rust, inspired by https://github.com/hjr265/node-whois
Usage
You can make a servers.json file or copy one from https://github.com/hjr265/node-whois
This is a simple example of servers.json.
{
"org": "whois.pir.org",
"": "whois.ripe.net",
"_": {
"ip": {
"host": "whois.arin.net",
"query": "n + $addr\r\n"
}
}
}
Then, use the from_path
(or from_string
if your JSON data is in-memory) associated function to create a WhoIs
instance.
use whois_rust::WhoIs;
let whois = WhoIs::from_path("/path/to/servers.json").unwrap();
Use the lookup
method and input a WhoIsLookupOptions
instance to lookup a domain or an IP.
use whois_rust::{WhoIs, WhoIsLookupOptions};
let whois = WhoIs::from_path("/path/to/servers.json").unwrap();
let result: String = whois.lookup(WhoIsLookupOptions::from_string("magiclen.org").unwrap()).unwrap();
Asynchronous APIs
You may want to use async APIs with your async runtime. This crate supports tokio
, currently.
[dependencies.whois-rust]
version = "*"
features = ["tokio"]
After enabling the async feature, the from_path_async
function and the lookup_async
function are available.
Testing
# git clone --recurse-submodules git://github.com/magiclen/whois-rust.git
git clone git://github.com/magiclen/whois-rust.git
cd whois-rust
git submodule init
git submodule update --recursive
cargo test
Crates.io
https://crates.io/crates/whois-rust
Documentation
License
Dependencies
~10–21MB
~286K SLoC