No project description provided
Project description
Canonical Webteam Flask-Base
Flask extension that applies common configurations to all of webteam's flask apps.
Usage
from canonicalwebteam.flask_base.app import FlaskBase
app = FlaskBase(__name__, "app.name")
Or:
from canonicalwebteam.flask_base.app import FlaskBase
app = FlaskBase(
__name__,
"app.name",
template_404="404.html",
template_500="500.html",
favicon_url="/static/favicon.ico",
)
Features
Redirects and deleted paths
FlaskBase uses yaml-responses to allow easy configuration of redirects and return of deleted responses, by creating redirects.yaml, permanent-redirects.yaml and deleted.yaml in the site root directory.
Error templates
FlaskBase can optionally use templates to generate the 404 and 500 error responses:
app = FlaskBase(
__name__,
"app.name",
template_404="404.html",
template_500="500.html",
)
This will lead to e.g. http://localhost/non-existent-path returning a 404 status with the contents of templates/404.html.
Redirect /favicon.ico
FlaskBase can optionally provide redirects for the commonly queried paths /favicon.ico, /robots.txt and /humans.txt to sensible locations:
from canonicalwebteam.flask_base.app import FlaskBase
app = FlaskBase(
__name__,
"app.name",
template_404="404.html",
template_500="500.html",
favicon_url="/static/favicon.ico",
robots_url="/static/robots.txt",
humans_url="/static/humans.txt"
)
This will lead to e.g. http://localhost/favicon.ico returning a 302 redirect to http://localhost/static/favicon.ico.
Jinja2 helpers
You get two jinja2 helpers to use in your templates from flask-base:
nowis a function that outputs the current date in the passed format -{{ now('%Y') }}->YYYYversioned_staticis a function that fingerprints the passed asset -{{ versioned_static('asset.js') }}->static/asset?v=asset-hash
robots.txt and humans.txt
If you create a robots.txt or humans.txt in the root of your project, these will be served at /robots.txt and /humans.txt respectively.
Generating setup.py
In this project, for the time being, we maintain both a pyproject.toml for Poetry and a setup.py for traditional Python tooling. If you are developing on the module, you should update pyproject.toml first and then regenerate the setup.py using:
poetry install
poetry run poetry-setup
Tests
To run the tests execute SECRET_KEY=fake poetry run python -m unittest discover tests.
Release history Release notifications | RSS feed
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
File details
Details for the file canonicalwebteam.flask_base-0.5.0.tar.gz.
File metadata
- Download URL: canonicalwebteam.flask_base-0.5.0.tar.gz
- Upload date:
- Size: 4.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.0 CPython/3.6.9 Linux/5.3.0-45-generic
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a1840c4c3239364f26f697bf34dfab2ae7ccaaed7aca1ecfa9d5ff099413de77 |
|
| MD5 | bda3700c00ca3b6c798aa53894877df4 |
|
| BLAKE2b-256 | c06a84741f102d7e2516220d83a93d673c69f4e82c6239d48c42d654e3665ecc |
File details
Details for the file canonicalwebteam.flask_base-0.5.0-py3-none-any.whl.
File metadata
- Download URL: canonicalwebteam.flask_base-0.5.0-py3-none-any.whl
- Upload date:
- Size: 5.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.0 CPython/3.6.9 Linux/5.3.0-45-generic
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3ff3b7ded4b703abc04fad519b683703af52c2ecd9eb5f4454738fafb8516b8e |
|
| MD5 | 95a63ea3f7d2dcf29037e90d481cc724 |
|
| BLAKE2b-256 | 86ce33f4ea9becee01a89fd306cf19c8b41c9c27a0fbb1389f297f6c1ac2cff0 |
