Skip to main content

A library that provides a Python 3 interface for the Gravatar API.

Project description

https://github.com/pabluk/libgravatar/actions/workflows/python-package.yml/badge.svg

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 requires 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()
'https://www.gravatar.com/avatar/0bc83cb571cd1c50ba6f3e8a78ef1346'

Getting the profile URL:

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

Gravatar XML-RPC API

The XML-RPC API requires authentication.

You can use your Gravatar.com’s email and password:

from libgravatar import GravatarXMLRPC
g = GravatarXMLRPC('name@example.com', password='1234')
g.test() # test the API

or if you have an account at Wordpress.com you can use your email and API key. You can find your API key at https://apikey.wordpress.com/ just be sure to pass to the function your email instead of your username:

from libgravatar import GravatarXMLRPC
g = GravatarXMLRPC('name@example.com', apikey='1234')
g.test() # test the API

Development

To contribute to this project or to test this library locally you’ll need to install these dependencies:

python3 -m venv venv # for example on a virtual environment
source venv/bin/activate
pip install pytest black

and you can validate your changes running:

pytest --doctest-modules --verbose
black . --check --diff

Author and contributors

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

libgravatar-1.0.4.tar.gz (17.0 kB view details)

Uploaded Source

Built Distribution

libgravatar-1.0.4-py2.py3-none-any.whl (17.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file libgravatar-1.0.4.tar.gz.

File metadata

  • Download URL: libgravatar-1.0.4.tar.gz
  • Upload date:
  • Size: 17.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.2

File hashes

Hashes for libgravatar-1.0.4.tar.gz
Algorithm Hash digest
SHA256 05cf4f8dfefe995d09078cd3d747c8f04dcf17d6004fc7bb542049a55f2238d9
MD5 4753c43cd6e6a276198b45b0b5431ede
BLAKE2b-256 c3e73e9c8d596dfad798be22ffa731dfc2ac8b5f72728a4beca56d722c07df6f

See more details on using hashes here.

File details

Details for the file libgravatar-1.0.4-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for libgravatar-1.0.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f967619b38914e0f941e53387881005e43929814571103f6bbfa2afd75045e20
MD5 54f3316ffc351f3b66b4292639b3f5e3
BLAKE2b-256 7ccc1c5f1d887800035bf0c93f204190ae26f859ab0e00f7ff523324395716b8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page