This repository has been archived by the owner. It is now read-only.
Python Avatar Picker for Avatars.io
Python
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit behind Zopieux:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
avatarsio updated the library to work with new data format that /v1/token expec… Aug 10, 2012
.gitignore
LICENCE.txt
README.md
VERSION
requirements.txt
setup.py Ready for publishing Jun 28, 2012

README.md

avatars-io-python

Python avatar picker and uploader for Avatars.io.

Current version of avatarsio is 0.1; it's stable.

Requirements, dependencies

avatarsio supports both Python 2 and Python 3 and is on PyPi.

As described in requirements.txt, the only dependency is requests (HTTP for humans, because, well, it is awesome and should be built-in).

You can install it from source or using pip (eg. in a virtualenv):

pip install avatarsio

Usage

You don't really need the lib if you just want to get user avatars from services such as Twitter of Facebook. Just use the corresponding URL as explained on avatars.io.

The lib is useful for custom avatar upload. You need first to register an app on Chute. Then, it's quite straightforward:

>>> from avatarsio import AvatarsIO
>>> avtio = AvatarsIO('my-client-id', 'my-access-token')

# With a file name:
>>> avtio.upload('kitten.png')
"http://avatars.io/4fb6de143d242d44da000001/hashashash"

# With a file object:
>>> fobj = open('kitten.png', 'rb')
>>> avtio.upload(fobj)
"http://avatars.io/4fb6de143d242d44da000001/hashashash"

# You can give a custom identifer:
>>> avtio.upload('kitten.png', 'my-identifier')
"http://avatars.io/4fb6de143d242d44da000001/my-identifier"

# And obviously, build sersvice avatar URLs:
# (but sersiouly, you don't need the lib for that)
>>> AvatarsIO.avatar_url('twitter', 'my-identifier')
"http://avatars.io/twitter/my-identifier"

Licence

MIT

Extra stuff

Feel free to submit bug reports and improvements on the bug tracker.