File: nnfeed.el.html

Generic Gnus backend (intended) for implementing backends for web feeds (Atom, RSS).

This backend is abstract - it doesn't implement a parser for any specific web feed type, and so can't be used independently.

Instead, it implements a generic parser, feed data storage and most of the Gnus backend interface; the intended use for this backend is to be a source of inheritance for backends supporting new web feed types.

To implement new backends, use nnfeed-define-basic-backend-interface:

   ...
   (require 'nnfeed)

   (nnoo-declare nnfoo nnfeed)

   (nnfeed-define-basic-backend-interface nnfoo)
   ...
   [ definitions of parsing functions, see the "Feed parser interface"
      section for more information. ]

   (defvoo nnfoo-read-feed-function #'nnfoo--read-feed
    nil nnfeed-read-feed-function)
   ...
   (gnus-declare-backend (symbol-name nnfeed-backend) 'none 'address)

   (provide 'nnfoo)

Defined variables (25)

nnfeed-backendSymbol which identifies this backend.
nnfeed-date-formatFormat of displayed dates (see function ‘format-time-string’).
nnfeed-groupName of the current group.
nnfeed-group-article-idsHash table mapping article IDs to their article number.
nnfeed-group-article-max-numMaximum article number for the current group.
nnfeed-group-article-min-numMinimum article number for the current group.
nnfeed-group-articlesHash table mapping article numbers to articles and their attributes.
nnfeed-group-namesHash table mapping real group names to their custom name.
nnfeed-print-content-functionFunction returning a single piece of content for an article (a string).
nnfeed-read-article-functionFunction returning a cons cell of an article and remaining data from a group.
nnfeed-read-author-functionFunction returning the author of an article (a string), or nil.
nnfeed-read-description-functionFunction returning the description of a group (a string), or nil.
nnfeed-read-feed-functionFunction returning a Lisp object representing a feed (or part of it).
nnfeed-read-group-author-functionFunction returning the author of a group (a string), or nil.
nnfeed-read-group-functionFunction returning a cons cell of a group and remaining data from a feed.
nnfeed-read-headers-functionFunction returning an alist of article-wide MIME headers.
nnfeed-read-id-functionFunction returning the ID of an article.
nnfeed-read-links-functionFunction returning all links contained in an article.
nnfeed-read-parts-functionFunction returning an alist associating parts of an article to their headers.
nnfeed-read-publish-date-functionFunction returning the publish date of an article (a time value), or nil.
nnfeed-read-subject-functionFunction returning the subject of an article (a string), or nil.
nnfeed-read-title-functionFunction returning the title of a group (a string).
nnfeed-read-update-date-functionFunction returning the update date of an article (a time value), or nil.
nnfeed-serversHash table mapping known servers to their groups.
nnfeed-status-stringLast status message reported by this backend.

Defined functions (27)

nnfeed--current-server-no-prefix()
nnfeed--group-data(GROUP SERVER)
nnfeed--group-description(NAME GROUP)
nnfeed--parse-feed(FEED &optional GROUP)
nnfeed--print-content(CONTENT ATTRIBUTES LINKS)
nnfeed--print-part(CONTENT HEADERS MIME LINKS)
nnfeed--read-server(SERVER)
nnfeed--server-address(SERVER)
nnfeed--server-file(SERVER)
nnfeed--write-server(SERVER)
nnfeed-close-group(GROUP &optional SERVER)
nnfeed-close-server(&optional SERVER DEFS)
nnfeed-define-basic-backend-interface(BACKEND)
nnfeed-open-server(SERVER &optional DEFS BACKEND)
nnfeed-request-article(ARTICLE &optional GROUP SERVER TO-BUFFER)
nnfeed-request-group(GROUP &optional SERVER FAST INFO)
nnfeed-request-group-description(GROUP &optional SERVER)
nnfeed-request-list(&optional SERVER)
nnfeed-request-list-newsgroups(&optional SERVER)
nnfeed-request-post(&optional SERVER)
nnfeed-request-rename-group(GROUP NEW-NAME &optional SERVER)
nnfeed-request-type(GROUP &optional ARTICLE)
nnfeed-retrieve-article(ARTICLE GROUP)
nnfeed-retrieve-groups(GROUPS &optional SERVER)
nnfeed-retrieve-headers(ARTICLES &optional GROUP SERVER FETCH-OLD)
nnfeed-server-opened(&optional SERVER)
nnfeed-status-message(&optional SERVER)

Defined faces (0)