eveng 0.1.1

An API Client for EVE-NG
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

# eveng.rs

[![ci](https://github.com/orgnizedmess/eveng.rs/workflows/CI/badge.svg)](https://github.com/orgnizedmess/eveng.rs/actions)
[![crates.io](https://img.shields.io/crates/v/eveng.svg)](https://crates.io/crates/eveng)
[![docs.rs](https://docs.rs/eveng/badge.svg)](https://docs.rs/eveng)

This is an API client for [EVE-NG]. It implements endpoints documented as part of its [REST API], as well as some undocumented endpoints found from interaction with the EVE-NG GUI.

Tested on the Community Edition Version 6.2.0-4.

## Example

```rust,no_run
use eveng::Client;
use eveng::labs::AddLabRequest;
use eveng::networks::AddNetworkRequest;
use eveng::nodes::AddNodeRequest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::login("http://localhost", "username", "password").await?;
    let root = client.folder("/")?;

    let lab = root.labs().add(AddLabRequest::new("Test")?).await?;

    let tmpl = client.system().node_template("vios").get().await?;

    let vios1 = lab
        .nodes()
        .add(
            AddNodeRequest::qemu(&tmpl)?
                .name("vios1")
                .position(100, 200)
                .ethernet(2),
        )
        .await?;

    let vios2 = lab
        .nodes()
        .add(
            AddNodeRequest::qemu(&tmpl)?
                .name("vios2")
                .position(200, 200)
                .ethernet(2),
        )
        .await?;

    vios1
        .ethernet(0)
        .connect_to_node(&vios2.ethernet(0))
        .await?;

    let cloud = lab.networks().add(AddNetworkRequest::new("pnet0")).await?;

    vios1.ethernet(1).connect_to_network(&cloud).await?;
    vios2.ethernet(1).connect_to_network(&cloud).await?;

    lab.nodes().start().await?;
    client.logout().await?;

    Ok(())
}
```

[EVE-NG]: https://eve-ng.net
[REST API]: https://www.eve-ng.net/index.php/how-to-eve-ng-api/