porthole 0.1.0

Resolves open network 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

#![deny(missing_docs)]

//! Porthole resolves open network ports so you don't have to.
//!
//! # examples
//!
//! ```
//! println!("next available port is {}", porthole::open().unwrap())
//! ```

use std::net::TcpListener;
use std::io::Result;
use std::iter::Iterator;

/// Returns the next available network port
/// on the current host
pub fn open() -> Result<u16> {
  TcpListener::bind("0.0.0.0:0")
    .and_then(|l| {
      let addr = l.local_addr();
      drop(l);
      addr
     })
    .and_then(|a| Ok(a.port()))
}

/// An iterator over open ports
pub struct Iter;

impl Iterator for Iter {
  type Item = u16;
  fn next(&mut self) -> Option<u16> {
    ::open().ok()
  }
}

/// produces an Iter instance to iterate over open ports
pub fn iter() -> Iter {
  Iter
}


#[test]
fn resolves_open_ports() {
  assert_eq!(open().is_ok(), true)
}

#[test]
fn provides_iter_over_open_ports() {
  assert_eq!(iter().take(5).count(), 5)
}