https://github.com/danielgatis/django-smart-save

Adds the method save_if_valid to Model, which calls both full_clean and save.
https://github.com/danielgatis/django-smart-save

django django-application django-framework django-orm python

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/danielgatis/django-smart-save
• Owner: danielgatis
• License: bsd-2-clause
• Created: 2015-02-06T02:51:50.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2023-08-28T11:57:05.000Z (about 1 year ago)
• Last Synced: 2024-09-28T16:23:09.133Z (about 2 months ago)
• Topics: django, django-application, django-framework, django-orm, python
• Language: Python
• Homepage: https://pypi.org/project/django-smart-save
• Size: 17.6 KB
• Stars: 15
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
====================

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