==================== django-smart-save

|License|

.. |License| image:: https://img.shields.io/badge/License-BSD%202--Clause-blue.svg :target: https://opensource.org/licenses/BSD-2-Clause

Adds the method save_if_valid to Model, which calls both full_clean and save.

Motivation

Do you think Django models save method will validate all fields (i.e. call full_clean) before saving or any time at all? Wrong!

I discovered this awful truth when I couldn't understand why a model object with an email field (without blank=True) could be saved with an empty string as email address.

More info:

• "Why doesn't django's model.save() call full clean?" http://stackoverflow.com/questions/4441539/
• "Model docs imply that ModelForm will call Model.full_clean(), but it won't." https://code.djangoproject.com/ticket/13100

Installing

First add the application to your Python path. The easiest way is to use pip::

pip install django-smart-save

You should install by downloading the source and running::

$ python setup.py install

Configuring

Make sure you have django.contrib.auth installed, and add the smart_save application to your INSTALLED_APPS list::

INSTALLED_APPS = (
    ...
    'django.contrib.auth',
    'smart_save',
)

You can specify a different method name in your project settings (default: save_if_valid):

SMART_SAVE_METHOD = 'my_save'

Usage Overview

It is simple::

>>> user = User(username="chris")
>>> user.save_if_valid()
True
>>> user = User(username="")
>>> user.save_if_valid()
False
>>> user._errors
{'username': ['This field cannot be blank.']}

License

Anyone is free to use or modify this software under the terms of the BSD license.

Buy me a coffee

Liked some of my work? Buy me a coffee (or more likely a beer)

|BuyMeACoffee|

.. |BuyMeACoffee| image:: https://bmc-cdn.nyc3.digitaloceanspaces.com/BMC-button-images/custom_images/orange_img.png :target: https://www.buymeacoffee.com/danielgatis