Flask-avatars Sets the avatar in the Flask project

This article belongs to the Flask Common Extensions Introduction series, and an index of the contents of this series can be found in the Flask Common Extensions Introduction Series Index.

Flask-Avatars

Most Web applications involve the implementation of an avatar. Different types of projects require different avatars. Some projects can use Gravatar directly, while others require custom avatars. Flask-avatars has almost all the usual Avatars requirements:

• The default avatar
• them
• Robohash avatar
• Social networking profile picture
• Generate Identicon random pattern head
• Picture cropping head

GitHub homepage: github.com/greyli/flas…

Installation and initialization

Install with PIP:

$ pip install flask-avatarsCopy the code

Like other extensions, you need to instantiate the Avatars class imported from Flask_Avatars and pass in the app instance:

from flask_avatars import Avatars

app = Flask(__name__)
avatars = Avatars(app)Copy the code

The default avatar

Flask-avatars has several default Avatars built in, which can be used as a user’s initial Avatars after signing up, or as a blog commenter’s Avatars. Call avatars.default() in the template to get the URL:

<img src="{{ avatars.default() }}">Copy the code

You can set the size using the size parameter. The default value is m. Other options are L and S. An example of an actual call is as follows:

Gravatar

To get a gravatar(gravatar.com), call avatars.gravatar() and pass in the Email hash value:

<img src="{{ avatars.gravatar(email_hash) }}">Copy the code

The Email hash value can be obtained as follows:

import hashlib

avatar_hash = hashlib.md5(my_email.lower().encode('utf-8')).hexdigest()Copy the code

An example of an actual call is as follows:

Robohash

Robohash (robohash.org) is a service that generates random robot avatars (this type is currently supported in the default Gravatar avatar, which can be obtained by setting the default parameter to Robohash). To get the avatar URL of RoboHash, call avatars.robohash() in the template and pass random text as an argument:

<img src="{{ avatars.robohash(some_text) }}">Copy the code

An example of an actual call is as follows:

Social networking profile picture

Flask-avatars offers a social avatar acquisition service via Avatars.io and currently supports Facebook, Twitter, Instagram and Gravatar. Call avatars.social_media() in the template and pass in the username (username) to get the corresponding avatar URL. The size parameter can be used to set the size. The optional values are small, medium, and large:

<img src="{{ avatars.social_media(username) }}">Copy the code

The platform parameter allows you to set the platform. The default is Twitter, and the optional values are Twitter, Facebook, Instagram, and gravatar:

<img src="{{ avatars.social_media(username, platform='facebook') }}">Copy the code

An example of an actual call is as follows:

Generate Identicon random pattern head

The Gravatar service may have unstable conditions, in which case you can generate an avatar for the user locally (Identicon). Here is a simple example:

app.config['AVATARS_SAVE_PATH '] = 'the/path/to/save/avatar'Avatar = Identicon() filenames = avatar. Generate (text= 'a string of only characters')Copy the code

AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE: AVATARS_SIZE_TUPLE You can save the filename to the database and create a view function to provide the avatar file:

from flask import send_form_directory, current_app

@app.route('/avatars/<path:filename>')
def get_avatar(filename):
    return send_from_directory(current_app.config['AVATARS_SAVE_PATH'], filename)Copy the code

The following is an example of the generated profile picture:

Cutting head

Flask-avatars provides the image cropping function based on Jcrop. For details, please refer to the documentationRelevant part. Here is the cropped page in the sample program:

Cropped results:

configuration

Flask-avatars supports the following configuration list:

The sample program

Flask-avatars Git repository contains three instance programs, which correspond to the screenshot in this article:

• Examples/Basic – Basic examples
• Examples /identicon — identicon example
• Examples /crop — clipping examples

You can run the instance as follows:

$ git clone https://github.com/greyli/flask-avatars.git
$ cd flask-avatars/examples
$ pip install flask flask-avatars
$ cd basic  Switch to the identicon and Crop directories to run the corresponding sample programs
$ flask runCopy the code

A link to the

• GitHub homepage: github.com/greyli/flas…
• Flask, series index extensions zhuanlan.zhihu.com/p/39183712
• Them API:en.gravatar.com/site/implem…