Skip to main content
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

Release files for libgravatar 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for libgravatar 1.0.4
File Size Uploaded
libgravatar-1.0.4.tar.gz 17.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for libgravatar 1.0.4
File Interpreter ABI Platform
libgravatar-1.0.4-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 34.5 kB

Release files / libgravatar-1.0.4.tar.gz

Download URL libgravatar-1.0.4.tar.gz
Size 17.0 kB
Tags Source
SHA-256 checksum
How to use checksums
05cf4f8dfefe995d09078cd3d747c8f04dcf17d6004fc7bb542049a55f2238d9
BLAKE2b-256 checksum
How to use checksums
c3e73e9c8d596dfad798be22ffa731dfc2ac8b5f72728a4beca56d722c07df6f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.2

Release files / libgravatar-1.0.4-py2.py3-none-any.whl

Download URL libgravatar-1.0.4-py2.py3-none-any.whl
Size 17.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
f967619b38914e0f941e53387881005e43929814571103f6bbfa2afd75045e20
BLAKE2b-256 checksum
How to use checksums
7ccc1c5f1d887800035bf0c93f204190ae26f859ab0e00f7ff523324395716b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.11.2

Release history Release notifications | RSS feed

This release

1.0.4 This release

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

1 release file

0.2.1

1 release file

0.2.0

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page