Keg 0.8.3

CLI Command

The command <myapp> develop config will give detailed information about the files and objects being used to configure an application.

Profile Priority

All configuration classes with the name DefaultProfile will be applied to the app’s config first.

Then, the configuration classes that match the “selected” profile will be applied on top of the app’s existing configuration. This makes the settings from the “selected” profile override any settings from the DefaultProfile.

Practically speaking, any configuration that applies to the entire app regardless of what context it is being used in will generally go in myapp.config in the DefaultProfile class.

Selecting a Configuration Profile

The “selected” profile is the name of the objects that the Keg configuration handling code will look for. It should be a string.

A Keg app considers the “selected” profile as follows:

• If config_profile was passed into myapp.init() as an argument, use it as the selected profile. The --profile cli option uses this method to set the selected profile and therefore has the highest priority.

• Look in the app’s environment namespace for “CONFIG_PROFILE”. If found, use it.

• If running tests, use “TestProfile”. Whether or not the app is operating in this mode is controlled by the use of:

  • myapp.init(use_test_profile=True) which is used by MyApp.testing_prep()

  • looking in the app’s environment namespace for “USE_TEST_PROFILE” which is used by keg.testing.invoke_command()

• Look in the app’s main config file (app.config) and all it’s other config files for the variable DEFAULT_PROFILE. If found, use the value from the file with highest priority.

Blueprint Setup

Adding views to a blueprint is accomplished via the blueprint attribute on the view. Note, BaseView magic kicks in when the class is created, so assigning the blueprint later on will not currently have the desired effect.

import flask from keg.web import BaseView

blueprint = flask.Blueprint(‘routing’, __name__)

class VerbRouting(BaseView):

blueprint = blueprint

def get(self):

return ‘method get’

Once the blueprint is created, you must attach it to the app via the use_blueprints app attribute:

from keg.app import Keg from my_app.views import blueprint

class MyApp(Keg):

import_name = ‘myapp’ use_blueprints = (blueprint, )

Blueprints take some parameters for URL prefix and template path. BaseView will respect these when generating URLs and finding templates:

blueprint = flask.Blueprint(

‘custom’, __name__, template_folder=’../templates/specific-path’, url_prefix=’/tanagra’)

class BlueprintTest(BaseView):

# template “blueprint_test.html” will be expected in specific-path # endpoint is custom.blueprint-test # URL is /tanagra/blueprint-test blueprint = blueprint

def get(self):

return self.render()

Template Discovery

To avoid requiring the developer to configure all the things, BaseView will attempt to discover the correct template for a view, based on the view class name. Generally, this is a camel-case to underscore-notation conversion. Blueprint name is included in the path, unless the blueprint has its own template_path defined.

• class MyBestView in blueprint named “public” -> <app>/templates/public/my_best_view.html

• class View2 in blueprint named “other” with template path “foo” -> <app>/foo/view2.html

A view may be given a template_name attribute to override the default filename, although the same path is used for discovery:

class TemplateOverride(BaseView):

blueprint = blueprint template_name = ‘my-special-template.html’

def get(self):

return self.render()

URL and Endpoint Calculation

BaseView has calc_url and calc_endpoint class methods which will allow the developer to avoid hard-coding those types of values throughout the code. These methods will both produce the full URL/endpoint, including the blueprint prefix (if any).

Route Generation

BaseView will, by default, create rules for views on their respective blueprints. Generally, this is based on the view class name as a camel-case to dash-notation conversion:

• class MyBestView in blueprint named “public”: /my-best-view -> public.my-best-view

• class View2 in blueprint named “other” with URL prefix “foo”: /foo/view2 -> other.view2

Note that BaseView is a MethodView implementation, so methods named get, post, etc. will be respected as the appropriate targets in the request/response cycle.

A view may be given a url attribute to override the default:

class RouteOverride(BaseView):

blueprint = blueprint url = ‘/something-other-than-the-default’

def get(self):

return self.render()

See keg_apps/web/views/routing.py for other routing possibilities that BaseView supports.

Preview Readme

When updating the readme, use restview --long-description to preview changes.

Configuration Variables

This is not an exhaustive list of KEG_ specific configuration variables:

• KEG_DB_ENGINE_OPTIONS: Add additional engine options to the sqlalchemy.create_engine call when working with a database.

  KEG_DB_ENGINE_OPTIONS = {
      'json_serializer': flask.json.dumps,
      'json_deserializer': flask.json.loads,
  }

0.8.3 released 2019-11-29

• Remove Flask version pin (0b03f12)

0.8.2 released 2019-11-12

• fix bug in calculating URL with prefix-less blueprints (7d02b01)

0.8.1 released 2019-11-06

• Add basic component structure for app organization into logical blocks (830f93b)

• Add --help-all option to print out nested tree of app commands (b11fe7e)

• Clean up view’s use of blueprint attributes to discover templates and calculate URLs/endpoints (949c578)

• Limit flask to <1.1.0 until context breakage is resolved (217246f)

0.8.0 released 2019-03-25

• BREAKING CHANGE: Remove web.BaseView awareness of xhr() method and remove dependency on the deprecated flask.request.is_xhr (0899c5d)

• improve CI (3311389)

• Update to support Flask 1.0+ (63e3667)

• remove Pipenv including updated readme & tox (03b3920)

0.7.0 released 2019-02-07

• Enable setting engine options from KEG variable (5bb807f)

0.6.6 released 2018-11-13

• Add optional i18n support using morphi (d75a8fb)

• Update pipenv dependencies to remove warning (b3b089e)

• Pass through CLI invocation arguments and allow STDIN in CLI tests (bac2e3b)

0.6.5 released 2018-05-28

• Update readme, start using pipenv, pin Flask < 1.0 (abdc9bf)

0.6.4 released 2018-01-09

• when testing, don’t log to syslog by default (304a0a7)

0.6.3 released 2018-01-09

• add ‘@cee:’ prefix to json syslog formatter (b7ea5d3)

0.6.2 released 2017-12-19

• db: get rid of code to replace session object (149b42c)

0.6.1 released 2017-11-16

• fix quiet logging (e46fd2b)

• a few small updates/fixes to readme (2044439)

0.6.0 released 2017-08-18

• ADD: make CLIBase operate off current_app as last resort (1b358c1)

• ADD: –quiet option to script options (6eb723f)

• BREAKING CHANGE: adjust cli API on KegApp (af45880)

0.5.1 released 2017-08-15

• ADD: mitigate CSRF bug in Flask-WTF (42a2e70)

• ADD: config, init, and routing enhancements (cdfa901)

• MAINT: upgrade to CircleCI 2.0 (60e3bfa)

0.5.0 released 2017-06-27

• prep for pyp usage (23424b9)

• Merge branch ‘logging-improvements’ (PR66)

0.4.1 - 2017-02-09

• BUG: Properly quote pgsql identifiers during create (86852ad)

0.4.0 - 2016-12-19

• BUG: Properly Update Keyring Config Data (7f1908f)

• MSSQL dialect support (df7e89d)

• MAINT: Refactor keyring to accept bytes (15bc04b)

• MAINT: Remove deprecated flask hooks (4f7e2bf)

• Remove unicode_literal futures (dc2fa85)

• MAINT: Create windows build environment (983e040)

• MAINT: Run CI with Docker (bc7a877)

• Remove extra cp in readme (7e94815)