Metadata-Version: 2.1
Name: Flask-Gravatar
Version: 0.5.0
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
Keywords: flask gravatar
Platform: any
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Framework :: Flask
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Development Status :: 5 - Production/Stable
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: Flask >=0.10
Provides-Extra: all
Requires-Dist: Sphinx >=1.4.2 ; extra == 'all'
Requires-Dist: check-manifest >=0.25 ; extra == 'all'
Requires-Dist: coverage >=4.0 ; extra == 'all'
Requires-Dist: isort >=4.2.2 ; extra == 'all'
Requires-Dist: pydocstyle >=1.0.0 ; extra == 'all'
Requires-Dist: pytest-cache >=1.0 ; extra == 'all'
Requires-Dist: pytest-cov >=1.8.0 ; extra == 'all'
Requires-Dist: pytest-pep8 >=1.0.6 ; extra == 'all'
Requires-Dist: pytest >=2.8.0 ; extra == 'all'
Provides-Extra: docs
Requires-Dist: Sphinx >=1.4.2 ; extra == 'docs'
Provides-Extra: tests
Requires-Dist: check-manifest >=0.25 ; extra == 'tests'
Requires-Dist: coverage >=4.0 ; extra == 'tests'
Requires-Dist: isort >=4.2.2 ; extra == 'tests'
Requires-Dist: pydocstyle >=1.0.0 ; extra == 'tests'
Requires-Dist: pytest-cache >=1.0 ; extra == 'tests'
Requires-Dist: pytest-cov >=1.8.0 ; extra == 'tests'
Requires-Dist: pytest-pep8 >=1.0.6 ; extra == 'tests'
Requires-Dist: pytest >=2.8.0 ; extra == 'tests'

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

.. image:: https://img.shields.io/travis/zzzsochi/Flask-Gravatar.svg
        :target: https://travis-ci.org/zzzsochi/Flask-Gravatar

.. image:: https://img.shields.io/coveralls/zzzsochi/Flask-Gravatar.svg
        :target: https://coveralls.io/r/zzzsochi/Flask-Gravatar

.. image:: https://img.shields.io/github/tag/zzzsochi/Flask-Gravatar.svg
        :target: https://github.com/zzzsochi/Flask-Gravatar/releases

.. image:: https://img.shields.io/pypi/dm/Flask-Gravatar.svg
        :target: https://pypi.python.org/pypi/Flask-Gravatar

.. image:: https://img.shields.io/github/license/zzzsochi/Flask-Gravatar.svg
        :target: https://github.com/zzzsochi/Flask-Gravatar/blob/master/LICENSE

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


Changes
=======

Version 0.5.0 (released 2018-01-05)

- Try to read configuration values from application config if a context
  is available otherwise return an instance config or extension default.
  (pull #23)
- Package refresh - testing Python 3.6, fixed links, and much more.
  (pull #22)

Version 0.4.2 (released 2015-03-23)

- Set use_ssl default value according to request protocol. (pull #14)
- Improved documentation typo fixes. (pull #13 #18)
- Migration from flaskext.gravatar to flask_gravatar. (pull #11 #12)

Version 0.4.1 (released 2013-11-07)

- Added Python 3 support. (pull #9)

Version 0.4.0 (released 2013-08-09)

- Added custom url support. (pull #7)
- Use setuptools. (pull #6)

Version 0.3.0 (released 2013-03-23)

- Enabled registering multiple times in one process.

Version 0.2.4 (released 2012-11-28)

- Added init_app method.
- Fixed various bugs.

Version 0.2.3 (released 2011-11-29)

- Added HTTPS suppport.

Version 0.2.2 (released 2011-01-10)

- First public release.
- It works.
