Metadata-Version: 2.1
Name: libgravatar
Version: 0.2.3
Summary: A library that provides a Python 3 interface for the Gravatar API.
Home-page: https://github.com/pabluk/libgravatar
Author: Pablo SEMINARIO
Author-email: pabluk@gmail.com
License: GNU General Public License v3 (GPLv3)
Project-URL: Bug Reports, https://github.com/pabluk/libgravatar/issues
Project-URL: Source, https://github.com/pabluk/libgravatar
Project-URL: Documentation, https://libgravatar.readthedocs.io
Keywords: gravatar
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/x-rst

===========
libgravatar
===========


.. image:: https://travis-ci.org/pabluk/libgravatar.png?branch=master
        :target: https://travis-ci.org/pabluk/libgravatar

A library that provides a Python 3 interface for the Gravatar API.
API details: https://en.gravatar.com/site/implement/

Installation
------------

Install via pip::

    $ pip install libgravatar


Usage
-----

See more details on https://libgravatar.readthedocs.org/

Gravatar API
~~~~~~~~~~~~

Gravatar API require no authentication to get images and profiles URLs.

Getting the user profile image::

    from libgravatar import Gravatar
    g = Gravatar('myemailaddress@example.com')
    g.get_image()
    'http://www.gravatar.com/avatar/0bc83cb571cd1c50ba6f3e8a78ef1346'

Getting the profile URL::

    from libgravatar import Gravatar
    g = Gravatar('myemailaddress@example.com')
    g.get_profile()
    'http://www.gravatar.com/0bc83cb571cd1c50ba6f3e8a78ef1346'


Gravatar XML-RPC API
~~~~~~~~~~~~~~~~~~~~

The XML-RPC API require authentication.

You can use your Gravatar.com password::

    from libgravatar import GravatarXMLRPC
    g = GravatarXMLRPC('user@domain', password='1234')
    g.test() # test the API


or if you have an account at Wordpress.com you can use your API Key::

    from libgravatar import GravatarXMLRPC
    g = GravatarXMLRPC('user@domain', apikey='1234')
    g.test() # test the API


Author and contributors
-----------------------

* Pablo SEMINARIO (`@pabluk <https://github.com/pabluk>`_)
* Caleb FANGMEIER (`@cfangmeier <https://github.com/cfangmeier>`_)


