An RSS/Atom parser, because there's nothing else out there.

Dependencies

pugixml
pybind11 for the python bindings
python3 if you intend on using or building the python bindings
tidy
fmt

Build dependencies

meson

Build options:

Option	Type	Description	Default
`profile`	string, can either be `release` or `debug`	`release` disables assertions, `debug` enables debug symbols	`release`
`python_bindings`	bool	build the python bindings	`true`
`to_json_binary`	bool	build the binary defined by `src/main.cpp`, see Usage for more info.	`false`

Usage

You can use the run.sh script to build and run the main program. Follow the usage guide provided by the program itself.

Documentation

You can build the documentation with doxygen Doxyfile.

An online version tracking the master branch is available on GitLab pages.

Using the python bindings

You'll need to build using the option -Dpython_bindings=true (which should be enabled by default regardless).

Then either add the install directory to your python path, or install the library in your existing python path.

The module name is syndom.

The python interface exposes the following classes:

Of these, only Feed, Opml and Html can be instanced directly, this is because FeedItem and OpmlItem are instanced when creating Feed and Opml as their items.

The API is the same as described in the documentation for C++, with the addition of read-only properties as an alternative to the getter methods. For example to get a FeedItem's title you can either call my_feed_item.get_title() or simply my_feed_item.title.

License notice

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.