ap-rss-reader

AP RSS-reader with CLI.


Keywords
rss, reader, console, application
License
MIT
Install
pip install ap-rss-reader==0.0.3

Documentation

AP RSS-reader

License: MIT PRs Welcome Python: 3.8+ MyPy pre-commit.ci status Imports: isort Code style: black Run tests codecov Requirements Status

Installation

The project has been tested only with python 3.8 on Ubuntu Linux and Windows 10. If you have python 3.8 and above installed in your machine, just install the AP RSS-reader from PyPI:

python --version
pip install ap-rss-reader

You can find source code of this package on github. See aplatkouski/ap-rss-reader repository.

How to use it

$ ap_rss_reader "https://news.yahoo.com/rss/" --limit 1

Feed: Yahoo News - Latest News & Headlines

Title: Nestor heads into Georgia after tornados damage Florida
Date: Sun, 20 Oct 2019 04:21:44 +0300
Link: https://news.yahoo.com/wet-weekend-tropical-storm-warnings-131131925.html


Links:
[1]: https://news.yahoo.com/wet-weekend-tropical-storm-warnings-131131925.html (link)
[2]: http://l2.yimg.com/uu/api/res/1.2/Liyq2kH4HqlYHaS5BmZWpw--/YXBwaWQ9eXRhY2h5b247aD04Njt3PTEzMDs-/https://media.zenfs.com/en/ap.org/5ecc06358726cabef94585f99050f4f0 (image)

Utility provides the following interface:

usage: ap_rss_reader [-h] [--limit LIMIT] [--verbose] [--version] [--json] source

AP RSS-reader with CLI.

positional arguments:
  source         RSS URL

optional arguments:
  -h, --help     show this help message and exit
  --limit LIMIT  Limit news topics if this parameter provided
  --verbose      Provides additional details as to what the program is doing
  --version      Shows the version of the program and exits
  --json         Print result as JSON in stdout

In case of using --json argument utility converts the news into JSON format:

{
  "channel_items": [
    {
      "date": "2021-05-30 12:19:27",
      "link": "https://news.yahoo.com/mexico-cartels-hunting-down-police-121927049.html",
      "media_content_url": "https://s.yimg.com/uu/api/res/1.2/laxRlIvAURG7aPTJU6a.Cw--~B/aD0zNjQ4O3c9NTQ3MjthcHBpZD15dGFjaHlvbg--/https://media.zenfs.com/en/ap.org/cdd01711ada54152f19140789ed6fcb4",
      "source": "Associated Press",
      "source_url": "http://www.ap.org/",
      "title": "In Mexico, cartels are hunting down police at their homes"
    }
  ],
  "title": "Yahoo News - Latest News & Headlines"
}

With the argument --verbose your program prints all logs in stdout.

Development & Contributing

Development of this happens on GitHub, patches including tests, documentation are very welcome, as well as bug reports!

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.

See also our CONTRIBUTING.md.

Copyright

Copyright (c) 2021 Artsiom Platkouski. ap-rss-reader is licensed under the MIT License - see the LICENSE.txt file for details.