Metadata-Version: 2.1
Name: assignables
Version: 1.0.0
Summary: Helper package for assigning values to DB model objects.
Home-page: https://github.com/mijovicpetar/assignables
Author: Petar Mijovic
Author-email: petar@psoftware.co
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

# Assignables #
Helper package for Flask and Flask-API

## Third Party Library Requirements ##
* inflection

## Introduction ##

This package is helper package for assigning values to SqlAlchemy db model objects and to get their dict representation so they can be sent as response from Flask-API endpoints.
This package can be used without using SqlAlchemy, Flask and Flask-API.

## Installation ##
    pip install assignables

## Usage ##
    from assignables import Assignable

    class SomeModel(db.Model, Assignable):
        id = db.Column(db.Integer, primary_key=True)
        username = db.Column(db.String(80), unique=True, nullable=False)
        email = db.Column(db.String(120), unique=True, nullable=False)

        def __init__(self, username=None, email=None):
            Assignable.__init__()
            self.username = username
            self.email = email

    data = {
        "username": 'user123',
        "email": 'user@email.com'
    }

    obj = SomeModel()
    obj.assign(data) # username and email will be assigned.

    obj_dict = obj.get_json_dict() # obj_dict won't contain _sa_instance_state and Assignable class atributes.

Assignable will give your model two new methods:
1. `assign(data_dict)` - this method will assign coresponding atributes from respective key value pairs from `data_dict`.
2. `get_json_dict()` - this method will return objects dictionary.

Using `assign` method by default will not assign objects `id`, but will other atributes if they exist in `data_dict`.
Method `get_json_dict` will not have `_sa_instance_state` key inside by default and atriubets Assignable class contains.

If you want to specify custom atributes for not assigning or not serializing you can do that:
    from assignables import Assignables

    class SomeModel(db.Model, Assignable):
        id = db.Column(db.Integer, primary_key=True)
        username = db.Column(db.String(80), unique=True, nullable=False)
        email = db.Column(db.String(120), unique=True, nullable=False)

        def __init__(self, username=None, email=None):
            unassignables = ['id', 'email']
            unserializables = ['_sa_instance_state', 'email']
            Assignable.__init__(unassignables=unassignables, unserializables=unserializables)
            self.username = username
            self.email = email

    data = {
        "username": 'user123',
        "email": 'user@email.com'
    }

    obj = SomeModel()
    obj.assign(data) # username will only be assigned.

    obj_dict = obj.get_json_dict() # obj_dict will not contain _sa_instance_state and email atributes.

If used like this, `assign` method will not assign `id` and `email` atributes.
Dictinary returned by calling `get_json_dict` will not have keys `_sa_instance_state` and `email`.

You can also add you custom data validator - Validation will be executed inside `assign` method.
If validation failed `ValidationError` exception is raised.

    from assignables import DataValidator, Assignables


    class CustomValidator(DataValidator):
        def validate(self, obj):
            # return True if validated, false otherwise.


    class SomeModel(db.Model, Assignable):
        id = db.Column(db.Integer, primary_key=True)
        username = db.Column(db.String(80), unique=True, nullable=False)
        email = db.Column(db.String(120), unique=True, nullable=False)

        def __init__(self, username=None, email=None):
            Assignable.__init__(validator=CustomValidator())
            self.username = username
            self.email = email

    data = {
            "username": 'user123',
            "email": 'user@email.com'
        }

    obj = SomeModel()
    obj.assign(data) # Data will be validate using you custom data validator.

If there is a missmatch between your atribute naming or you wish to specify a naming convetion for
resulting dictionary there is a way.

    data = {
            "Username": 'user123',
            "Email": 'user@email.com'
        }

    obj = SomeModel()
    obj.assign(data, under_score_data=True) # This will handle create snake case keys from data dictionary keys.
    obj_dict = obj.get_json_dict(naming_convetion='camel_case') # Output dict would have camel case keys.

Options for `naming_convention` are:
1. camel_case
2. upper_camel_case
3. snake_case


