Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

Download
ActivePython
INSTALL>
pypm install kit

How to install kit

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install kit
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
Linux (64-bit)
0.2.15 Available View build log
 
License
MIT
Imports
Lastest release
version 0.2.15 on Jan 9th, 2014

A configurable, lightweight framework that integrates Flask, SQLAlchemy, and Celery.

  • Configure all your applications and sessions from one file (cf. Quickstart for an example).
  • Run your project from the command line: Start the Werkzeug webserver, start Celery workers, start a shell in your project's context (using IPython if available), and start the Flower monitor using the kit command line tool.
  • No more complicated import schemes: kit.Flask and kit.Celery always return the correct (and configured) application corresponding to the module.
  • Kit makes sure database connections are correctly handled (e.g. removed after each request and task) under the hood. You can configure this behavior via the kit.teardown_handler decorator.

Check out the examples/ folder for a few sample applications or read the full documentation on GitHub pages.

Kit is under development.

Installation

System Message: ERROR/3 (<string>, line 32)

Unknown directive type "code".

.. code:: bash

   $ pip install kit


Quickstart

Sample configuration file:

System Message: ERROR/3 (<string>, line 42)

Unknown directive type "code".

.. code:: yaml

  root: '..'
  flasks:
    - modules: ['my_project.app', 'my_project.app.views']
      kwargs:
        static_folder: 'st'
      config:
        debug: yes
        testing: yes
    - modules: ['my_project.api']
  celeries:
    - modules: ['my_project.tasks']
      config:
        broker_url: 'redis://'
  sessions:
    db:
      url: 'mysql://...'
      engine:
        pool_recycle: 3600
      options:
        commit: yes
        raise: no
  modules: ['my_project.startup']


The following configuration options are available:

  • root: project root, will be added to your python path (defaults to '.')
  • flasks: list of Flask application settings. Each item has the following keys available:
    • modules: list of modules where this application is used. Inside each of these modules, you can use kit.Flask(__name__) to recover this configured application. The application's name will be automatically generated from this list of modules.
    • kwargs: dictionary of keyword arguments passed to the flask.Flask constructor.
    • config: dictionary of configuration options used to configure the application. Names are case insensitive so no need to uppercase them.
  • celeries: list of Celery application settings. Each item has the following keys available:
    • modules: list of modules where this application is used. Inside each of these modules, you can use kit.Celery(__name__) to recover this configured application. The application's name will be automatically generated from this list of modules.
    • kwargs: dictionary of keyword arguments passed to the celery.Celery constructor.
    • config: dictionary of configuration options used to configure the application. Names are case insensitive so no need to uppercase them.
  • sessions: dictionary of sessions. The key is the session name (used as argument to kit.get_session). Each item has the following settings available:
    • url: the database url (defaults to sqlite://)
    • kwargs: dictionary of keyword arguments to pass to sqlalchemy.orm.sessionmaker.
    • engine: dictionary of keyword arguments to pass to the bound engine's constructor.
    • options: there are currently two options available:
      • commit: whether or not to commit the session after each request or task (defaults to False).
      • raise: whether or not to reraise any errors found during commit (defaults to True).
  • modules: list of modules to import (and that don't belong to an application).

You can then manage your project using the kit command line tool:

  • kit shell will start a shell in your project's environment (all applications and sessions will have been created and set up beforehand).
  • kit server will run the Werkzeug server for one of your Flask applications (if several applications are found, you will be prompted to choose one).
  • kit worker will start a Celery worker (if more than one Celery application exists in your project, you will be prompted to choose one).
  • kit flower starts the Flower worker monitor.

kit -h displays usage and the list of options available for each of these commands.

Next steps

To instantiate an application outside of the command line tool (for example to run it on a different WSGI server), you can specify a path argument to the kit.Flask function. This will load the kit before returning the application. The path argument is available on all other functions as well (for example to allow model access from an IPython notebook).

Subscribe to package updates

Last updated Jan 9th, 2014

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.