An implementation S-FEEL (Simple Expression Language) as specified in the DMN (Decision Model Notation) standard. pySFeel is implemented in Python, using the SLY module and has many FEEL features.
- not, and and or in logical expressions which can be enclosed in round brackets (())
- in() function, e.g. 5 in(<6)
- Lists and filters
- Contexts and filters
- Ranges
- Built in functions
- New DMN 1.3 built in functions - is(), and the range comparison functions
pySFeel processes a single S-FEEL statement at a time. It is not intended to be a syntactically perfect implementation of S-FEEL, but rather an enabler for an implementation of DMN (Decision Model Notation) pyDMNrules. The internal data types are float, string, boolean, datetime.date, datetime.time, and datetime.timedelta. The S-FEEL constant null is mapped to None. Years and months durations are stored as floats. Days and time durations are stored as datetime.timedelta
There is one deliberate deviation from the standard - the key word 'item' in a Context filters is not optional. [{x:1,y:2},{x:2,y:3}][x=1] is not valid (as x=1 is either True or False), but [{x:1,y:2},{x:2,y:3}][item x=1] is valid and will return {x:1,y:2}. Similarly, fred.y is not the 'y' filter on the List of Contexts named 'fred' (as fred.y is a valid name). However (fred).y is the 'y' filter on the list of Contexts named fred.
There's one extension - an assignment operator (<-)
fred <- 7
bill <- 9
fred = bill
This will return False
fred <- [{x:1,y:2},{x:2,y:3}]
(fred).y
This will return [2,3]
USAGE:
import pySFeel
parser = pySFeel.SFeelParser()
sfeelText = '7.3 in [2.0 .. 9.1]'
(status, retVal) = parser.sFeelParse(sfeelText)
if 'errors' in status:
print('With errors:', status['errors'])
- retVal will be True
- The dictonary 'status' will have the key 'errors' if you have errors in your sfeelText.
- status['errors'] is a list of strings. It may help in diagnosing your S-FEEL syntax errors.
Documentation: More details can be found at readthedocs
