Feedistiller (feedistiller v3.2.0)

Provides functions to downloads enclosures of rss/atom feeds.

Features:

download multiple feeds at once and limit the number of downloads occurring at the same (globally or on per feed basis).
various filtering options:
- content-type criteria
- item name criteria
- item date criteria

HTTPoison must be started to use Feedistiller functions.

Link to this section Summary

Download enclosures of the given feed according to its settings.

Download a set of feeds according to their settings.

Download a set of feeds according to their settings, with max simultaneous downloads at the same time across all feeds.

download_feed(Feedistiller.FeedAttributes.t(), Alambic.Semaphore.t() | nil) ::
  :ok | {:error, String.t()}

Download enclosures of the given feed according to its settings.

Attributes of the feed are:

url: the url of the feed. Redirect are auto followed.
destination: path for the downloaded files. Files are put in a subdirectory matching the feed name.
max_simultaneous_downloads: maximum number of simultaneous downloads for this file. Default is 3. Can be set to :unlimited for no limit.
only_new: donwload only new files (files not already in the destination directory)
filters: a set of filters to apply to the downloaded files:
- limits: limits on the number of files to download:
  - to: download files up to this date (default is :latest)
  - from: download files from this date (default is :oldest)
  - max: download at most max files (default is :unlimited)
- mime: a list of regex to apply to the 'content-type' field of the enclosure. Only 'content-type' passing those regex are downloaded.
- name: a list of regex to apply to the name of the feed items. Only enclosure attached to names matching those regex are downloaded.

download_feeds([Feedistiller.FeedAttributes.t()]) :: :ok

Download a set of feeds according to their settings.

download_feeds(
  [Feedistiller.FeedAttributes.t()],
  integer() | Alambic.Semaphore.t() | nil
) :: :ok

Download a set of feeds according to their settings, with max simultaneous downloads at the same time across all feeds.