feed-0.3.8: Interfacing with RSS (v 0.9x, 2.x, 1.0) + Atom feeds.

Stabilityprovisional
MaintainerSigbjorn Finne <sof@galois.com>

Text.Feed.Constructor

Description

Description: Module for an abstraction layer between different kinds of feeds.

Synopsis

Documentation

data FeedKind

The kinds of feed documents supported.

Constructors

AtomKind 
RSSKind (Maybe String) 
RDFKind (Maybe String) 

Instances

Eq FeedKind 
Show FeedKind 

newFeed :: FeedKind -> Feed

Construct an empty feed document, intending to output it in the fk feed format.

feedFromXML :: Element -> Feed

type FeedSetter a = a -> Feed -> Feed

withFeedHTML :: FeedSetter URLString

withFeedHTML sets the URL where an HTML version of the feed is published.

withFeedDescription :: FeedSetter String

withFeedHTML sets the URL where an HTML version of the feed is published.

withFeedDate :: FeedSetter DateString

'withFeedDate dt' is the composition of withFeedPubDate and withFeedLastUpdate, setting both publication date and last update date to dt. Notice that RSS2.0 is the only format supporting both pub and last-update.

withFeedCategories :: FeedSetter [(String, Maybe String)]

type ItemSetter a = a -> Item -> Item

withItemTitle :: ItemSetter String

'withItemTitle myTitle' associates a new title, myTitle, with a feed item.

withItemLink :: ItemSetter URLString

'withItemTitle myLink' associates a new URL, myLink, with a feed item.

withItemPubDate :: ItemSetter DateString

'withItemPubDate dt' associates the creation/ publication date dt with a feed item.

withItemAuthor :: ItemSetter String

'withItemAuthor auStr' associates new author info with a feed item.

withItemCommentLink :: ItemSetter String

'withItemCommentLink url' sets the URL reference to the comment page to url.

withItemEnclosure :: String -> Maybe String -> ItemSetter Integer

'withItemEnclosure url mbTy len' sets the URL reference to the comment page to url.

withItemFeedLink :: String -> ItemSetter String

'withItemFeedLink name myFeed' associates the parent feed URL myFeed with a feed item. It is labelled as name.

withItemId :: Bool -> ItemSetter String

'withItemId isURL id' associates new unique identifier with a feed item. If isURL is True, then the id is assumed to point to a valid web resource.

withItemCategories :: ItemSetter [(String, Maybe String)]

withItemDescription :: ItemSetter String

'withItemDescription desc' associates a new descriptive string (aka summary) with a feed item.

withItemRights :: ItemSetter String

'withItemRights rightStr' associates the rights information rightStr with a feed item.