jid/
error.rs

1// Copyright (c) 2017, 2018 lumi <lumi@pew.im>
2// Copyright (c) 2017, 2018, 2019 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
3// Copyright (c) 2017, 2018, 2019 Maxime “pep” Buquet <pep@bouah.net>
4// Copyright (c) 2017, 2018 Astro <astro@spaceboyz.net>
5// Copyright (c) 2017 Bastien Orivel <eijebong@bananium.fr>
6//
7// This Source Code Form is subject to the terms of the Mozilla Public
8// License, v. 2.0. If a copy of the MPL was not distributed with this
9// file, You can obtain one at http://mozilla.org/MPL/2.0/.
10
11use core::fmt;
12
13/// An error that signifies that a `Jid` cannot be parsed from a string.
14#[derive(Debug, PartialEq, Eq)]
15pub enum Error {
16    /// Happens when the node is empty, that is the string starts with a @.
17    NodeEmpty,
18
19    /// Happens when the resource is empty, that is the string ends with a /.
20    ResourceEmpty,
21
22    /// Happens when the localpart is longer than 1023 bytes.
23    NodeTooLong,
24
25    /// Happens when the resource is longer than 1023 bytes.
26    ResourceTooLong,
27
28    /// Happens when the localpart is invalid according to nodeprep.
29    NodePrep,
30
31    /// Happens when the domain is invalid according to nameprep.
32    NamePrep,
33
34    /// Happens when the resource is invalid according to resourceprep.
35    ResourcePrep,
36
37    /// Happens when there is no resource, that is string contains no /.
38    ResourceMissingInFullJid,
39
40    /// Happens when parsing a bare JID and there is a resource.
41    ResourceInBareJid,
42
43    /// Happens when parsing a JID which has two @ before the resource.
44    TooManyAts,
45
46    /// Happens when the domain is invalid according to idna.
47    Idna,
48}
49
50impl core::error::Error for Error {}
51
52impl fmt::Display for Error {
53    fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
54        fmt.write_str(match self {
55            Error::NodeEmpty => "nodepart empty despite the presence of a @",
56            Error::ResourceEmpty => "resource empty despite the presence of a /",
57            Error::NodeTooLong => "localpart longer than 1023 bytes",
58            Error::ResourceTooLong => "resource longer than 1023 bytes",
59            Error::NodePrep => "localpart doesn’t pass nodeprep validation",
60            Error::NamePrep => "domain doesn’t pass nameprep validation",
61            Error::ResourcePrep => "resource doesn’t pass resourceprep validation",
62            Error::ResourceMissingInFullJid => "no resource found in this full JID",
63            Error::ResourceInBareJid => "resource found while parsing a bare JID",
64            Error::TooManyAts => "second @ found before parsing the resource",
65            Error::Idna => "domain doesn’t pass idna validation",
66        })
67    }
68}
jid/error.rs

jid/
error.rs
