| Crates.io | ip-check |
| lib.rs | ip-check |
| version | 0.1.6 |
| created_at | 2024-09-26 17:26:53.724743+00 |
| updated_at | 2026-01-12 20:30:34.339187+00 |
| description | Check in what country an IP address is located |
| homepage | |
| repository | |
| max_upload_size | |
| id | 1387855 |
| size | 15,388 |
This crate exposes a struct called Looker that you need to instantiate like this:
use ip_check::{Looker, IpLookup};
let file_path = PathBuf::from_str("locationv4.csv").expect("Path not correct");
let looker = Looker::new(file_path);
You can then use the looker variable to call the look_up method like this to get a IP result with Country, Region and City:
let ip = Ipv4Addr::new(12, 22, 104, 13);
let result = looker.look_up_ipv4(ip);
match result {
Some(ip_range) => {
println!("Country: {}", ip_range.country);
println!("Region: {}", ip_range.region);
println!("City: {}", ip_range.city);
},
None => {
println!("No match found");
}
}
Or if you only have a string as an IP:
let ip = "12.22.104.13";
let result = looker.look_up(ip);
match result {
Some(ip_range) => {
println!("Country: {}", ip_range.country);
println!("Region: {}", ip_range.region);
println!("City: {}", ip_range.city);
},
None => {
println!("No match found");
}
}
llows you to filter on countries when building the Looker. Useful if you only care about a few countries to reduce memory usage:
let file_path = PathBuf::from_str("locationv4.csv").expect("Path not correct");
let allowed_countries = vec!["Sweden".to_string(), "Norway".to_string()]; // Note they must match the country names in the csv file
let looker = Looker::builder()
.file_path(file_path)
.allowed_countries(allowed_countries)
.build()
.expect("Failed to build Looker");
let ip = "12.22.104.13";
let result = looker.look_up(ip);
match result {
Some(ip_range) => {
println!("Country: {}", ip_range.country);
println!("Region: {}", ip_range.region);
println!("City: {}", ip_range.city);
},
None => {
println!("No match found");
}
}
You can download the ip .csv file from here: https://cable.ayra.ch/ip/data/locationv4.gz
And then unzip it with:
gzip -d locationv4.gz
The file needs to have the .csv extension. If it doesn't have it after you unzip it, add it.
0.1.5 - Breaking change: Needs a PathBuf instead of a string to load the csv. New function called look_up_ipv4 that takes an Ipv4Addr instead of a string.