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)