Skip to main content

Limited evaluator

Project description

Leval

License Coverage CI PyPI

A limited expression evaluator

A little more suited for dynamic usage than ast.literal_eval() while remaining as safe as the functions you pass in.

Under the hood, it uses the ast module to parse the expression, then walks the AST in Python to evaluate the result. You can also specify a depth limit for the complexity of the expression, as well as a time limit for the evaluation.

Example usage

Simple API

For many use cases, the simple_eval() function is sufficient. You can specify a depth limit and a time limit, and optional mappings of variables and functions.

The values mapping can also be keyed by a tuple of strings, which is what attribute accesses are folded to.

Operations are generally limited to numbers only in the simple API.

from leval.simple import simple_eval

assert simple_eval('1 + 2') == 3
assert simple_eval('x < -80 or x > 125 or x == 85', values={'x': 85})
assert simple_eval('abs(x) > 80', values={'x': -85}, functions={'abs': abs})
assert simple_eval('x.y.z + 8', values={('x', 'y', 'z'): 34}) == 42

Advanced API

Under the hood, simple_eval simply

  1. initializes an evaluation universe, which defines the functions, variables and operations available
  2. creates an Evaluator to evaluate the expression with the given universe

Both of these classes are designed to be easily subclassable. There are examples in the test_leval.py file.

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

leval-1.3.0.tar.gz (9.6 kB view hashes)

Uploaded Source

Built Distribution

leval-1.3.0-py3-none-any.whl (14.5 kB view hashes)

Uploaded Python 3

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