RSS reader

RSS reader is a command-line utility that receives RSS URL and prints results in a human-readable format.

Installing

For install come to the root of repository and type:

pip3 install .

or

python3 setup.py install

Usage

Utility provide the following interface:

rss_reader [-h] [--version] [--json] [--verbose] [--limit LIMIT] 

• positional arguments:

  • source RSS URL

• optional arguments:

  • -h, --help show this help message and exit
  • --version Print version info
  • --json Print result as JSON in stdout
  • --verbose Outputs verbose status messages
  • --limit LIMIT Limit news topics if this parameter provided
  • --date DATE Returns news for requested date and source if this parameter provided. Date format is YYYYmmdd
  • --to-fb2 PATH Convert feed to fb2 format and save to given file path
  • --to-html PATH Convert feed html format and save to given file path

Notes:

• JSON schema described in json_feed.json.
• By default log messages writes to home/.rss/rss_reader.log, with --verbose argument messages prints to stdout too.
• Can run the application by python3 rss_reader
  or python3 rss_reader/main.py from the root of the repository.

Testing

To test come to root directory of the repository and type

 python3 tests 

Caching

From version 3.0 all RSS feeds stored in local SQLite database while reading. You can find a database in /home/.rss/feeds.db.

The cashed news can be read by optional argument --date. The news from the specified day and source will be printed out. If the news is not found returns an error.

Converting

From version 4.0 added converting news to fb2 and html files. Files saves by path given after optional argument --to-fb2 or --to_html. These arguments can be used together. Given path should include the file name and only exist directories.

Example: rss_reader https://source.net/rss --to-fb2 ~/feed.fb2 --to-html ~/feed.html