Code Monkey home page Code Monkey logo

flask-appbuilder's Introduction

Flask App Builder

Simple and rapid Application builder, includes detailed security, auto form generation, google charts and much more.

Includes:

  • Security
    • Auto permissions lookup, based on exposed methods. It will grant all permissions to the Admin Role.
    • Inserts on the Database all the detailed permissions possible on you application.
    • Public (no authentication needed) and Private permissions.
    • Role based permissions.
    • Authentication base on OpenID and Database (Planning LDAP).
  • Auto menu generator.
  • Various view widgets like, lists, master-detail, list of thumbnails.
  • Image and File support for upload and database field association. It will handle everything for you.
  • Auto Create, Remove, Add, Edit and Show from Database Models
  • Support for multi-language via Babel
  • Field set's for Form's (Django style).
  • Google charts with automatic group by's.
  • Easy to extend via big widget's like charts, master-detail lists, etc...
  • Bootstrap 3.0.0 CSS and js, with Select2 and DatePicker

Instalation

This is finally on PyPi. So for easy instalation:

pip install flask-appbuilder

for your first application you can use "skeleton" ou "examples/simpleapp"

Initial configuration

After having the initial skeleton of you app, initialize the database.

Use init_app.py (folder scripts on git) will create a fresh new database, and add an 'admin' user with all permissions. The 'admin' password will be 'general' change it on your first access using the application. (Click the username on the navigation bar, then choose 'Reset Password')

Base Configuration

Use config.py to configure the following parameters, by default it will use SQLLITE DB, and bootstrap 3.0.0 base theme:

  • Database connection string (SQLALCHEMY_DATABASE_URI)
  • AUTH_TYPE: This is the authentication type
    • 0 = Open ID
    • 1 = Database style (user/password)
  • AUTH_ROLE_ADMIN: Configure the name of the admin role. All you new models and view will have automatic full access on this role
  • APP_NAME: The name of your application
  • APP_THEME: Various themes for you to choose from (bootwatch).

How to do it?

It's very easy and fast to create an application out of the box, with detailed security

Please take a look at github examples on:

https://github.com/dpgaspar/Flask-AppBuilder/tree/master/examples

Define your models (models.py)

class Group(db.Model):
    id = db.Column(db.Integer, primary_key = True)
    name =  db.Column(db.String(264), unique = True, nullable=False)
    address =  db.Column(db.String(564))
    phone1 = db.Column(db.String(50))
    phone2 = db.Column(db.String(50))
    taxid = db.Column(db.Integer)
    notes = db.Column(db.String(550))

    def __repr__(self):
        return self.name

Define your Views (views.py)

class GroupGeneralView(GeneralView):
        route_base = '/groups'
        datamodel = SQLAModel(Group, db.session)

        list_title = 'List Groups'
        show_title = 'Show Group'
        add_title = 'Add Group'
        edit_title = 'Edit Group'

        label_columns = { 'name':'Name','address':'Address','phone1':'Phone (1)','phone2':'Phone (2)','taxid':'Tax ID','notes':'Notes'}
        description_columns = {'name':'Write this group name'}
        list_columns = ['name','notes']
        show_columns = ['name','address','phone1','phone2','taxid','notes']
        order_columns = ['name','notes']
        search_columns = ['name']


genapp = General(app)
genapp.add_view(GroupGeneralView, "List Groups","/groups/list","th-large","Contacts")

Some pictures

Master Detail view with related lists:

https://raw.github.com/dpgaspar/flask-AppBuilder/master/images/master_detail_list.png "List"

Login page (with AUTH_DB):

https://raw.github.com/dpgaspar/flask-AppBuilder/master/images/login.png "Login"

Charts:

https://raw.github.com/dpgaspar/flask-AppBuilder/master/images/Charts.png "Charts"

Pictures in List Thumbnail:

https://raw.github.com/dpgaspar/flask-AppBuilder/master/images/ListThumbnail.png

Depends on:

  • flask
  • flask-sqlalchemy
  • flask-login
  • flask-openid
  • flask-wtform
  • flask-Babel

Planning to include:

  • Security for ldap auth.
  • Easy page flow definition (wizard style).

This is not production ready.

flask-appbuilder's People

Contributors

dpgaspar avatar

Watchers

Julian Pistorius avatar James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.