Skip to main content

A Django app that allows creation of conditional logic in admin.

Project description

django-conditions

CI codecov Codacy Badge Dependency Status Documentation Status

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-conditions-0.9.18.tar.gz (15.6 kB view details)

Uploaded Source

Built Distribution

django_conditions-0.9.18-py3-none-any.whl (16.5 kB view details)

Uploaded Python 3

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

Hashes for django-conditions-0.9.18.tar.gz
Algorithm Hash digest
SHA256 01caf94f035f713cab415972a30ddf9c2a55a3b5be2379d25c8780dfb1ae1d69
MD5 2a7cad0f30e72059879bc746fb985a79
BLAKE2b-256 49567d9904c68bad36b5871636f0000f4777b497001fe38c19b6410c2f1ea42d

See more details on using hashes here.

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

Hashes for django_conditions-0.9.18-py3-none-any.whl
Algorithm Hash digest
SHA256 1d59d0314df593ed712c16a15a5f77da9685d5e65d1fced5fe66e770cbd9948d
MD5 b5d824fd8f2ddd46c11bd16a0ff31362
BLAKE2b-256 353ab293cc768753b2715664042e49835a0b48c1e55bbe5e23a244cbfbac98f1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page