A lightweight, optionally typed expression language with a custom grammar for matching arbitrary Python objects.
Documentation is available at https://zeroSteiner.github.io/rule-engine/.
- Warning:
Version 6.0 will remove support for Python version 3.10. There is currently no timeline for its release.
- Warning:
Version 5.0 removes support for Python versions 3.6, 3.7, 3.8, and 3.9 and deprecates attribute-style access on MAPPING values (use bracket syntax mapping["key"] instead). See the Change Log for details.
Rule Engine expressions are written in their own language, defined as strings in Python. The syntax is most similar to Python with some inspiration from Ruby. Some features of this language includes:
Optional type hinting
Matching strings with regular expressions
Datetime datatypes
Compound datatypes (equivalents for Python dict, list and set types)
Data attributes
Thread safety
Example Usage
The following example demonstrates the basic usage of defining a rule object and applying it to two dictionaries, showing that one matches while the other does not. See Getting Started for more information.
import rule_engine
# match a literal first name and applying a regex to the email
rule = rule_engine.Rule(
'first_name == "Luke" and email =~ ".*@rebels.org$"'
) # => <Rule text='first_name == "Luke" and email =~ ".*@rebels.org$"' >
rule.matches({
'first_name': 'Luke', 'last_name': 'Skywalker', 'email': 'luke@rebels.org'
}) # => True
rule.matches({
'first_name': 'Darth', 'last_name': 'Vader', 'email': 'dvader@empire.net'
}) # => FalseThe next example demonstrates the optional type system. A custom context is created that defines two symbols, one string and one float. Because symbols are defined, an exception will be raised if an unknown symbol is specified or an invalid operation is used. See Type Hinting for more information.
import rule_engine
# define the custom context with two symbols
context = rule_engine.Context(type_resolver=rule_engine.type_resolver_from_dict({
'first_name': rule_engine.DataType.STRING,
'age': rule_engine.DataType.FLOAT
}))
# receive an error when an unknown symbol is used
rule = rule_engine.Rule('last_name == "Vader"', context=context)
# => SymbolResolutionError: last_name
# receive an error when an invalid operation is used
rule = rule_engine.Rule('first_name + 1', context=context)
# => EvaluationError: data type mismatchWant to give the rule expression language a try? Checkout the Debug REPL that makes experimentation easy. After installing just run python -m rule_engine.debug_repl.
Installation
Install the latest release from PyPi using pip install rule-engine. Releases follow Semantic Versioning to indicate in each new version whether it fixes bugs, adds features or breaks backwards compatibility. See the Change Log for a curated list of changes.
Credits
Spencer McIntyre - zeroSteiner
License
The Rule Engine library is released under the BSD 3-Clause license. It is able to be used for both commercial and private purposes. For more information, see the LICENSE file.
1 maintainer
Release files for rule-engine 5.0.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rule_engine-5.0.2.tar.gz | 95.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rule_engine-5.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 231.0 kB
Release files / rule_engine-5.0.2.tar.gz
| Download URL | rule_engine-5.0.2.tar.gz |
|---|---|
| Size | 95.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dd871030a2eee062f3869fa952c3b93dbf56b21c8c01b73ca71e4c3ac8c5a4ea
|
|
BLAKE2b-256 checksum How to use checksums |
ef1eb77a11130c48cc37ba6a64f0fe8b6c5585923975d4cc8f5184cf5f7172dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / rule_engine-5.0.2-py3-none-any.whl
| Download URL | rule_engine-5.0.2-py3-none-any.whl |
|---|---|
| Size | 135.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
93e3bc62742a3463d8361071c4e6b3c6d55393835822825375b2ed9d766141d7
|
|
BLAKE2b-256 checksum How to use checksums |
77b5d81a48d940e0266974b37fea1a5ebaff8d88735fbded899ce1cc043be682
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
