Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Boolean Expressions Interpreter

Project Description

Booleano is an interpreter of boolean expressions, a library to define and run filters available as text (e.g., in a natural language) or in Python code.

stable branche

development status

In order to handle text-based filters, Booleano ships with a fully-featured parser whose grammar is adaptive: Its properties can be overridden using simple configuration directives.

On the other hand, the library exposes a pythonic API for filters written in pure Python. These filters are particularly useful to build reusable conditions from objects provided by a third party library.

TLDR;

a string + some variable = safe boolean evaluation

# is this character a minor guy with a "0" in his name and born after 1983 ?
eval_boolean(
    'age < const:majority & "o" in name & birthdate > "1983-02-02"',
    {"name": "sokka", "age": 15, "birthdate": datetime.date(1984, 1, 1)},
    {'majority': 18},
    grammar_tokens={'belongs_to': 'in'}
) => True

The Fun Use Case

Booleano allow to safely evaluate an expression into something usable.

  • user:name is "john" and user:surname in {"doe", "shepard"}

+``{“user”: {“name”: “katara”}}`` => False +``{“user”: {“name”: “john”, “surname”: “doe”}}`` => True

with some code, you can provide any type you want, and the expression can still be in text:

+``user:birthdate > “03-07-1987”`` +``duration > 1m30s``

check the sample dirrectory to view more running examples !

Documentation

The full documentation is at http://django-rest-models.readthedocs.org/en/latest/.

Contribute

this project was not created by the current maintainer. in fact, the knowlege of this project from us is fare from perfect, but with 100% of test coverages, it’s not hard to keep it running.

if you find a bug, or want some feature, feel free to create a issues, or a Pull Request, but keep in mind that it can be hard for us to work on it. the best way to have it fixed, it’s to write a Pull Request with passing tests, and we will merge it if it’s a good piece of code.

see CONTRIBUTING.rst to know how work with ease on this project.

Upgrade Note

the old alpha release 1.0a1 is not compatible with newer version (starting with 1.1a1) because of heavy import path changes. all import from the modules (__init__.py) is discouraged.

Credit

forked from Gustavo Narea’s booleano project on launchpad.net.

maintened by yupeek

Release History

Release History

This version
History Node

1.1a1

History Node

1.0a1

History Node

1.0a1dev-20090717

History Node

1.0a1dev-20090715

History Node

1.0a1dev-20090710

History Node

1.0a1dev-20090524

History Node

1.0a1dev-20090523

History Node

1.0a1dev-20090517

History Node

1.0a1dev-20090515

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
booleano-1.1a1-py2.py3-none-any.whl (54.9 kB) Copy SHA256 Checksum SHA256 3.5 Wheel Jun 6, 2017
booleano-1.1a1.tar.gz (35.6 kB) Copy SHA256 Checksum SHA256 Source Jun 6, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting