libsip 0.2.6

SIP protocol Implementation, with a focus towords softphone clients.
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
94
95

/// Generate a URI domain from an domain name.
/// ```rust
/// # #[macro_use]
/// # extern crate libsip;
/// # fn main() {
/// let domain = domain!("example.com");
/// let domain = domain!("example.com", 5060);
/// # }
/// ```
#[macro_export]
macro_rules! domain {
    ($domain:tt) => {
        libsip::Domain::Domain($domain.into(), None)
    };
    ($domain:tt, $port:tt) => {
        libsip::Domain::Domain($domain.into(), Some($port))
    };
}

/// Generate a URI domain from an ip address.
/// ```rust
/// # #[macro_use]
/// # extern crate libsip;
/// # fn main() {
/// let domain = ip_domain!(192, 168, 0, 1);
/// let domain = ip_domain!(192, 168, 0, 1, 5060);
/// # }
/// ```
#[macro_export]
macro_rules! ip_domain {
    ($a:tt, $b:tt, $c:tt, $d:tt) => {
        libsip::Domain::Ipv4(::std::net::Ipv4Addr::new($a, $b, $c, $d), None)
    };

    ($a:tt, $b:tt, $c:tt, $d:tt, $port:tt) => {
        libsip::Domain::Ipv4(::std::net::Ipv4Addr::new($a, $b, $c, $d), Some($port))
    };
}

/// Generate a URI authentication from credentials.
/// ```rust
/// # #[macro_use]
/// # extern crate libsip;
/// # fn main() {
/// let auth = uri_auth!("user");
/// let auth = uri_auth!("user", "pass");
/// # }
/// ```
#[macro_export]
macro_rules! uri_auth {
    ($u:tt) => {
        libsip::UriAuth::new($u)
    };
    ($u:tt, $p:tt) => {
        libsip::UriAuth::new($u).password($p)
    };
}

/// Generate `NamedHeader` from a uri;
/// ```rust
/// # #[macro_use]
/// # extern crate libsip;
/// # fn main() {
/// let uri = libsip::Uri::sip(domain!("example.com"));
/// let domain = named_header!(uri);
/// # }
/// ```
#[macro_export]
macro_rules! named_header {
    ($u:tt) => {
        libsip::NamedHeader {
            display_name: None,
            uri: $u,
            parameters: ::std::collections::HashMap::new(),
        }
    };
    ($u:tt, $name:tt) => {
        libsip::NamedHeader {
            display_name: Some($name.into()),
            uri: $u,
            parameters: ::std::collections::HashMap::new(),
        }
    };
}

/// Same as `named_header` except for internal use.
macro_rules! __named_header {
    ($u:tt) => {
        crate::NamedHeader {
            display_name: None,
            uri: $u,
            parameters: ::std::collections::HashMap::new(),
        }
    };
}