serde_html_form 0.4.0

(De-)serialization support for the `application/x-www-form-urlencoded` format
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

use alloc::{borrow::Cow, format};
use core::{
    fmt,
    str::{self, Utf8Error},
};
use std::error;

use serde_core::ser;

/// Errors returned during serializing to `application/x-www-form-urlencoded`.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct Error(ErrorKind);

#[derive(Clone, Debug, PartialEq, Eq)]
enum ErrorKind {
    Custom(Cow<'static, str>),
    Utf8(Utf8Error),
}

impl Error {
    pub(super) fn done() -> Self {
        Error(ErrorKind::Custom("this pair has already been serialized".into()))
    }

    pub(super) fn not_done() -> Self {
        Error(ErrorKind::Custom("this pair has not yet been serialized".into()))
    }

    pub(super) fn unsupported_key() -> Self {
        Error(ErrorKind::Custom("unsupported key".into()))
    }

    pub(super) fn unsupported_value() -> Self {
        Error(ErrorKind::Custom("unsupported value".into()))
    }

    pub(super) fn unsupported_pair() -> Self {
        Error(ErrorKind::Custom("unsupported pair".into()))
    }

    pub(super) fn top_level() -> Self {
        Error(ErrorKind::Custom("top-level serializer supports only maps and structs".into()))
    }

    pub(super) fn no_key() -> Self {
        Error(ErrorKind::Custom("tried to serialize a value before serializing key".into()))
    }

    pub(super) fn utf8(error: Utf8Error) -> Self {
        Error(ErrorKind::Utf8(error))
    }
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match &self.0 {
            ErrorKind::Custom(msg) => msg.fmt(f),
            ErrorKind::Utf8(err) => write!(f, "invalid UTF-8: {}", err),
        }
    }
}

impl error::Error for Error {
    /// The lower-level cause of this error, in the case of a `Utf8` error.
    fn cause(&self) -> Option<&dyn error::Error> {
        match &self.0 {
            ErrorKind::Custom(_) => None,
            ErrorKind::Utf8(err) => Some(err),
        }
    }

    /// The lower-level source of this error, in the case of a `Utf8` error.
    fn source(&self) -> Option<&(dyn error::Error + 'static)> {
        match &self.0 {
            ErrorKind::Custom(_) => None,
            ErrorKind::Utf8(err) => Some(err),
        }
    }
}

impl ser::Error for Error {
    fn custom<T: fmt::Display>(msg: T) -> Self {
        Self(ErrorKind::Custom(format!("{}", msg).into()))
    }
}