README.md — sigil-rss

1# sigil-rss

3RSS/Atom feed parsing library for [Sigil](https://codeberg.org/sigil/sigil).

5## Features

7- Parse RSS 2.0 and Atom feeds into common structs

8- Auto-detect feed format

9- Fetch feeds over HTTP/HTTPS

10- Graceful handling of missing or malformed fields

12## Usage

14```scheme

15(import (sigil rss parser)

16 (sigil rss fetcher)

17 (sigil rss types))

19;; Fetch and parse a feed

20(let ((f (fetch-feed "https://example.com/feed.xml")))

21 (display (feed-title f))

22 (for-each (lambda (entry)

23 (display (feed-entry-title entry))

24 (newline))

25 (feed-entries f)))

27;; Parse from a string (auto-detects RSS vs Atom)

28(let ((f (parse-feed xml-string)))

29 (feed-format f)) ; => 'rss or 'atom

30```

32## Modules

34- `(sigil rss types)` - `feed` and `feed-entry` structs

35- `(sigil rss parser)` - `parse-rss`, `parse-atom`, `parse-feed`

36- `(sigil rss fetcher)` - `fetch-feed`, `fetch-feeds`

38## Dependencies

40- `sigil-stdlib` ^0.9.0

41- `sigil-http` ^0.9.0

42- `sigil-sxml` ^0.9.0

44## Build

46```

47sigil deps install

48sigil build

49sigil test

50```

52## License

54BSD-3-Clause