vndb 0.16.1

Kawaii VNDB API
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

//!Simple client implementation of VNDB client, based on std's sockets

use std::{io, net};
use std::io::{Read, Write, BufRead, BufReader};

use super::{API_HOST, API_PORT};

///Simple synchronous Client implementation
pub struct Client<IO> where IO: Read {
    io: BufReader<IO>,
    read_buf: Vec<u8>,
}

impl Client<net::TcpStream> {
    fn socket_connect() -> io::Result<net::TcpStream> {
        net::TcpStream::connect((API_HOST, API_PORT))
    }

    #[inline(always)]
    ///Connects over plain TCP
    pub fn connect() -> io::Result<Self> {
        Ok(Self::new(Self::socket_connect()?))
    }

    ///Re-connects over plain TCP, aborting previous connection if any
    pub fn reconnect(&mut self) -> io::Result<()> {
        let _ = self.io.get_mut().shutdown(std::net::Shutdown::Both);

        self.io = BufReader::new(Self::socket_connect()?);
        self.read_buf.clear();
        Ok(())
    }
}

#[cfg(feature = "rustls-on")]
impl Client<rustls::StreamOwned<rustls::ClientConnection, net::TcpStream>> {
    fn socket_connect_tls() -> io::Result<rustls::StreamOwned<rustls::ClientConnection, net::TcpStream>> {
        let socket = std::net::TcpStream::connect((API_HOST, super::API_SSL_PORT))?;

        let (dns_name, config) = super::get_rustls_config();
        let sess = match rustls::ClientConnection::new(config, dns_name) {
            Ok(sess) => sess,
            Err(error) => return Err(std::io::Error::new(std::io::ErrorKind::Other, error)),
        };

        Ok(rustls::StreamOwned::new(sess, socket))
    }

    #[inline(always)]
    ///Connects with TLS
    pub fn connect_tls() -> io::Result<Self> {
        Ok(Self::new(Self::socket_connect_tls()?))
    }

    ///Re-connects over TLS, aborting previous connection if any
    pub fn reconnect_tls(&mut self) -> io::Result<()> {
        let _ = self.io.get_mut().sock.shutdown(std::net::Shutdown::Both);

        self.io = BufReader::new(Self::socket_connect_tls()?);
        self.read_buf.clear();
        Ok(())
    }
}

impl<IO: Read + Write> Client<IO> {
    #[inline]
    ///Sends request to the server
    pub fn send(&mut self, req: &crate::protocol::Request) -> io::Result<()> {
        self.io.get_mut().write_fmt(format_args!("{}", req))
    }

    #[inline]
    ///Flushes sent requests
    pub fn flush(&mut self) -> io::Result<()> {
        self.io.get_mut().flush()
    }
}

impl<IO: Read> Client<IO> {
    ///Creates new instance from existing IO object
    pub fn new(io: IO) -> Self {
        Self {
            io: BufReader::new(io),
            read_buf: Vec::new(),
        }
    }

    ///Reads single incoming response.
    ///
    ///If `None` is returned, then it means connection is closed.
    pub fn receive(&mut self) -> io::Result<Option<crate::protocol::Response>> {
        let size = self.io.read_until(0x04, &mut self.read_buf)?;

        if size == 0 {
            return Ok(None);
        }

        let result = super::parse_response(&self.read_buf);
        self.read_buf.clear();
        result
    }
}