easy-upnp 0.3.1

Easily open and close UPnP ports.
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

# easy-upnp

[![badge github]][url github]
[![badge crates.io]][url crates.io]
[![badge docs.rs]][url docs.rs]
[![badge license]][url license]

[//]: # (@formatter:off)
[badge github]: https://img.shields.io/badge/github-FloGa%2Fupnp--daemon-green
[badge crates.io]: https://img.shields.io/crates/v/easy-upnp
[badge docs.rs]: https://img.shields.io/docsrs/easy-upnp
[badge license]: https://img.shields.io/crates/l/easy-upnp

[url github]: https://github.com/FloGa/upnp-daemon/crates/easy-upnp
[url crates.io]: https://crates.io/crates/easy-upnp
[url docs.rs]: https://docs.rs/easy-upnp
[url license]: https://github.com/FloGa/upnp-daemon/blob/develop/crates/easy-upnp/LICENSE
[//]: # (@formatter:on)

Easily open and close UPnP ports.

A minimalistic wrapper around [IGD] to open and close network ports via
[UPnP]. Mainly this library is used in the CLI application [`upnp-daemon`],
but it can also be used as a library in other crates that just want to open
and close ports with minimal possible configuration.

[IGD]: https://docs.rs/igd/

[UPnP]: https://en.wikipedia.org/wiki/Universal_Plug_and_Play

[`upnp-daemon`]: https://github.com/FloGa/upnp-daemon

## Example

Here is a hands-on example to demonstrate the usage. It will add some ports
and immediately remove them again.

```rust no_run
use std::error::Error;
use std::str::FromStr;
use log::error;
use easy_upnp::{add_ports, delete_ports, Ipv4Cidr, PortMappingProtocol, UpnpConfig};

fn get_configs() -> Result<[UpnpConfig; 3], Box<dyn Error>> {
    let config_no_address = UpnpConfig {
        address: None,
        port: 80,
        protocol: PortMappingProtocol::TCP,
        duration: 3600,
        comment: "Webserver".to_string(),
    };

    let config_specific_address = UpnpConfig {
        address: Some(Ipv4Cidr::from_str("192.168.0.10")?),
        port: 8080,
        protocol: PortMappingProtocol::TCP,
        duration: 3600,
        comment: "Webserver alternative".to_string(),
    };

    let config_address_range = UpnpConfig {
        address: Some(Ipv4Cidr::from_str("192.168.0.0/24")?),
        port: 8081,
        protocol: PortMappingProtocol::TCP,
        duration: 3600,
        comment: "Webserver second alternative".to_string(),
    };

    Ok([
        config_no_address,
        config_specific_address,
        config_address_range,
    ])
}

fn main() -> Result<(), Box<dyn Error>> {
    for result in add_ports(get_configs()?) {
        if let Err(err) = result {
            error!("{}", err);
        }
    }

    for result in delete_ports(get_configs()?) {
        if let Err(err) = result {
            error!("{}", err);
        }
    }

    Ok(())
}
```