ClassyGitShadowzzh

rss.rs

rss.rs

//! 全站 RSS(`GET /rss`)。動手前 region 覆蓋率是 **0%**。
//!
//! RSS 壞掉是所有端點裡最無聲的一種:閱讀器不會報錯,它只是不再更新,
//! 而站長自己幾乎不會去看自己的 feed。所以這裡驗的不是「有沒有回 200」,
//! 是幾條「錯了訂閱者會默默收到爛東西」的性質:
//!
//!   · 連結要用 **slug** 不是 id —— 檔案裡的註解寫得很清楚:slug 遷移之後
//!     用 id 會讓每一條連結吃一次 301,對搜尋引擎則是整份 feed 都指向非 canonical。
//!   · `?lang=ja` 要**排掉沒有日文譯文的文章** —— 訂了日文卻收到中文全文,
//!     體感就是壞掉。
//!   · pubDate 必須是 RFC 1123 —— 格式錯的話多數閱讀器直接把該筆當成「無日期」,
//!     排序整個亂掉。
//!   · XML 轉義漏掉 `&` 或 `<` 會讓整份 feed 變成 not well-formed,
//!     閱讀器直接丟棄——一篇標題有 `&` 的文章可以毀掉整個 feed。

mod common;

use axum::http::StatusCode;
use common::{request_full, test_app};

/// 取回 feed 的 XML 本文(順便斷言狀態碼與 content-type)。
async fn rss(app: &axum::Router, query: &str) -> String {
    let path = if query.is_empty() { "/rss".to_string() } else { format!("/rss?{query}") };
    let (status, headers, body) = request_full(app, "GET", &path, None, None).await;
    assert_eq!(status, StatusCode::OK, "{path}");
    assert_eq!(
        headers.get("content-type").unwrap(),
        "application/rss+xml; charset=utf-8",
        "content-type 不對的話有些閱讀器會拒收"
    );
    // 非 JSON 的回應會被 request_full 包成 Value::String
    body.as_str().expect("RSS 應該是字串(XML)").to_string()
}

/// 這個檔案自己的固定資料:seed 那份沒有 i18n 譯文,也沒有需要轉義的字元。
///
/// ⚠ 開頭先清空 posts。`common::seed` 建的兩篇沒有指定 `created_at`,
/// 於是拿到 `datetime('now')` —— 永遠排在最前面,讓「由新到舊」與 `lastBuildDate`
/// 這兩條斷言變成跟執行當下的時鐘比對(第一版就是這樣紅的)。
/// 這個檔要驗的是排序與日期格式,資料集必須完全由自己掌控。
async fn seed_rss(pool: &sqlx::SqlitePool) {
    sqlx::query("DELETE FROM post_tags").execute(pool).await.unwrap();
    sqlx::query("DELETE FROM posts").execute(pool).await.unwrap();
    for sql in [
        // 有 slug、有 excerpt、有分類與標籤 —— 一般情況
        "INSERT INTO posts (id, slug, title, content, excerpt, category, status, author, created_at, updated_at) \
         VALUES (20, 'has-slug', '有 slug 的文章', '內文', '這是摘要', '技術', 'published', 'Koi', \
                 '2026-01-20 03:00:00', '2026-01-21 03:00:00')",
        // 沒有 slug → 連結退回 id
        "INSERT INTO posts (id, title, content, excerpt, status, created_at, updated_at) \
         VALUES (21, '沒有 slug 的文章', '內文', '摘要', 'published', '2026-01-19 03:00:00', '2026-01-19 03:00:00')",
        // 標題與摘要含需要轉義的字元
        "INSERT INTO posts (id, slug, title, content, excerpt, status, created_at, updated_at) \
         VALUES (22, 'xml-esc', 'A & B <tag> \"quoted\" it''s', '內文', '摘要 & <b>粗體</b>', 'published', \
                 '2026-01-18 03:00:00', '2026-01-18 03:00:00')",
        // 沒有 excerpt → 要從 content 去 HTML/markdown 生出來
        "INSERT INTO posts (id, slug, title, content, status, created_at, updated_at) \
         VALUES (23, 'no-excerpt', '沒有摘要的文章', \
                 '# 標題\n\n這是 <strong>內文</strong> 的第一段。\n\n- 條列一\n- 條列二', \
                 'published', '2026-01-17 03:00:00', '2026-01-17 03:00:00')",
        // 有日文譯文 —— ?lang=ja 應該只留這一篇
        "INSERT INTO posts (id, slug, title, content, excerpt, status, title_ja, content_ja, excerpt_ja, created_at, updated_at) \
         VALUES (24, 'has-ja', '有日文版的文章', '中文內文', '中文摘要', 'published', \
                 '日本語のタイトル', '日本語の本文', '日本語の要約', '2026-01-16 03:00:00', '2026-01-16 03:00:00')",
        // 草稿:任何語系的 feed 都不該出現
        "INSERT INTO posts (id, slug, title, content, status, created_at, updated_at) \
         VALUES (25, 'a-draft', '這是草稿不該出現', '內文', 'draft', '2026-01-15 03:00:00', '2026-01-15 03:00:00')",
    ] {
        sqlx::query(sql).execute(pool).await.unwrap();
    }
    // 給 20 掛兩個標籤(tag id 1 = rust 由 seed 建立)
    sqlx::query("INSERT INTO tags (id, name) VALUES (90, 'axum')").execute(pool).await.unwrap();
    for sql in [
        "INSERT INTO post_tags (post_id, tag_id) VALUES (20, 1)",
        "INSERT INTO post_tags (post_id, tag_id) VALUES (20, 90)",
    ] {
        sqlx::query(sql).execute(pool).await.unwrap();
    }
}

#[tokio::test]
async fn 連結用_slug_而不是_id_沒有_slug_才退回_id() {
    // 這條是回歸測試。用 id 的話每一條連結都會吃一次 301(slug 遷移之後),
    // 訂閱者多一跳、搜尋引擎看到的是整份指向非 canonical 網址的 feed。
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "").await;

    assert!(xml.contains("<link>https://koimsurai.com/blog/has-slug</link>"), "有 slug 就要用 slug");
    assert!(!xml.contains("/blog/20<"), "不該出現 /blog/20");
    assert!(xml.contains("<link>https://koimsurai.com/blog/21</link>"), "沒有 slug 才退回 id");
    // guid 與 link 一致,且宣告 isPermaLink
    assert!(xml.contains(r#"<guid isPermaLink="true">https://koimsurai.com/blog/has-slug</guid>"#));
}

#[tokio::test]
async fn 草稿不進_feed() {
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "").await;
    assert!(!xml.contains("這是草稿不該出現"), "草稿外洩到 RSS 等於直接公開");
    assert!(!xml.contains("a-draft"));
}

#[tokio::test]
async fn 標題與摘要的_xml_轉義() {
    // `&` 或 `<` 沒轉的話整份 feed 變成 not well-formed,閱讀器會**整個丟掉**——
    // 一篇標題有 & 的文章可以毀掉所有訂閱者的更新。
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "").await;

    // 全站共用 util::escape_html(五個字元);單引號用 &#39;,不是 HTML4 不認得的 &apos;
    assert!(
        xml.contains("A &amp; B &lt;tag&gt; &quot;quoted&quot; it&#39;s"),
        "得到的 XML 裡找不到轉義後的標題"
    );
    assert!(xml.contains("摘要 &amp; &lt;b&gt;粗體&lt;/b&gt;"));
    // 整份必須是合法 XML:沒有落單的 & (轉義後的 &xxx; 不算)
    let stray = regex_lite_count_stray_amp(&xml);
    assert_eq!(stray, 0, "有 {stray} 個沒轉義的 &,feed 會被閱讀器丟掉");
}

/// 數「不是實體開頭」的 `&`。不引入 regex 相依,手掃即可。
fn regex_lite_count_stray_amp(s: &str) -> usize {
    let b: Vec<char> = s.chars().collect();
    let mut n = 0;
    for (i, c) in b.iter().enumerate() {
        if *c != '&' {
            continue;
        }
        let tail: String = b[i + 1..].iter().take(6).collect();
        let is_entity = ["amp;", "lt;", "gt;", "quot;", "apos;", "#"].iter().any(|e| tail.starts_with(e));
        if !is_entity {
            n += 1;
        }
    }
    n
}

#[tokio::test]
async fn 沒有摘要時從內文生成_去掉_html_與_markdown() {
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "").await;

    // 找出那一篇的 description
    let item = xml.split("<item>").find(|s| s.contains("沒有摘要的文章")).expect("找得到那篇");
    let desc = item
        .split("<description>")
        .nth(1)
        .and_then(|s| s.split("</description>").next())
        .expect("有 description");
    assert!(!desc.contains('<'), "HTML 標籤要被去掉,得到 {desc}");
    assert!(!desc.contains('#') && !desc.contains('*'), "markdown 記號要被去掉,得到 {desc}");
    assert!(desc.contains("這是"), "內文本身要留著,得到 {desc}");
    assert!(desc.contains("條列一"), "條列的文字要留著(只去掉記號)");
}

#[tokio::test]
async fn pubdate_是_rfc_1123_而不是_sqlite_的原始字串() {
    // 格式不對多數閱讀器會當成「無日期」,整個排序亂掉。
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "").await;

    let pub_date =
        xml.split("<pubDate>").nth(1).and_then(|s| s.split("</pubDate>").next()).expect("至少一筆 pubDate");
    // 2026-01-20 03:00:00 UTC = Tue, 20 Jan 2026 03:00:00 GMT
    assert_eq!(pub_date, "Tue, 20 Jan 2026 03:00:00 GMT");
    assert!(!xml.contains("<pubDate>2026-01-20 03:00:00</pubDate>"), "不能原樣吐 SQLite 的格式");
    // lastBuildDate 取最新一筆的 updated_at(20 那篇是 01-21)
    let last = xml
        .split("<lastBuildDate>")
        .nth(1)
        .and_then(|s| s.split("</lastBuildDate>").next())
        .expect("有 lastBuildDate");
    assert_eq!(last, "Wed, 21 Jan 2026 03:00:00 GMT", "lastBuildDate 用 updated_at 不是 created_at");
}

#[tokio::test]
async fn 日文_feed_只收有日文譯文的文章() {
    // 訂了 ja 卻收到中文全文,訂閱者的體感就是「這個 feed 壞了」。
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "lang=ja").await;

    assert!(xml.contains("日本語のタイトル"), "有日文版的要出現,而且用日文標題");
    assert!(xml.contains("日本語の要約"));
    assert!(!xml.contains("有 slug 的文章"), "沒有日文譯文的不該混進來");
    assert!(!xml.contains("沒有摘要的文章"));
    // 連結要帶語系前綴,頻道語言與 self link 也要跟著
    assert!(xml.contains("<link>https://koimsurai.com/ja/blog/has-ja</link>"), "連結要帶 /ja");
    assert!(xml.contains("<language>ja</language>"));
    assert!(xml.contains(r#"href="https://koimsurai.com/rss?lang=ja""#), "atom:self 要指回帶 lang 的網址");
    assert!(xml.contains("<link>https://koimsurai.com/ja/blog</link>"), "頻道連結也要帶前綴");
}

#[tokio::test]
async fn 認不得的語系退回繁中且不加前綴() {
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    for q in ["lang=de", "lang=", "lang=zh-TW", ""] {
        let xml = rss(&app, q).await;
        assert!(xml.contains("<language>zh-TW</language>"), "q={q:?}");
        assert!(xml.contains("<link>https://koimsurai.com/blog</link>"), "q={q:?} 不該有語系前綴");
        assert!(xml.contains(r#"href="https://koimsurai.com/rss""#), "q={q:?} self link 不帶 lang");
        assert!(xml.contains("有 slug 的文章"), "q={q:?} 退回繁中就該收得到中文文章");
    }
}

#[tokio::test]
async fn 分類與標籤都變成_category_元素() {
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "").await;
    let item = xml.split("<item>").find(|s| s.contains("有 slug 的文章")).expect("找得到那篇");
    assert!(item.contains("<category>技術</category>"), "文章分類要出現");
    assert!(item.contains("<category>rust</category>"), "標籤也算 category");
    assert!(item.contains("<category>axum</category>"));
    // 沒有標籤的那篇不該生出空的 <category></category>
    let plain = xml.split("<item>").find(|s| s.contains("沒有 slug 的文章")).unwrap();
    assert!(!plain.contains("<category></category>"), "空標籤不該生出空元素");
}

#[tokio::test]
async fn 沒有作者時用預設值() {
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    let xml = rss(&app, "").await;
    let item = xml.split("<item>").find(|s| s.contains("沒有 slug 的文章")).unwrap();
    assert!(item.contains("<author>Koimsurai</author>"), "空作者要有預設值,不是空元素");
    let with_author = xml.split("<item>").find(|s| s.contains("有 slug 的文章")).unwrap();
    assert!(with_author.contains("<author>Koi</author>"), "有作者就用它的");
}

#[tokio::test]
async fn 沒有任何文章時仍然回合法的_feed() {
    // 全新站台或某語系一篇譯文都沒有時走這條。回半份 XML 的話閱讀器會直接報錯。
    let (app, _pool) = test_app().await;
    let xml = rss(&app, "lang=ko").await;
    assert!(xml.starts_with("<?xml version=\"1.0\" encoding=\"UTF-8\"?>"));
    assert!(xml.contains("<channel>") && xml.contains("</channel>"));
    assert!(xml.trim_end().ends_with("</rss>"));
    assert!(!xml.contains("<item>"), "沒有文章就不該有 item");
    assert!(xml.contains("<lastBuildDate>"), "沒有文章時 lastBuildDate 要用現在時間,不能是空的");
}

#[tokio::test]
async fn 最多三十筆且由新到舊() {
    let (app, pool) = test_app().await;
    seed_rss(&pool).await;
    // 再塞 40 篇,驗 LIMIT 30
    for i in 0..40 {
        sqlx::query(
            "INSERT INTO posts (title, content, excerpt, status, created_at, updated_at) VALUES (?, '內文', '摘要', 'published', ?, ?)",
        )
        .bind(format!("批次文章 {i}"))
        .bind(format!("2025-02-{:02} 03:00:00", (i % 28) + 1))
        .bind("2025-02-01 03:00:00")
        .execute(&pool)
        .await
        .unwrap();
    }
    let xml = rss(&app, "").await;
    assert_eq!(xml.matches("<item>").count(), 30, "上限是 30 筆");

    // 第一筆要是最新的(2026-01-20 那篇比所有 2025 的新)
    let first = xml.split("<item>").nth(1).unwrap();
    assert!(first.contains("有 slug 的文章"), "排序要由新到舊");
}