Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rroemhild/lavatar
LDAP-backend avatar server
https://github.com/rroemhild/lavatar
avatar avatar-service flask ldap python
Last synced: about 2 months ago
JSON representation
LDAP-backend avatar server
- Host: GitHub
- URL: https://github.com/rroemhild/lavatar
- Owner: rroemhild
- License: mit
- Created: 2012-11-29T18:51:56.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2019-09-18T15:58:15.000Z (over 5 years ago)
- Last Synced: 2024-10-11T01:19:19.324Z (2 months ago)
- Topics: avatar, avatar-service, flask, ldap, python
- Language: Python
- Homepage:
- Size: 32.2 KB
- Stars: 10
- Watchers: 5
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.rst
- License: LICENSE
Awesome Lists containing this project
README
Lavatar
=======Lavatar is an LDAP-backend avatar server with `Gravatar `_ like URL support.
Lavatar fetches all email addresses from an LDAP server with a given search filter and stores them with their md5hash on Redis. Per defualt Lavatar also use Redis to cache the avatar images.
For now lavatar only support image requests.
Quick start
-----------You can use the docker container image and the docker-compose example to test this app:
.. code-block:: shell
wget https://raw.githubusercontent.com/rroemhild/lavatar/master/docker-compose.yml
docker-compose upand test in browser: http://localhost:5000/avatar/982391f62e589420d9fdb56a62c5e16c
Install
-------.. code-block:: shell
git clone https://github.com/rroemhild/lavatar.git
cd lavatar
pip install -r requirements.txt gevent
cp lavatar/default_settings.py settings.pyConfigure lavatar in settings.py and run ``python production.py`` example.
Image Request
-------------The default image size for the base request is 80x80, max size limit is 1024x1024.
.. code-block:: shell
http://localhost:5000/avatar/HASH
Set ``s`` or ``size`` to scale the avatar image
.. code-block:: shell
http://localhost:5000/avatar/HASH?s=160
Set ``d`` or ``default`` for the default image available in ``static/img``.
.. code-block:: shell
http://localhost:5000/avatar/HASH?d=keyword
Set ``m`` or ``method`` to resize Image with the specified method: 'crop', 'cover', 'contain', 'width', 'height' or 'thumbnail'. Default is ``thumbnail``
.. code-block:: shell
http://localhost:5000/avatar/HASH?s=120&m=cover
Set ``w`` or ``width`` to resize width and ``h`` or ``height`` to resize height.
.. code-block:: shell
http://localhost:5000/avatar/HASH?h=120&m=height