Project: feedparser

Universal feed parser, handles RSS 0.9x, RSS 1.0, RSS 2.0, CDF, Atom 0.3, and Atom 1.0 feeds

Project Details

Latest version
6.0.11
Home Page
https://github.com/kurtmckee/feedparser
PyPI Page
https://pypi.org/project/feedparser/

Project Popularity

PageRank
0.006303244758476297
Number of downloads
2279153

.. This file is part of feedparser. Copyright 2010-2023 Kurt McKee contactme@kurtmckee.org Copyright 2002-2008 Mark Pilgrim Released under the BSD 2-clause license.

feedparser ##########

Parse Atom and RSS feeds in Python.


Installation

feedparser can be installed by running pip:

.. code-block:: console

$ pip install feedparser

Documentation

The feedparser documentation is available on the web at:

https://feedparser.readthedocs.io/en/latest/

It is also included in its source format, ReST, in the docs/ directory. To build the documentation you'll need the Sphinx package, which is available at:

https://www.sphinx-doc.org/

You can then build HTML pages using a command similar to:

.. code-block:: console

$ sphinx-build -b html docs/ fpdocs

This will produce HTML documentation in the fpdocs/ directory.

Testing

Feedparser has an extensive test suite, powered by tox. To run it, type this:

.. code-block:: console

$ python -m venv venv
$ source venv/bin/activate  # or "venv\bin\activate.ps1" on Windows
(venv) $ pip install -r requirements-dev.txt
(venv) $ tox

This will spawn an HTTP server that will listen on port 8097. The tests will fail if that port is in use.