from mcnews.searchapi import SearchApiClient
import datetime as dt

api = SearchApiClient("mediacloud")
api.count("coronavirus", dt.datetime(2022, 3, 1), dt.datetime(2022, 4, 1))

Paging over all matching results:

from mcnews.searchapi import SearchApiClient
import datetime as dt

api = SearchApiClient("mediacloud")
for page in api.all_articles("coronavirus", dt.datetime(2022, 3, 1), dt.datetime(2022, 4, 1)):
    do_something(page)

Dev Installation

Install the dependencies for dev: pip install -e .[dev]

Distribution

Run pytest to make sure all the test pass
Update the version number in mcnews/__init__.py
Make a brief note in the version history section below about the changes
Commit the changes
Tag the commit with a semantic version number - 'v*..'
Push to repo to GitHub
Run python setup.py sdist to create an installation package
Run twine upload --repository-url https://test.pypi.org/legacy/ dist/* to upload it to PyPI's test platform
Run twine upload dist/* to upload it to PyPI

Version History

v2.0.0 - Fresh start as mediacloud-news-client
v1.2.1 - fix paging bug triggered by no results
v1.2.0 - add support for new expanded results, and more integration testing
v1.1.0 - add new paged_articles method to allow paging over all results
v1.0.3 - add 30 sec timeout, remove extra params mcproviders library might be adding
v1.0.2 - fix to article endpoint
v1.0.1 - automatically escape '/' in query strings, test case for url field search
v1.0.0 - update to public API endpoint
v0.1.5 - simpler return for top terms
v0.1.4 - better error handling
v0.1.3 - allow overriding base api URL
v0.1.2 - fix article endpoint, test case for fetching content (snippet) via article_url property
v0.1.1 - more consistent method names
v0.1.0 - initial test-only release

FAQs

What is mediacloud-news-client?

Is mediacloud-news-client well maintained?

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install