indieweb 0.10.0

A collection of utilities for working with the IndieWeb.
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188

/// Integration tests for the IndieWeb authorship algorithm.
///
/// These tests verify the full authorship discovery algorithm
/// following the test cases from <https://authorship.rocks/>
mod helpers;
use helpers::authorship::*;

use indieweb::algorithms::authorship::resolve_author;
use url::Url;

#[tokio::test]
async fn test_01_p_author_string() {
    let html = load_fixture("test_01_p_author_string.html");
    let base_url = "https://example.com/post/1";

    let document = parse_html_to_document(&html, base_url);
    let entry = find_h_entry(&document).expect("h-entry should exist");

    let client = MockClient::default();
    let page_url = Url::parse(base_url).unwrap();

    let result = resolve_author(&client, entry, &document, &page_url).await;

    result.assert_name("William Shakespeare");
    let author = result.unwrap();
    assert!(author.url.is_none(), "String author should not have URL");
    assert!(
        author.photo.is_none(),
        "String author should not have photo"
    );
}

#[tokio::test]
async fn test_02_p_author_embedded_hcard() {
    let html = load_fixture("test_02_p_author_hcard.html");
    let base_url = "https://example.com/post/2";

    let document = parse_html_to_document(&html, base_url);
    let entry = find_h_entry(&document).expect("h-entry should exist");

    let client = MockClient::default();
    let page_url = Url::parse(base_url).unwrap();

    let result = resolve_author(&client, entry, &document, &page_url).await;

    result.assert_author_matches(
        &ExpectedAuthor::new("Homer")
            .with_url("https://example.com/homer")
            .with_photo("https://example.com/images/homer.jpg"),
    );
}

#[tokio::test]
async fn test_06_hfeed_parent_author() {
    let html = load_fixture("h_feed_with_author.html");
    let base_url = "https://example.com/feed";

    let document = parse_html_to_document(&html, base_url);
    let entry = find_h_entry(&document).expect("h-entry should exist");

    let client = MockClient::default();
    let page_url = Url::parse(base_url).unwrap();

    let result = resolve_author(&client, entry, &document, &page_url).await;

    result.assert_author_matches(
        &ExpectedAuthor::new("Feed Author").with_url("https://example.com/author"),
    );
}

#[tokio::test]
async fn test_07_no_author_found() {
    let html = load_fixture("h_entry_no_author.html");
    let base_url = "https://example.com/post/no-author";

    let document = parse_html_to_document(&html, base_url);
    let entry = find_h_entry(&document).expect("h-entry should exist");

    let client = MockClient::default();
    let page_url = Url::parse(base_url).unwrap();

    let result = resolve_author(&client, entry, &document, &page_url).await;

    result.assert_no_author();
}

#[tokio::test]
async fn test_08_permalink_rel_author_followed() {
    let html = r#"<!DOCTYPE html>
<html>
<body>
  <div class="h-entry">
    <a class="u-url" href="https://example.com/post/1">Permalink</a>
    <p class="p-name e-content">Post content</p>
  </div>
  <a href="https://example.com/author-page" rel="author">Author</a>
</body>
</html>"#;

    let author_page_html = r#"<!DOCTYPE html>
<html>
<body class="h-card">
  <a href="https://example.com/author-page" class="u-url u-uid">
    <div class="p-name">Page Author</div>
  </a>
</body>
</html>"#;

    let base_url = "https://example.com/post/1";

    let mut client = MockClient::default();
    client.add_response("https://example.com/post/1".to_string(), html.to_string());
    client.add_response(
        "https://example.com/author-page".to_string(),
        author_page_html.to_string(),
    );

    let document = parse_html_to_document(html, base_url);
    let entry = find_h_entry(&document).expect("h-entry should exist");
    let page_url = Url::parse(base_url).unwrap();

    let result = resolve_author(&client, entry, &document, &page_url).await;

    result.assert_name("Page Author");
}

#[tokio::test]
async fn test_09_feed_page_rel_author_ignored() {
    let html = r#"<!DOCTYPE html>
<html>
<body>
  <div class="h-entry">
    <p class="p-name e-content">Post content without u-url</p>
  </div>
  <a href="https://example.com/author-page" rel="author">Author</a>
</body>
</html>"#;

    let base_url = "https://example.com/feed";

    let client = MockClient::default();

    let document = parse_html_to_document(html, base_url);
    let entry = find_h_entry(&document).expect("h-entry should exist");
    let page_url = Url::parse(base_url).unwrap();

    let result = resolve_author(&client, entry, &document, &page_url).await;

    result.assert_no_author();
}

#[tokio::test]
async fn test_10_author_as_u_author_url() {
    let html = r#"<!DOCTYPE html>
<html>
<body>
  <div class="h-entry">
    <a class="u-author" href="https://example.com/some-author">author page</a>
    <p class="p-name e-content">Post with URL author</p>
  </div>
</body>
</html>"#;

    let author_page_html = r#"<!DOCTYPE html>
<html>
<body class="h-card">
  <a href="https://example.com/some-author" class="u-url u-uid">
    <div class="p-name">URL Author</div>
  </a>
</body>
</html>"#;

    let base_url = "https://example.com/post/url-author";

    let mut client = MockClient::default();
    client.add_response(
        "https://example.com/some-author".to_string(),
        author_page_html.to_string(),
    );

    let document = parse_html_to_document(html, base_url);
    let entry = find_h_entry(&document).expect("h-entry should exist");
    let page_url = Url::parse(base_url).unwrap();

    let result = resolve_author(&client, entry, &document, &page_url).await;

    result.assert_name("URL Author");
}