A more forgiving variation of django's transaction handling, allowing you to pass some exceptions through atomic block without rollback.
Project description
django-soft-atomic
A more forgiving variation of django
's atomic
, allowing you to pass some
exceptions through atomic block without rollback.
Rationale
In big applications you may end up relying on exceptions mechanism to pass information
about failure up the stack. Unfortunately, if your business logic involves operations on
database, there is no easy way to wind up execution through atomic block without
rolling back entire transaction. django-soft-atomic
tries to solves this problem
by allowing certain exceptions to exit atomic block just like sucessful execution
(still maintaining the raised exception).
Requirements
- Python 3.6+
- Django 3.2+
Installation
With PIP
Execute: pip install django_soft_atomic
See also: PyPI Page
Manual
Copy django_soft_atomic.py
to your codebase and simply start using it.
Usage (docs)
This "package" constists of single decorator/context-manager, acting as replacement for django's atomic
:
soft_atomic(using=None, savepoint=True, durable=False, *, safe_exceptions=(Exception,))
using
- database name to use (same as original atomic),savepoint
- disable usage of savepoints in inner blocks (same as original atomic),durable
- ensure this is outermost block (same as original atomic),safe_exceptions
- collection (e.g.tuple
) of exceptions which are allowed to pass throughsoft_atomic
block without rollback. Typical DB errors (likeIntegrityError
) will still throw. Defaults to:(Exception,)
.
Example
Let's take a simple example, where we would like to perform payment operation and raise an exception if it fails. We want to create a database entry for both outcomes.
from django_soft_atomic import soft_atomic
class PaymentProcessingException(Exception):
pass
class PaymentRequest(models.Model):
payment_id = models.TextField()
success = models.BooleanField()
@soft_atomic(safe_exceptions=(PaymentProcessingException,))
def process_payment(payment_details):
payment_id, success = payment_gateway.process_payment(payment_details)
PaymentRequest.objects.create(payment_id=payment_id, success=success)
if not success:
raise PaymentProcessingException("Payment was not sucessful")
def payment_endpoint(payment_details):
try:
process_payment(payment_details)
except PaymentProcessingException:
... # handle a failure
else:
... # payment was successful
# in either case the `PaymentRequest` record was created in the database
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_soft_atomic-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | efe239c049d241f9681de5e792e86712bf35864360718d222f0839b2d3c24b90 |
|
MD5 | 498a3573bf4e0d0aaf943337b6877afc |
|
BLAKE2b-256 | bcd91592810d4cc08f4781ff38f96f2f9c771786e0a08c36b5c2d7af35db4cb2 |