Skip to main content

AP RSS-reader with CLI.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ap_rss_reader-0.0.2.tar.gz (15.6 kB view hashes)

Uploaded Source

Built Distribution

ap_rss_reader-0.0.2-py2.py3-none-any.whl (9.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page