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.1.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

File details

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

File metadata

  • Download URL: canonicalwebteam.flask_base-0.3.1.tar.gz
  • Upload date:
  • Size: 3.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/0.12.16 CPython/3.6.5 Linux/4.15.0-52-generic

File hashes

Hashes for canonicalwebteam.flask_base-0.3.1.tar.gz
Algorithm Hash digest
SHA256 d3c598a40fb01fcbab04250c863f772e2918ca2b7cad87117d60b285f545dfbe
MD5 1bae83e2b56f9d30e70fb8f679712786
BLAKE2b-256 87f459f985061b4f00042013c9c0fea4a9b8a58a4d4573bd03f5885a7840d416

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for canonicalwebteam.flask_base-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2e34cb2027a5b8ec1106fa0c5841952a5bcec2e79fa2d6facd2e25bb821a85a8
MD5 c2780af2a40fe6668b172b1b3a9df6e2
BLAKE2b-256 2abe2d9e33df6dc34d2159830e0e31543a6b1fb9f0d236b2699bd7c452ed0a66

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