Install

To install Blask, you can use pip:

pip install blask

Also, you can use git to download the source code:

git clone https://github.com/zerasul/blask/

If you clone the source code, you need to install the dependencies using pipenv:

pipenv install

If you need to install the development dependencies too, add the --dev flag:

pipenv install --dev

After that, you need to configure Blask, create a file called settings.py file:

from pathlib import Path
from os import path

BASE_DIR = Path('.').resolve()
templateDir = path.join(BASE_DIR, "templates")
postDir = path.join(BASE_DIR, "posts")
defaultLayout = "template.html"
staticDir = path.join(BASE_DIR, "static")
title = "Blask"
errors = { 404:"404"}

You can export a environment variable that point to this file:

export BLASK_SETTINGS=settings

You can run the application using this code:

from blask.Blask import BlaskApp
import settings

if __name__ == '__main__':
    b = BlaskApp(templateDir=settings.templateDir, postDir=settings.postDir
    , defaultLayout=settings.defaultLayout, staticDir=settings.staticDir, title=settings.title, errors={404 : "404"})

    b.run()

If you use the environment Variable you can run Blask without arguments:

from blask.Blask import BlaskApp
import settings

if __name__ == '__main__':
    BlaskApp().run()

Or you can use the BlaskCLI tool:

blaskcli run

Now you can browse the main page at http://localhost:5000. If you see the Blask Home Page, all is ok and working.