Metadata-Version: 2.0
Name: Flask-Gravatar
Version: 0.4.2
Summary: Small extension for Flask to make usage of Gravatar service easy.
Home-page: https://github.com/zzzsochi/Flask-Gravatar/
Author: Alexander Zelenyak aka ZZZ
Author-email: zzz.sochi@gmail.com
License: BSD
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Flask
Provides-Extra: docs
Requires-Dist: sphinx; extra == 'docs'

================
 Flask Gravatar
================

.. image:: https://travis-ci.org/zzzsochi/flask-gravatar.png?branch=master
    :target: https://travis-ci.org/zzzsochi/flask-gravatar
.. image:: https://coveralls.io/repos/zzzsochi/flask-gravatar/badge.png?branch=master
    :target: https://coveralls.io/r/zzzsochi/flask-gravatar
.. image:: https://pypip.in/v/Flask-Gravatar/badge.png
    :target: https://pypi.python.org/pypi/Flask-Gravatar/
.. image:: https://pypip.in/d/Flask-Gravatar/badge.png
    :target: https://pypi.python.org/pypi/Flask-Gravatar/

About
=====

This is small and simple integration `gravatar`_ into `flask`_.

.. _flask: http://flask.pocoo.org
.. _gravatar: http://gravatar.com

Installation
============

Flask-Gravatar is on PyPI so all you need is: ::

    pip install Flask-Gravatar

Documentation
=============

Initialize with flask application and default parameters: ::

    gravatar = Gravatar(app,
                        size=100,
                        rating='g',
                        default='retro',
                        force_default=False,
                        use_ssl=False,
                        base_url=None)

Then in your template: ::

    {{ 'zzz.sochi@gmail.com' | gravatar }}

Bigger and adult: ::

    {{ 'zzz.sochi@gmail.com' | gravatar(size=200, rating='x') }}

Parameters
----------

All parameters are described in `gravatar documentation`_.

.. _gravatar documentation:  http://gravatar.com/site/implement/images

Testing
=======
Running the test suite is as simple as: ::

    python setup.py test

or, to also show code coverage: ::

    ./run-tests.sh


