A simple Tag to implement Feather Icons in Flask
Project description
Flask Feather
A simple Tag ({% icon "name" %}
) to implement Feather Icons in Flask. This is largely based of the library django_feather by Jonas Drotleff.
Install
Install flask-feather
using pip
.
pip install flask-feather
Quick Start
Firstly, initialise the extension within your Flask context
from flask_feather import Feather
feather = Feather(app)
This extension also supports the Flask application factory pattern by allowing you to create a Feather object and then initialised it separately for an app:
feather = Feather()
def create_app(config):
app = Flask(__name__)
app.config.from_object(config)
feather.init_app(app)
Advanced setup
In addition to the wonderful icons provided in the feather set, you can supply your own svg icons, to attempt to parse them and use them in the same format. Simply initialise the extension with a directory containing .svg files that are similar in style to the feather ones. They should resemble the feather icon style as near as possible - any significant differences in formatting/structure may result in unexpected errors.
feather = Feather(import_dir='app\\static\\customsvg')
def create_app(config):
app = Flask(__name__)
app.config.from_object(config)
feather.init_app(app)
Usage
It's pretty simple to use this package. From within a jinja template:
<p>{{ feather.icon('icon-name', width=32, height=32) }}</p>
If the property you're modifying has a hyphen, use an underscore instead. You can refer to icon names with either hyphens or underscores.
<p>{{ feather.icon('icon-name', stroke_width=2) }}</p>
The icon
function takes the SVG source from the Feather project, applies additional attributes and return the SVG tag.
Performance
flask-feather
borrows the application structure from django-feather
and does not read the .svg
files each time an icon is rendered. Instead, on installation, all the icons are written to a .py
file.
All icons are rendered on the server side, avoiding the need to call feather.replace()
after the page has loaded.
Any custom icons are parsed each time the server is restarted, and not every time they're loaded.
License
Feather is licensed under the MIT License.
flask-feather
is a derivative work of django-feather
, both of which are licensed under the Apache License, Version 2.0:
Modifications Copyright 2020 Tom Vos <tjvos1@gmail.com>
Original Django-feather Copyright 2020 Jonas Drotleff <j.drotleff@desk-lab.de>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for flask_feather-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 04e976f7ec598e98a0445ca8fe7cf167fa9bfd5a2cf852395a27331d7a51c8d4 |
|
MD5 | 2c86161b5be1c8374dcf6fce95b12fb7 |
|
BLAKE2b-256 | e79fbcb1c0e9d9d53002789b694998ea0f79639a28be712fcf79abb01028b70c |