Flasik

[

Documentation

Flasik is A mid stack, batteries framework based on Flask. It adds structure to your Flask application, and group the endpoints by classes instead of just loose functions.

Technically Flasik is my attempt of making a simple framework based on Flask Great Again!

Decisions made for you + Features

• Smart routing: automatically generates routes based on the classes and methods in your views

• Class name as the base url, ie: class UserAccount will be accessed at '/user-account'

• Class methods (action) could be accessed: hello_world(self) becomes 'hello-world'

• Smart Rendering without adding any blocks in your templates

• Auto rendering by returning a dict of None

• Templates are mapped as the model in the class the $module/$class/$method.html

• Markdown ready: Along with HTML, it can also properly parse Markdown

• Auto route can be edited with @route()

• Restful: GET, POST, PUT, DELETE

• REST API Ready

• bcrypt is chosen as the password hasher

• Session: Redis, AWS S3, Google Storage, SQLite, MySQL, PostgreSQL

• ORM: Active-Alchemy (SQLALchemy wrapper)

• ReCaptcha: Flask-Recaptcha

• Uses Arrow for dates

• Active-Alchemy saves the datetime as arrow object, utc_now

• CSRF on all POST

• CloudStorage: Local, S3, Google Storage Flask-Cloudy

• Mailer (SES or SMTP)

• Caching

• Propel for deployment

• Decorators, lots of decorators

Quickstart

Install Flasik

To install Flasik, it is highly recommended to use a virtualenv, in this case I use virtualenvwrapper

mkvirtualenv my-flasik-site

Install Flasik

pip install flasik

Initialize your application

Now Flasik has been installed, let's create our first application

cd your-dir

flasik-admin setup

flasik-admin setup setup the structure along with the necessary files to get started

You will see a structure similar to this

/your-dir
    |
    |__ .gitignore
    |
    |__ propel.yml
    |
    |__ requirements.txt
    |
    |__ brew.py
    |
    |__ application/
        |
        |__ __init__.py
        |
        |__ config.py
        |
        |__ /models/
            |
            |__ __init__.py
            |
            |__ models.py
        |
        |__ /views/
            |
            |__ __init__.py
            |
            |__ main.py
        |
        |__ /templates/
            | 
            |__ /layouts/
                | 
                |__ base.jade
            |
            |__ /main/
                |
                |__ /Index/
                    |
                    |__ index.jade
        |
        |__ /static/
            |
            |__ assets.yml
            |
            |__ package.json
        |
        |__ /data/
            |
            |__ babel.cfg
            |
            |__ /uploads/
            |
            |__ /babel/
            |
            |__ /mail-templates/
        |
        |__ /lib/

Serve your first application

If everything is all set, all you need to do now is run your site:

flasik serve

It will start serving your application by default at 127.0.0.1:5000

Go to http://127.0.0.1:5000/

I hope this wasn't too hard. Now Read The Docs at http://mardix.github.io/Flasik/ for more

Thanks,

Mardix :)

Read The Docs

To dive into the documentation, Read the docs @ http://mardix.github.io/Flasik/

License MIT

Copyright: 2017 Mardix