trotter 0.2.0

Trotter 🎠 is an experimental crate that aims to make writing Gemini clients fun and easy.
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

/// Enum for representing useragents defined by the gemini version of the robots.txt spec.
#[derive(Debug, Clone)]
pub enum UserAgent {
    /// Gemini bots which fetch content in order to build
    /// public long-term archives of Geminispace, which will
    /// serve old Gemini content even after the original has
    /// changed or disappeared (analogous to archive.org's
    /// "Wayback Machine"), should respect robots.txt
    /// directives aimed at a User-agent of "archiver".
    Archiver,

    /// Gemini bots which fetch content in order to build
    /// searchable indexes of Geminispace should respect
    /// robots.txt directives aimed at a User-agent of
    /// "indexer".
    Indexer,

    /// Gemini bots which fetch content in order to study
    /// large-scale statistical properties of Geminispace
    /// (e.g. number of domains/pages, distribution of MIME
    /// media types, response sizes, TLS versions, frequency
    /// of broken links, etc.), without rehosting, linking
    /// to, or allowing search of any fetched content,
    /// should respect robots.txt directives aimed at a
    /// User-agent of "researcher".
    Researcher,

    /// Gemini bots which fetch content in order to
    /// translate said content into HTML and publicly serve
    /// the result over HTTP(S) (in order to make
    /// Geminispace accessible from within a standard web
    /// browser) should respect robots.txt directives aimed
    /// at a User-agent of "webproxy".
    Webproxy,
}

impl std::fmt::Display for UserAgent {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(
            f,
            "{}",
            match self {
                UserAgent::Archiver => "archiver",
                UserAgent::Indexer => "indexer",
                UserAgent::Researcher => "researcher",
                UserAgent::Webproxy => "webproxy",
            }
        )
    }
}