Python client for the Diffbot API.
Project description
How to use it:
>>> import diffbot >>> json_result = diffbot.article('https://github.com', token='…')
The above simple example is a shortcut for using the diffbot.Client class.
>>> import diffbot >>> client = diffbot.Client(token='…') >>> json_result = client.article('https://github.com')
The above calls are shortcuts for using the diffbot.api() function and the diffbot.Client.api method:
>>> import diffbot >>> client = diffbot.Client(token='…') >>> json_result = client.api('article', 'https://github.com')
To POST data (text or HTML) to the API, use the text or html arguments:
>>> import diffbot >>> client = diffbot.Client(token='…') >>> json_result = client.api('article', 'https://github.com', html=''' ... <h1>Introducing GitHub Traffic Analytics</h1> ... <p>We want to kick off 2014 with a bang, so today we're happy to launch ... traffic analytics!</p> ... ''')
Command line interface:
$ python diffbot.py -h usage: diffbot.py [-h] [-a] [-f FILE] api url token positional arguments: api API to call. One one of 'article', 'frontpage', 'product', 'image', 'analyze' or 'discussion'. url URL to pass as the 'url' parameter. token API key (token). Get one at https://www.diffbot.com/. optional arguments: -h, --help show this help message and exit -a, --all Request all fields. -f FILE, --file FILE File to read data from. Use '-' to read from STDIN. $ python diffbot.py article https://github.com TOKEN
Output of the above example:
{ "icon": "https://github.com:443/apple-touch-icon-144.png", "sections": [ … ], "title": "Build software better, together.", "url": "https://github.com/" }
Features:
- Python 2+3 support
- Google App Engine support
- Requests support (but no dependency)
- Passes pyflakes, pep8, flake8, pylint score 10/10
- Simple & small (1 file, <200 LOC)
- Command line interface
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
diffbot-2.0.0.tar.gz
(5.1 kB
view hashes)