A planet (feed aggregator) for OCaml.

Thibaut 2fa44943d1 Prepare release 0.2 5 months ago
.github 4dc23fd3bd Port to Dune 7 months ago
example 4dc23fd3bd Port to Dune 7 months ago
lib 637fdab905 Add link response 5 months ago
.gitignore 4dc23fd3bd Port to Dune 7 months ago
.ocamlformat 4dc23fd3bd Port to Dune 7 months ago
CHANGES.md 2fa44943d1 Prepare release 0.2 5 months ago
LICENSE 4dc23fd3bd Port to Dune 7 months ago
Makefile 4dc23fd3bd Port to Dune 7 months ago
README.md 2fa44943d1 Prepare release 0.2 5 months ago
dune-project 2fa44943d1 Prepare release 0.2 5 months ago
river.opam 2fa44943d1 Prepare release 0.2 5 months ago

README.md

River

Actions Status

RSS2 and Atom feed aggregator for OCaml

Features

  • Performs deduplication.
  • Supports pagination and generating well-formed html prefix snippets.
  • Support for generating aggregate feeds.
  • Sorts the posts from most recent to oldest.
  • Depends on ocamlnet for html parsing.

Installation

opam install river

Usage

Here's an example program that aggregates the feeds from different sources:

let sources =
  River.
    [
      { name = "KC Sivaramakrishnan"; url = "http://kcsrk.info/atom-ocaml.xml" };
      {
        name = "Amir Chaudhry";
        url = "http://amirchaudhry.com/tags/ocamllabs-atom.xml";
      };
    ]

let () =
  let feeds = List.map River.fetch sources in
  let posts = River.posts feeds in
  let entries = River.create_atom_entries posts in
  let feed =
    let authors = [ Syndic.Atom.author "OCaml Blog" ] in
    let id = Uri.of_string "https://ocaml.org/atom.xml" in
    let links = [ Syndic.Atom.link ~rel:Self id ] in
    let title : Syndic.Atom.text_construct =
      Text "OCaml Blog: Read the latest OCaml news from the community."
    in
    let updated = Ptime.of_float_s (Unix.gettimeofday ()) |> Option.get in
    Syndic.Atom.feed ~authors ~links ~id ~title ~updated entries
  in
  let out_channel = open_out "example/atom.xml" in
  Syndic.Atom.output feed (`Channel out_channel);
  close_out out_channel

Contributing

Take a look at our Contributing Guide.