jid 0.12.2

A crate which provides a Jid struct for Jabber IDs.
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

// Copyright (c) 2017, 2018 lumi <lumi@pew.im>
// Copyright (c) 2017, 2018, 2019 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
// Copyright (c) 2017, 2018, 2019 Maxime “pep” Buquet <pep@bouah.net>
// Copyright (c) 2017, 2018 Astro <astro@spaceboyz.net>
// Copyright (c) 2017 Bastien Orivel <eijebong@bananium.fr>
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

use core::fmt;

/// An error that signifies that a `Jid` cannot be parsed from a string.
#[derive(Debug, PartialEq, Eq)]
pub enum Error {
    /// Happens when the node is empty, that is the string starts with a @.
    NodeEmpty,

    /// Happens when the resource is empty, that is the string ends with a /.
    ResourceEmpty,

    /// Happens when the localpart is longer than 1023 bytes.
    NodeTooLong,

    /// Happens when the resource is longer than 1023 bytes.
    ResourceTooLong,

    /// Happens when the localpart is invalid according to nodeprep.
    NodePrep,

    /// Happens when the domain is invalid according to nameprep.
    NamePrep,

    /// Happens when the resource is invalid according to resourceprep.
    ResourcePrep,

    /// Happens when there is no resource, that is string contains no /.
    ResourceMissingInFullJid,

    /// Happens when parsing a bare JID and there is a resource.
    ResourceInBareJid,

    /// Happens when parsing a JID which has two @ before the resource.
    TooManyAts,

    /// Happens when the domain is invalid according to idna.
    Idna,
}

impl core::error::Error for Error {}

impl fmt::Display for Error {
    fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
        fmt.write_str(match self {
            Error::NodeEmpty => "nodepart empty despite the presence of a @",
            Error::ResourceEmpty => "resource empty despite the presence of a /",
            Error::NodeTooLong => "localpart longer than 1023 bytes",
            Error::ResourceTooLong => "resource longer than 1023 bytes",
            Error::NodePrep => "localpart doesn’t pass nodeprep validation",
            Error::NamePrep => "domain doesn’t pass nameprep validation",
            Error::ResourcePrep => "resource doesn’t pass resourceprep validation",
            Error::ResourceMissingInFullJid => "no resource found in this full JID",
            Error::ResourceInBareJid => "resource found while parsing a bare JID",
            Error::TooManyAts => "second @ found before parsing the resource",
            Error::Idna => "domain doesn’t pass idna validation",
        })
    }
}