Metadata-Version: 1.2
Name: flask_dictabase
Version: 1.1.2
Summary: A dict() like interface to your database.
Home-page: https://github.com/GrantGMiller/flask_dictabase
Author: Grant miller
Author-email: grant@grant-miller.com
License: PSF
Project-URL: Source Code, https://github.com/GrantGMiller/flask_dictabase
Description: Flask-Dictabase
        ===============
        A dict() like interface to your database.
        
        Install
        =======
        ::
        
            pip install flask_dictabase
        
        Here is a simple flask app implementation.
        ::
        
            import random
            import string
        
            from flask import (
                Flask,
                render_template,
                redirect
            )
            import flask_dictabase
        
            app = Flask('User Management')
            # if you would like to specify the SQLAlchemy database then you can do:
            # app.config['DATABASE_URL'] = 'sqlite:///my.db'
            db = flask_dictabase.Dictabase(app)
        
        
            class UserClass(flask_dictabase.BaseTable):
                def CustomMethod(self):
                    # You can access the db from within a BaseTable object.
                    allUsers = self.db.FindAll(UserClass)
                    numOfUsers = len(allUsers)
                    print('There are {} total users in the database.'.format(numOfUsers)
        
                    # You can also access the app from within a BaseTable object
                    if self.app.config.get('SECRET_KEY', None) is None:
                        print('This app has no secret key')
        
            @app.route('/')
            def Index():
                return render_template(
                    'users.html',
                    users=db.FindAll(UserClass),
                )
        
        
            @app.route('/update_user_uption/<userID>/<state>')
            def UpdateUser(userID, state):
                newState = {'true': True, 'false': False}.get(state.lower(), None)
                user = db.FindOne(UserClass, id=int(userID))
                user['state'] = newState # This is immediately saved to the database.
                return redirect('/')
        
        
            @app.route('/new')
            def NewUser():
                email = ''.join([random.choice(string.ascii_letters) for i in range(10)])
                email += '@'
                email += ''.join([random.choice(string.ascii_letters) for i in range(5)])
                email += '.com'
        
                newUser = db.New(UserClass, email=email, state=bool(random.randint(0, 1)))
                print('newUser=', newUser) # This is now immediately saved to the database.
                return redirect('/')
        
        
            @app.route('/delete/<userID>')
            def Delete(userID):
                user = db.FindOne(UserClass, id=int(userID))
                print('user=', user)
                if user:
                    db.Delete(user) # User is now removed from the database.
                return redirect('/')
        
        
            if __name__ == '__main__':
                app.run(
                    debug=True,
                    threaded=True,
                )
        
        Unsupported Types / Advanced Usage
        ==================================
        If you want to store more complex information like list() and dict(), you can use the .Set() and .Get() helper methods.
        These convert your values to/from json to be stored in the db as a string.
        
        ::
        
            myList = [1,2,3,4,5] #
            user = db.FindOne(UserClass, id=1)
            if user:
                user.Set('myList', myList)
        
            user2 = db.FindOne(UserClass, id=1)
            print('user2.Get('myList')=', user2.Get('myList'))
        
        Output
        ::
        
            >>> user2.Get('myList')= [1, 2, 3, 4, 5]
        
        You can use the helper methods .Append() and .SetItem() to easliy save list() and dict()
        ::
        
            user.Append('myList', 9)
            print('user2.Get('myList')=', user2.Get('myList'))
        
        Output
        ::
        
            >>> user2.Get('myList')= [1, 2, 3, 4, 5, 9]
        
        You can also use a different function to load/dump the values. Like python's pickle module.
        ::
        
            import pickle
            myList = [1,2,3,4,5] #
            user = db.FindOne(UserClass, id=1)
            if user:
                user.Set('myList', myList, dumper=pickle.dumps, dumperKwargs={})
        
            user2 = db.FindOne(UserClass, id=1)
            print('user2.Get('myList')=', user2.Get('myList', loader=pickle.loads))
        
        You can also provide a default argument to .Get()
        ::
        
            user = db.FindOne(UserClass, id=1)
            user.Get('missingKey', None) # return None if key is missing, else return the dumped value
        
        You can also use the methods .Append() .Remove() and .SetItem() and .PopItem() to easily manipulate the info stored as JSON
        ::
        
            user = db.FindOne(UserClass, id=1)
            user.Set('animals', ['cat', 'dog', 'bird'])
        
            print('user.Get("animals")=', user.Get('animals'))
            >>> user.Get("animals")= ['cat', 'dog', 'bird']
        
            user.Append('animals', 'tiger')
            print('user.Get("animals")=', user.Get('animals'))
            >>> user.Get("animals")= ['cat', 'dog', 'bird', 'tiger']
        
            user.Remove('animals', 'cat')
            print('user.Get("animals")=', user.Get('animals'))
            >>> user.Get("animals")= ['dog', 'bird', 'tiger']
        
            user.Set('numOfPets', {'cats': 1, 'dog': 1})
            print('user.Get("numOfPets")=', user.Get('numOfPets'))
            >>> user.Get("numOfPets")= {'cats': 1, 'dog': 1}
        
            user.SetItem('numOfPets', 'cats', 3)
            print('user.Get("numOfPets")=', user.Get('numOfPets'))
            >>> user.Get("numOfPets")= {'cats': 3, 'dog': 1}
        
            user.PopItem('numOfPets', 'cats')
            print('user.Get("numOfPets")=', user.Get('numOfPets'))
            >>> user.Get("numOfPets")= {'dog': 1}
        
        
        Gunicorn
        ========
        
        Supports multiple workers (-w config option).
        Example::
        
            gunicorn main:app -w 4 -b localhost:8080
        
Keywords: grant miller flask database
Platform: UNKNOWN
