Parse User-Agent request header strings.
Parsers are derived from regular expressions published in the ua-parser/ua-core repository. The regular expressions are fetched in a custom build step, then used to generate static Rust code that is compiled into the lib.
There is a one-off initialisation cost
to load the parser objects at runtime,
which is paid when you call
the init function.
If init is not called explicitly,
initialisation occurs lazily instead
and parsing will block
until it finishes.
Add it to your dependencies
in Cargo.toml:
toml
[dependencies]
fast_uaparser = "1"
For more detailed information see the API docs, but the general gist is as follows:
```rust use fast_uaparser::{Device, OperatingSystem, UserAgent};
// Pay initialisation costs up-front fast_uaparser::init().unwrap();
// Parse user-agent information let ua: UserAgent = "Mozilla/5.0 (X11; Linux i686; rv:70.0) Gecko/20100101 Firefox/70.0" .parse() .unwrap();
asserteq!(ua.family, "Firefox"); asserteq!(ua.version.major.unwrap(), "70"); asserteq!(ua.version.minor.unwrap(), "0"); assert!(ua.version.patch.isnone()); assert!(ua.version.patchminor.isnone());
// Parse OS information let os: OperatingSystem = "Mozilla/5.0 (iPad; CPU OS 12_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1 Mobile/15E148 Safari/604.1" .parse() .unwrap();
asserteq!(os.family, "iOS"); asserteq!(os.version.major.unwrap(), "12"); asserteq!(os.version.minor.unwrap(), "2"); assert!(os.version.patch.isnone()); assert!(os.version.patchminor.isnone());
// Parse device information let device: Device = "Mozilla/5.0 (Windows Mobile 10; Android 8.0.0; Microsoft; Lumia 950XL) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.89 Mobile Safari/537.36 Edge/40.15254.369" .parse() .unwrap();
asserteq!(device.family, "Lumia 950XL"); asserteq!(device.brand.unwrap(), "Nokia"); assert_eq!(device.model.unwrap(), "Lumia 950XL"); ```
f you don't already have Rust installed,
get that first using rustup:
curl https://sh.rustup.rs -sSf | sh
Then you can build the project:
cargo b
And run the tests:
cargo t
Here.