buffoon 0.5.0

Simple Protocol Buffers implementation
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use std::io;
use std::borrow::Borrow;
use wire_type::WireType;
use wire_type::WireType::*;
use {Message};

pub trait OutputStream : OutputStreamBackend {
    /// Writes a nested message with the specified field number
    fn write_message_field<M: Message>(&mut self, field: usize, msg: &M) -> io::Result<()>;

    fn write_repeated_message_field<'a, M:'a + Message, I: Iterator<Item=&'a M>>(&mut self, field: usize, msgs: I) -> io::Result<()> {
        for msg in msgs {
            try!(self.write_message_field(field, msg));
        }

        Ok(())
    }

    fn write_varint_field<F: NumField>(&mut self, field: usize, val: F) -> io::Result<()> {
        val.write_varint_field(field, self)
    }

    fn write_byte_field(&mut self, field: usize, val: &[u8]) -> io::Result<()> {
        try!(self.write_head(field, LengthDelimited));
        try!(self.write_usize(val.len()));
        try!(self.write_bytes(val));
        Ok(())
    }

    fn write_repeated_byte_field<'a, I: Iterator<Item=&'a [u8]>>(&mut self, field: usize, vals: I) -> io::Result<()> {
        for val in vals {
            try!(self.write_byte_field(field, val));
        }

        Ok(())
    }

    fn write_str_field(&mut self, field: usize, val: &str) -> io::Result<()> {
        self.write_byte_field(field, val.as_bytes())
    }

    fn write_opt_str_field<S: Borrow<str>>(&mut self, field: usize, val: Option<S>) -> io::Result<()> {
        match val {
            Some(s) => try!(self.write_str_field(field, s.borrow())),
            None => {}
        }

        Ok(())
    }

    fn write_repeated_str_field<'a, I: Iterator<Item=&'a str>>(&mut self, field: usize, vals: I) -> io::Result<()> {
        self.write_repeated_byte_field(field, vals.map(|s| s.as_bytes()))
    }
}

pub trait OutputStreamBackend : Sized {
    fn write_bytes(&mut self, bytes: &[u8]) -> io::Result<()>;

    // Write a single byte
    fn write_byte(&mut self, byte: u8) -> io::Result<()> {
        let buf = [byte];
        self.write_bytes(&buf)
    }

    fn write_usize(&mut self, val: usize) -> io::Result<()> {
        self.write_unsigned_varint(val as u64)
    }

    fn write_unsigned_varint(&mut self, mut val: u64) -> io::Result<()> {
        loop {
            // Grab up to 7 bits of the number
            let bits = (val & 0x7f) as u8;

            // Shift the remaining bits
            val >>= 7;

            if val == 0 {
                try!(self.write_byte(bits));
                return Ok(());
            }

            try!(self.write_byte(bits | 0x80));
        }
    }

    fn write_head(&mut self, field: usize, wire_type: WireType) -> io::Result<()> {
        // TODO: Handle overflow
        let bits = (field << 3) | (wire_type as usize);
        try!(self.write_usize(bits));
        Ok(())
    }
}

pub trait NumField {
    fn write_varint_field<O: OutputStream>(self, field: usize, out: &mut O) -> io::Result<()>;
}

impl NumField for usize {
    fn write_varint_field<O: OutputStream>(self, field: usize, out: &mut O) -> io::Result<()> {
        try!(out.write_head(field, Varint));
        try!(out.write_usize(self));
        Ok(())
    }
}

impl NumField for u64 {
    fn write_varint_field<O: OutputStream>(self, field: usize, out: &mut O) -> io::Result<()> {
        try!(out.write_head(field, Varint));
        try!(out.write_unsigned_varint(self));
        Ok(())
    }
}

impl<F: NumField> NumField for Option<F> {
    fn write_varint_field<O: OutputStream>(self, field: usize, out: &mut O) -> io::Result<()> {
        match self {
            Some(v) => v.write_varint_field(field, out),
            None => Ok(())
        }
    }
}