A Django app that allows creation of conditional logic in admin.
Project description
django-conditions
Move conditional logic that changes often from code into models so that the logic can be easily modified in admin. Some possible use cases:
- Segment your user base into cohorts with targeted messaging
- Provide different rewards to users depending on their expected value
- In a game, define the winning objectives of a mission/quest
- and many more...
Installation
First install the django-conditions
package:
pip install django-conditions
Then add conditions
to your INSTALLED_APPS
setting:
## settings.py
INSTALLED_APPS = [
...
'conditions',
]
Basic Usage
Start by defining a condition in code:
## condition_types.py
from conditions import Condition
class FullName(Condition):
# The name that appears in the db and represents your condition
condstr = 'FULL_NAME'
# Normal conditions define eval_bool, which takes in a user
# and returns a boolean
def eval_bool(self, user, **kwargs):
return bool(user.first_name and user.last_name)
Then add a ConditionsField to your model:
## models.py
from django.db import models
from conditions import ConditionsField, conditions_from_module
import condition_types
class Campaign(models.Model):
text = models.TextField()
# The ConditionsField requires the definitions of all possible conditions
# conditions_from_module can take an imported module and sort this out for you
target = ConditionsField(definitions=conditions_from_module(condition_types))
In the model's change form on admin, you can enter JSON to represent when you want your condition to be satisfied.
{
"all": ["FULL_NAME"]
}
Now you can use the logic you created in admin to determine the outcome of an event:
## views.py
from django.http import HttpResponse
from conditions import eval_conditions
from models import Campaign
def profile(request):
for campaign in Campaign.objects.all():
if eval_conditions(campaign, 'target', request.user):
return HttpReponse(campaign.text)
return HttpResponse("Nothing new to see.")
Use django-conditions in your Django projects to change simple logic without having to re-deploy, and pass on the power to product managers and other non-engineers.
More Information
Full documentation is available on Read The Docs.
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
File details
Details for the file django-conditions-0.9.18.tar.gz
.
File metadata
- Download URL: django-conditions-0.9.18.tar.gz
- Upload date:
- Size: 15.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.13 CPython/3.8.12 Linux/5.11.0-1028-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 01caf94f035f713cab415972a30ddf9c2a55a3b5be2379d25c8780dfb1ae1d69 |
|
MD5 | 2a7cad0f30e72059879bc746fb985a79 |
|
BLAKE2b-256 | 49567d9904c68bad36b5871636f0000f4777b497001fe38c19b6410c2f1ea42d |
File details
Details for the file django_conditions-0.9.18-py3-none-any.whl
.
File metadata
- Download URL: django_conditions-0.9.18-py3-none-any.whl
- Upload date:
- Size: 16.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.13 CPython/3.8.12 Linux/5.11.0-1028-azure
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1d59d0314df593ed712c16a15a5f77da9685d5e65d1fced5fe66e770cbd9948d |
|
MD5 | b5d824fd8f2ddd46c11bd16a0ff31362 |
|
BLAKE2b-256 | 353ab293cc768753b2715664042e49835a0b48c1e55bbe5e23a244cbfbac98f1 |