cinputs 0.2.5

Crate that simplifies the constraining of inputs
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

//! Crate for easy import parsing and constraint applying
use core::str;
use lazy_static::lazy_static;
use std::io::{self, BufRead};

pub mod basic_constraints;
pub mod constraints;
pub mod error;
pub mod prelude;

use constraints::*;
use error::{Error, ErrorKind, Result};

lazy_static! {
    /// Constant reference to Stdin reader
    static ref IO_IN: io::Stdin = io::stdin();
}

/// Read from Stdin, string is parsed into T
pub fn input<T>() -> Result<T>
where
    T: std::str::FromStr,
    <T as str::FromStr>::Err: std::fmt::Display,
{
    read_stream(IO_IN.lock())
}

/// Read from Stdin, string is parsed into T, then a constraint is applied
pub fn cinput<T, C>(constraint: C) -> Result<T>
where
    T: std::str::FromStr,
    <T as str::FromStr>::Err: std::fmt::Display,
    C: Constraint<T>,
{
    let value = input()?;
    constraint.validate(&value)?;
    Ok(value)
}

/// String is parsed into T
pub fn string_input<T>(string: &String) -> Result<T>
where
    T: std::str::FromStr,
    <T as str::FromStr>::Err: std::fmt::Display,
{
    string.parse::<T>().map_err(|err| Error {
        kind: ErrorKind::ValidationError,
        message: err.to_string(),
    })
}

/// No no a CString, string is parsed into T, then a constraint is applied
pub fn cstring_input<T, C>(string: &String, constraint: &C) -> Result<T>
where
    T: std::str::FromStr,
    <T as str::FromStr>::Err: std::fmt::Display,
    C: Constraint<T>,
{
    let value: T = string_input(string)?;
    constraint.validate(&value)?;
    Ok(value)
}

/// Read from a BufReader one line, string is parsed into T
pub fn read_stream<R, T>(mut reader: R) -> Result<T>
where
    R: BufRead,
    T: std::str::FromStr,
    <T as str::FromStr>::Err: std::fmt::Display,
{
    let mut buf = String::new();
    reader.read_line(&mut buf).map_err(|err| Error {
        kind: ErrorKind::IOError,
        message: err.to_string(),
    })?;

    string_input(&buf.trim().to_string())
}

/// Read from a BufReader one line, string is parsed into T, then a constraint is applied
pub fn cread_stream<R, T, C>(mut reader: R, constraint: &C) -> Result<T>
where
    R: BufRead,
    T: std::str::FromStr,
    <T as str::FromStr>::Err: std::fmt::Display,
    C: Constraint<T>,
{
    let mut buf = String::new();
    reader.read_line(&mut buf).map_err(|err| Error {
        kind: ErrorKind::IOError,
        message: err.to_string(),
    })?;

    cstring_input(&buf, constraint)
}