Metadata-Version: 2.1
Name: feedendum
Version: 0.1.0
Summary: Utilities to read and write RSS and Atom feeds.
Home-page: https://github.com/timendum/feedendum
Author: Timendum
Author-email: timendum@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Text Processing :: Markup :: XML
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.7.0
Description-Content-Type: text/markdown
Requires-Dist: lxml
Provides-Extra: http
Requires-Dist: requests ; extra == 'http'


# feedendum
A python library to parse and generate RSS or atom feeds.

## Features

This module can:

* parse RSS text and file
* parse Atom text and file
* read an url if `requests` is installed
* access standard fields via `feed` class and `feed.item` list
* access non-standard fields via `_data` dict
* create arbitrary feed
* modify an existing feed
* generate a RSS text
* generate an Atom text
* preserve all data parsed, even in custom fields, when generating a RSS/Atom text

## Usage

### Parsing a file

For RSS:

    feed = feedendum.from_rss_file(file_path)
    feed = feedendum.from_rss_text(txt)

For Atom:

    feed = feedendum.from_atom_file(file_path)
    feed = feedendum.from_atom_text(txt)

### Accessing to parsed data

Standard fields:

    print("Title", feed.title)
    print("First entry title", feed.items[0].title)

For other fields, not defined in `Feed` class:

    print("Extra attributes in the feed", feed._data)
    print("Extra attributes in the first entry", feed.items[0]._data)

### Writing a file

For RSS:

    feedendum.to_rss_string(feed)

For Atom:

    feedendum.to_atom_string(feed)




