#MoonFeed

#支持状态

#Requirements

• MoonBit >= v0.10.14
• 当前开发验证使用 MoonBit 0.1.20260920 / moonc v0.10.14+7d59c7ec9。
• GitHub Actions 使用官方 latest 安装渠道并输出实际版本；本地开发验证固定使用 v0.10.14，CI 实际版本每次需结合日志确认。
• RSS 与 Atom XML 解析使用 MoonFeed 内部 src/xmlmini reader，不依赖第三方 XML registry 包。Atom 元素按 namespace URI 与 local name 识别；RFC 4287 尚未完整实现，详见 兼容矩阵。

#安装与运行

moon add joanna/moonfeed@0.1.2

git clone https://github.com/jojochensmart-lab/moonfeed.git
cd moonfeed
moon --version
moonc -v
moon check
moon test
moon build
moon run examples/basic

#CLI

moon run cli --target js -- detect fixtures/rss/full.xml
moon run cli --target js -- inspect fixtures/atom/full.xml
moon run cli --target js -- normalize fixtures/jsonfeed/full.json

Format: RSS 2.0
Title: Example Feed
Items: 2

#当前限制

#API 示例

import { "joanna/moonfeed" }

let feed = @moonfeed.parse(input)

test {
  let feed = @moonfeed.parse_json_feed(
    #|{"version":"https://jsonfeed.org/version/1.1","title":"News","items":[]}
  )
  assert_eq(feed.title, "News")
}

test {
  let feed = @moonfeed.parse_rss(
    #|<rss version="2.0"><channel><title>News</title><link>https://example.org/</link><description>Updates</description></channel></rss>
  )
  assert_eq(feed.title, "News")
  assert_eq(feed.home_page_url, Some("https://example.org/"))
}

#JSON Feed 1.1

#RSS 2.0

• channel link → Feed.home_page_url；channel category → Feed.categories。
• channel lastBuildDate 优先、否则 pubDate → Feed.updated；选中的原始字符串保留，成功解析时另提供 Feed.updated_at。item pubDate 映射到 published / published_at。
• item guid → FeedItem.id；缺失 guid 时使用非空 link；两者都缺失时返回 InvalidRequiredField，不生成随机 ID。
• item description → summary 和 content_html；RSS 不声明内容是否为 HTML，因此保留同一原始值。
• item author → 单个 Author.name；item category → FeedItem.categories。
• enclosure 的 url、type、length → Attachment.url、mime_type、size_in_bytes。

#RSS Podcast extensions

let podcast = @moonfeed.parse_podcast_rss(input)
let show_author = podcast.show.author
let categories = podcast.show.categories
let first_episode = podcast.episodes[0]
let duration = first_episode.duration_in_seconds

#Atom 1.0

#Atom 文档与标准校验入口（Git main）

test {
  let document = @moonfeed.parse_atom_document(
    #|<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://example.org/news/"><id>urn:entry:demo</id><title>MoonFeed</title><updated>2026-10-20T12:00:00Z</updated><author><name>MoonBit</name></author><link href="../article"/><content>Hello</content></entry>
  )
  match document {
    @moonfeed.AtomDocument::EntryDocument(entry) => {
      assert_eq(entry.metadata.id, Some("urn:entry:demo"))
      assert_eq(entry.metadata.links[0].href.raw, "../article")
      assert_eq(entry.metadata.links[0].href.resolved, "https://example.org/article")
      assert_eq(entry.content.unwrap().value, "Hello")
    }
    _ => fail("expected Entry Document")
  }
}

#现有统一模型入口与迁移

• feed rel=self 映射到 Feed.feed_url；rel=alternate 或未指定 rel 映射到 Feed.home_page_url。
• entry rel=alternate 或未指定 rel 映射到 FeedItem.url；rel=enclosure 映射到 Attachment 的 href、type、title、length。
• entry 没有 author 时继承 feed authors；entry 自己声明 author 时使用 entry authors。Atom contributors 不并入 authors。
• text（含缺省 type）写入 content_text；html 写入 content_html；xhtml 提取可读文本后写入 content_html。
• Feed id、rights、generator、icon/logo、作者 email、contributors、entry rights/source，以及未知 rel 链接目前没有统一模型字段，因此解析后不保留。扩展节点被忽略。
• Atom 标准元素必须属于 http://www.w3.org/2005/Atom，并按展开名称（namespace URI + local name）匹配。默认命名空间和任意合法前缀等价；同 local name 的其他 namespace 扩展节点不会被当作 Atom 字段。
• 内部 XML reader 支持默认/显式前缀绑定、作用域继承与重绑定、默认 namespace 清空、XML 保留前缀规则、无前缀属性不继承默认 namespace，以及重复展开属性检测。它仍是 Feed 专用子集 reader，不是完整 XML 处理器。
• 上述统一模型映射会丢弃模型中没有对应槽位的信息；需要 source、完整链接/分类或扩展数据时使用新的文档 API。它已经补齐独立 Entry、XML Base 和元数据访问，但仍不能宣称完整 RFC 4287 兼容。

test {
  let feed = @moonfeed.parse_atom(
    #|<feed xmlns="http://www.w3.org/2005/Atom"><id>urn:news</id><title>News</title><updated>2026-10-01T12:00:00Z</updated><entry><id>post-1</id><title>First post</title><updated>2026-10-01T12:00:00Z</updated><summary>Hello</summary></entry></feed>
  )
  assert_eq(feed.items[0].id, "post-1")
}

#Date normalization

let date = @moonfeed.parse_rss_datetime("Wed, 02 Oct 2002 13:00:00 GMT")
assert_eq(date.raw, "Wed, 02 Oct 2002 13:00:00 GMT")
assert_eq(date.unix_seconds, 1033563600L)

#开发与测试

moon info
moon fmt
moon check
moon test
moon build

#Roadmap

• 已完成：统一模型、JSON Feed 1.1、RSS 2.0、Atom 1.0、RSS Podcast 核心扩展、测试、文档、CI 和 Mooncakes joanna/moonfeed@0.1.2 发布。
• 当前优先：补齐 Atom 相关 XML 1.0、剩余 LEIRI/namespace URI/历史 email/MIME 规则与闰秒维护，按已记录的 API 迁移策略，逐项完成 RFC 4287 兼容矩阵。

#License