The NewsCriteria class¶
- class ferenda.NewsCriteria(basefile, feedtitle, selector=None, key=None)¶
Represents a particular subset of the documents in a repository, for the purpose of generating a news feed for that subset. These criteria objects are used by news(), and the simplest way of controlling which criteria are used for your docrepo is to override news_criteria() to make it return a list of instantiated NewsCriteria objects.
Parameters: - basefile (str) – A slug-like basic text label for this subset.
- feedtitle (str) – The title for this particular news feed
- selector (callable) – Function that takes a single DocumentEntry object and returns true iff it should be included in this feed.
- key (callable) – Function that takes a single DocumentEntry object and returns a value that can be used for sorting that object. The default implementation returns the entrys updated attribute, so that the feed contains entries sorted most recently updated first.