Skip to main content

durable_rules

for real time analytics

durable_rules is a polyglot micro-framework for real-time, consistent and scalable coordination of events. With durable_rules you can track and analyze information about things that happen (events) by combining data from multiple sources to infer more complicated circumstances.

A full forward chaining implementation (A.K.A. Rete) is used to evaluate facts and massive streams of events in real time. A simple, yet powerful meta-liguistic abstraction lets you define simple and complex rulesets, such as flowcharts, statecharts, nested statecharts, paralel and time driven flows.

The Durable Rules core engine is implemented in C, which enables ultra fast rule evaluation and inference as well as muti-language support. Durable Rules relies on state of the art technologies: Werkzeug(http://werkzeug.pocoo.org/ is used to host rulesets). Inference state is cached using Redis(http://www.redis.io), which lets scaling out without giving up performance.

Let’s consider a couple of fictitious fraud rules used in bank account management. Note: I’m paraphrasing the example presented in this article(https://www.packtpub.com/books/content/drools-jboss-rules-50complex-event-processing).

  1. If there are two debit requests greater than 200% the average monthly withdrawal amount in a span of 2 minutes, flag the account as medium risk.

  2. If there are three consecutive increasing debit requests, withdrawing more than 70% the average monthly balance in a span of three minutes, flag the account as high risk

Example:

from durable.lang import *

with ruleset('fraud_detection'):
    # compute monthly averages
    @when_all(span(86400), (m.t == 'debit_cleared') | (m.t == 'credit_cleared'))
    def handle_balance(c):
        debit_total = 0
        credit_total = 0
        for tx in c.m:
            if tx.t == 'debit_cleared':
                debit_total += tx.amount
            else:
                credit_total += tx.amount

        c.s.balance = c.s.balance - debit_total + credit_total
        c.s.avg_balance = (c.s.avg_balance * 29 + c.s.balance) / 30
        c.s.avg_withdraw = (c.s.avg_withdraw * 29 + debit_total) / 30

    # medium risk rule
    @when_all(c.first << (m.t == 'debit_request') &
                         (m.amount > c.s.avg_withdraw * 2),
              c.second << (m.t == 'debit_request') &
                          (m.amount > c.s.avg_withdraw * 2) &
                          (m.stamp > c.first.stamp) &
                          (m.stamp < c.first.stamp + 120))
    def first_rule(c):
        print('Medium Risk')

    # high risk rule
    @when_all(c.first << m.t == 'debit_request',
              c.second << (m.t == 'debit_request') &
                          (m.amount > c.first.amount) &
                          (m.stamp < c.first.stamp + 180),
              c.third << (m.t == 'debit_request') &
                         (m.amount > c.second.amount) &
                         (m.stamp < c.first.stamp + 180),
              s.avg_balance < (c.first.amount + c.second.amount + c.third.amount) / 0.7)
    def second_rule(c):
        print('High Risk')

run_all()

Reference Manual:

Blog:

Metadata

Release files for durable-rules 0.31.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for durable-rules 0.31.16
File Interpreter ABI Platform
durable_rules-0.31.16-py2.7-macosx-10.5-x86_64.egg Legacy Egg format - - Details

Release files / durable_rules-0.31.16-py2.7-macosx-10.5-x86_64.egg

Download URL durable_rules-0.31.16-py2.7-macosx-10.5-x86_64.egg
Size 75.0 kB
Tags Egg
SHA-256 checksum
How to use checksums
7354a9feb61a22ed72b77225a04d7b0e169b312d17d07002e0b0301023c95819
BLAKE2b-256 checksum
How to use checksums
49dee5bf7bf09a4419742c9b64240cf7fbc94b1f45c995c8fa0b9f98816d67c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

2.0.28

1 release file

2.0.27

1 release file

2.0.26

1 release file

2.0.25

1 release file

2.0.24

1 release file

2.0.23

1 release file

2.0.22

1 release file

2.0.21

1 release file

2.0.20

1 release file

2.0.19

1 release file

2.0.18

1 release file

2.0.17

1 release file

2.0.16

1 release file

2.0.15

1 release file

2.0.14

1 release file

2.0.13

1 release file

2.0.12

1 release file

2.0.11

1 release file

2.0.10

1 release file

2.0.9

1 release file

2.0.8

1 release file

2.0.7

1 release file

2.0.6

1 release file

2.0.5

1 release file

2.0.4

1 release file

2.0.3

1 release file

2.0.2

1 release file

2.0.1

1 release file

0.33.99

1 release file

0.33.98

1 release file

0.33.97

1 release file

0.33.96

1 release file

0.33.94

1 release file

0.33.93

1 release file

0.33.92

1 release file

0.33.91

1 release file

0.33.90

1 release file

0.33.81

1 release file

0.33.79

0.33.78

1 release file

0.33.77

1 release file

0.33.76

1 release file

0.33.75

1 release file

0.33.74

1 release file

0.33.72

1 release file

0.33.71

1 release file

0.33.70

1 release file

0.33.69

1 release file

0.33.68

1 release file

0.33.67

1 release file

0.33.66

1 release file

0.33.64

1 release file

0.33.63

1 release file

0.33.62

1 release file

0.33.61

1 release file

0.33.60

1 release file

0.33.59

1 release file

0.33.58

1 release file

0.33.57

1 release file

0.33.56

1 release file

0.32.6

1 release file

0.31.23

1 release file

This release

0.31.16 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page