autoconfig 0.4.0

A simple implementation of Mozilla Thunderbird's autoconfig
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

use std::io;

use serde_xml_rs;

use crate::{config::Config, error::Result};

pub fn from_bytes<B: AsRef<[u8]>>(bytes: B) -> Result<Config> {
    let reader = io::Cursor::new(bytes.as_ref());

    let config: Config = serde_xml_rs::from_reader(reader)?;

    Ok(config)
}

#[cfg(test)]
mod tests {
    #[test]
    fn test_parser() {
        // From: https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat
        let mock_config = r#"
            <?xml version="1.0"?>
            <clientConfig version="1.1">
                <emailProvider id="example.com">
                <domain>example.com</domain>
                <domain>example.net</domain>

                <displayName>Google Mail</displayName>
                <displayShortName>GMail</displayShortName>

                <incomingServer type="pop3">
                    <hostname>pop.example.com</hostname>
                    <port>995</port>
                    <socketType>SSL</socketType>
                    <username>%EMAILLOCALPART%</username>
                    <authentication>password-cleartext</authentication>
                    <pop3>
                        
                        <leaveMessagesOnServer>true</leaveMessagesOnServer>
                        <downloadOnBiff>true</downloadOnBiff>
                        <daysToLeaveMessagesOnServer>14</daysToLeaveMessagesOnServer>
                    
                        <checkInterval minutes="15"/>
                    </pop3>
                    
                </incomingServer>

                <outgoingServer type="smtp">
                    <hostname>smtp.googlemail.com</hostname>
                    <port>587</port>
                    <socketType>STARTTLS</socketType>
                    <username>%EMAILLOCALPART%</username>
                    <authentication>password-cleartext</authentication>
                      
                    <useGlobalPreferredServer>true</useGlobalPreferredServer>
                    <password>optional: the user's password</password>
                </outgoingServer>

                <documentation url="http://www.example.com/help/mail/thunderbird">
                    <descr lang="en">Configure Thunderbird 2.0 for IMAP</descr>
                    <descr lang="de">Thunderbird 2.0 mit IMAP konfigurieren</descr>
                </documentation>

                </emailProvider>

            </clientConfig>
        "#;

        super::from_bytes(mock_config).unwrap();
    }
}