gopher 0.0.3

Gopher protocol implementation
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

use std::io::IoResult;
use std::io::net::tcp::TcpStream;

use protocol::{DirEntity, Parser};

/// A client which knows the host and port of a Gopher server.  Due to the
/// ephemeral nature of the Gopher protocol, each operation on a Gopher creates
/// a connection to the server and disconnects after running.
pub struct Gopher {
    host: String,
    port: u16
}

impl Gopher {
    /// Constructs a new Gopher given some server's address.
    pub fn new(host: &str, port: u16) -> Gopher {
        Gopher {
            host: host.into_string(),
            port: port
        }
    }

    /// List all entries at the root of the server.
    pub fn root(&self) -> IoResult<Vec<DirEntity>> {
        self.fetch_dir(&[])
    }

    /// Given a selector, fetches a directory listing
    pub fn fetch_dir(&self, selector: &[u8]) -> IoResult<Vec<DirEntity>> {
        use std::io::BufferedReader;

        let mut stream = try!(self.connect());
        try!(stream.write(selector));
        try!(stream.write(b"\r\n"));
        let mut parser = try!(Parser::new(BufferedReader::new(stream)));
        parser.parse_menu()
    }

    fn connect(&self) -> IoResult<TcpStream> {
        TcpStream::connect((self.host.as_slice(), self.port))
    }
}