simple-useragent 0.1.4

A simple user agent parser library based on the uap-core regexes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# Simple UserAgent parser

A simple user agent parser library based on the uap-core regexes.

## Installation

Add the library to your project:

```sh
cargo add simple-useragent@0.1.4
```

Install the command-line tool:

```sh
cargo install simple-useragent --version 0.1.4
```

## Example

A simple example that parses a user agent string and reads the parsed fields:

```rust
// Create a user agent parser
let parser = simple_useragent::UserAgentParser::new();

// Parse a user agent string
let ua = parser.parse(
    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:134.0) Gecko/20100101 Firefox/134.0",
);

// Print the parsed user agent fields
println!("Client family: {}", ua.client.family); // -> "Firefox"
println!("Client version: {:?}", ua.client.version); // -> Some("134.0")
println!("OS family: {}", ua.os.family); // -> "Mac OS X"
println!("OS version: {:?}", ua.os.version); // -> Some("10.15")
```

## Command line

Inspect one or more quoted user-agent strings with the installed tool:

```sh
simple-useragent 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:134.0) Gecko/20100101 Firefox/134.0'
```

Or run it from this repository:

```sh
cargo run -p simple-useragent --bin simple-useragent -- 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:134.0) Gecko/20100101 Firefox/134.0'
```

## Features

- **serde**: Enable serialization and deserialization derives of the structs with [serde](https://serde.rs/).

## Documentation

See the [documentation](https://docs.rs/simple-useragent) for more information.

## License

Copyright © 2024-2026 [Bastiaan van der Plaat](https://github.com/bplaat)

Licensed under the [MIT](LICENSE) license.