Skip to main content

Flask boilerplate to create an application with the idea of pluggable blueprints.

Project description

Blue Flask

Flask boilerplate to create projects with the idea of pluggable blueprints.


.. code-block::

pip install blueflask


The following command allows you to create a new app:

.. code-block:: python



Creating A New App

Let's assume that we are going to start a project called **bluedemo**. Execute
on your terminal:

.. code-block::

blueflask newapp bluedemo

This will create a directory with the name of the project and define a basic
structure for your project layout.

Running The APP

Next, go inside the directory of your project and install the dependencies.
If you are using *virtualenv* then, create and/or activate your environment
before executing the following command bellow install your dependencies.

.. code-block::

pip install -r requirements.txt

Now your project is ready to run. Execute the following command to start
the server:

.. code-block::


Or you can execute one of the Flask standard ways to run the application:

.. code-block::

flask run


.. code-block::

python -m flask run

Either one will start the application running on port 5000. Now you can go to
your browser and enter:

+ `http://localhost:5000/<http://localhost:5000/>`_

+ `http://localhost:5000/demo/<http://localhost:5000/demo/>`_

You can play with some URLs like: `http://localhost:5000/demo/about/?value=some_random_value<http://localhost:5000/demo/about/?value=some_random_value>`_

As you can see, the last two URLs have a */demo* prefix. This is defined in the *blueprints/demo/* file by the *url_prefix* under the *BLUEPRINT_INIT* dictionary. You can change the value of this for whatever you want or set it to *None* if you don't want any prefix.

Understanding Your Application

Now that you have your application running, have a look to the basic architecture defined by BlueFlask. Look inside the *app/blueprints*
directory. As you can see, there is a *main* and a *demo* directory. These directories are consider *pluggable-blueprint*, according to the BlueFlask idea. The structure of this directory is pretty simple:

+ ** Makes the current directory a Python package.
+ ** Blueprint specific settings and definitions.
+ ** Routes for that blueprint.
+ ** Functions or classes in charge of handing requests.

Feel free to define more modules as you need them. I.e: **,
**, **, etc.

Creating A New Blueprint.

To create a new blueprint, you just have to create a new directory inside
the *blueprints* directory.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
blueflask-0.1.4.tar.gz (5.4 kB) Copy SHA256 hash SHA256 Source None Oct 26, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page