Metadata-Version: 1.1
Name: diffbot
Version: 1.1.2
Summary: Python client for the Diffbot API.
Home-page: https://github.com/attilaolah/diffbot.py
Author: Attila Oláh
Author-email: attilaolah@gmail.com
License: MIT
Description: Python `Diffbot <https://www.diffbot.com>`__ API
        ================================================
        
        |Bitdeli| |Build Status| |Coverage Status| |Dependency Status|
        
        How to use it:
        
        .. code:: python
        
            >>> import diffbot
            >>> json_result = diffbot.article('https://github.com', token='…')
        
        The above simple example is a shortcut for using the ``diffbot.Client``
        class.
        
        .. code:: python
        
            >>> 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:
        
        .. code:: python
        
            >>> 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:
        
        .. code:: python
        
            >>> 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:
        -----------------------
        
        .. code:: sh
        
            $ 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' or 'analyze'.
              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.
        
        .. code:: bash
        
            $ python diffbot.py article https://github.com TOKEN
        
        .. code:: json
        
            {
              "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 <http://docs.python-requests.org>`__ support (but no
           dependency)
        -  `CI <https://travis-ci.org/attilaolah/diffbot.py>`__ + `100% test
           coverage <https://coveralls.io/r/attilaolah/diffbot.py>`__
        -  Passes ``pyflakes``, ``pep8``, ``flake8``, ``pylint`` score 10/10
        -  Simple & small (1 file, ~100 LOC)
        -  `Command line interface <#command-line-interface>`__
        
        .. |Bitdeli| image:: https://d2weczhvl823v0.cloudfront.net/attilaolah/diffbot.py/trend.png
           :target: https://bitdeli.com/free
        .. |Build Status| image:: https://travis-ci.org/attilaolah/diffbot.py.png?branch=master
           :target: https://travis-ci.org/attilaolah/diffbot.py
        .. |Coverage Status| image:: https://coveralls.io/repos/attilaolah/diffbot.py/badge.png
           :target: https://coveralls.io/r/attilaolah/diffbot.py
        .. |Dependency Status| image:: https://gemnasium.com/attilaolah/diffbot.py.png
           :target: https://gemnasium.com/attilaolah/diffbot.py
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Libraries
