Skip to main content

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.

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 poetry run python -m unittest discover tests.

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

canonicalwebteam.flask_base-0.3.0.tar.gz (3.6 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file canonicalwebteam.flask_base-0.3.0.tar.gz.

File metadata

  • Download URL: canonicalwebteam.flask_base-0.3.0.tar.gz
  • Upload date:
  • Size: 3.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.16 CPython/3.6.7 Linux/4.18.0-21-generic

File hashes

Hashes for canonicalwebteam.flask_base-0.3.0.tar.gz
Algorithm Hash digest
SHA256 6ca5316052a4bc3624d316401babefca1d20b25699f73b2cc18c03454819b635
MD5 85c5d5173ee358466452e107b22166d8
BLAKE2b-256 da14ef9767bcb2604aab20d16b0e69aa750dcab3879c525df40897007ced855e

See more details on using hashes here.

File details

Details for the file canonicalwebteam.flask_base-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for canonicalwebteam.flask_base-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e344904ed556b6b5e0247ebcdbcef1e9b3c8c8ee6290fd1e24a49df396d7f0fc
MD5 d7396b72b962c82b52c3e46e2fbeed31
BLAKE2b-256 d1e7e16ded992682eb44c7350db58a48ac7d37d84877a9324dc4beb84d1e967e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page