AsyncIO Python wrapper to News API
Project description
asyncnewsapi
An asyncio Python library to perform request against News API. It provides direct access to the endpoints defined in the documentation.
Two classes are implemented, returning async iterators for the request results. Session will return an iterator through the results of a single request. Alternatively, Stream will return an infinite iterator, performing successive requests and continuing to iterate through the results. A minimal implementation can be as simple as:
import asyncio
from asyncnewsapi import Session
async def main():
async with Session() as api:
async for article in api.top_headlines(language='en'):
print(article['title'])
if __name__ == '__main__':
asyncio.run(main())
The API key should be provided as an environment variable named NEWSAPI_KEY:
export NEWSAPI_KEY="..."
Go to the NewsAPI website to create a free API key.
This library is loosely based on / inspired by newsapi-python, a requests based library by Matt Lisivick.
Installation
Use pip to install this package, either directly from pypi:
pip install asyncnewsapi
or after cloning from github:
pip install .
Tests
Unit tests have been implemented using pytest. To run them, additional dependencies need be installed:
pip install ".[test]"
The tests can then be run using:
python -m pytest -v tests/
from the root of the repo (running it explicitly on the tests/ directory avoids interference with the venv folders).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for asyncnewsapi-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54abb36ddd9548b011e0ae8ec885002be469c9f0c8bc38ca771f2d74e1f97366 |
|
MD5 | 5d8604fe86823fc613dc886bfd6d63bd |
|
BLAKE2b-256 | 42d60ce0c053427d0d0f2bfc107cabb0ce7a19d9343f23dabed701be54d1ba99 |