har 0.9.0

A HTTP Archive format (HAR) serialization & deserialization library.
Documentation 
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

har-rs
======

[HTTP Archive format (HAR)][har] serialization & deserialization library, written in Rust.

[![CI](https://github.com/mandrean/har-rs/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/mandrean/har-rs/actions/workflows/ci.yml)
[![Latest version](https://img.shields.io/crates/v/har.svg)](https://crates.io/crates/har)
[![Documentation](https://docs.rs/har/badge.svg)](https://docs.rs/har)
[![License](https://img.shields.io/crates/l/har.svg)](https://github.com/mandrean/har-rs/blob/master/LICENSE)

Install
-------

JSON-only use (default):

```toml
[dependencies]
har = "0.9"
```

Enable YAML serialization:

```toml
[dependencies]
har = { version = "0.9", features = ["yaml"] }
```

Use
---

HAR input is always parsed from JSON.
JSON serialization is available by default.
YAML serialization through `to_yaml` is available only when the `yaml` feature is enabled.

```rust
use har::{from_str, to_json, HarVersion};

fn main() -> Result<(), har::Error> {
    let input = r#"{
        "log": {
            "version": "1.2",
            "creator": { "name": "example", "version": "1.0" },
            "entries": []
        }
    }"#;

    let har = from_str(input)?;
    assert_eq!(har.version(), HarVersion::V1_2);

    println!("{}", to_json(&har)?);
    Ok(())
}
```

With the `yaml` feature enabled, you can also serialize parsed HAR documents as YAML:

```rust
use har::{from_str, to_yaml};

fn main() -> Result<(), har::Error> {
    let input = r#"{
        "log": {
            "version": "1.2",
            "creator": { "name": "example", "version": "1.0" },
            "entries": []
        }
    }"#;

    let har = from_str(input)?;
    println!("{}", to_yaml(&har)?);
    Ok(())
}
```

See [docs.rs/har] for the full library API documentation.

Contribute
----------

This project follows [semver] and [conventional commits]. CI runs on GitHub Actions, and releases are prepared and published with [release-plz] on `master`.

See [CHANGELOG.md](CHANGELOG.md) for release history.

Note
----

Inspired by [softprops/openapi](https://github.com/softprops/openapi).

[conventional commits]: https://www.conventionalcommits.org
[docs.rs/har]: https://docs.rs/har
[har]: https://en.wikipedia.org/wiki/HTTP_Archive
[release-plz]: https://release-plz.dev
[semver]: https://semver.org/