rule-engine
A lightweight, optionally typed expression language with a custom grammar for matching arbitrary Python objects.
翻譯準備中
開發工具PythonGitHub @zeroSteiner自行安裝營運者未確認
試用過了嗎？ 點一下就好，不需要登入。
開發工具 分類的熱門專案
依最近已完成的 8 小時觀測回合間的 GitHub 星號增量排序
A lightweight, optionally typed expression language with a custom grammar for matching arbitrary Python objects.
翻譯準備中
開發工具PythonGitHub @zeroSteiner自行安裝營運者未確認
試用過了嗎？ 點一下就好，不需要登入。
依最近已完成的 8 小時觀測回合間的 GitHub 星號增量排序
製作者的介紹僅有上面的一句話。 更多詳情請閱讀儲存庫 README。 儲存庫 README ↗
正在載入完整 README。
檢視完整 README ↗|badge-build| |badge-pypi|
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:
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.
.. code-block:: python
import rule_engine
rule = rule_engine.Rule( 'first_name == "Luke" and email =~ ".*@rebels.org$"' ) # => rule.matches({ 'first_name': 'Luke', 'last_name': 'Skywalker', 'email': '[email protected]' }) # => True rule.matches({ 'first_name': 'Darth', 'last_name': 'Vader', 'email': '' }) # => False
The 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.
.. code-block:: python
import rule_engine
context = rule_engine.Context(type_resolver=rule_engine.type_resolver_from_dict({ 'first_name': rule_engine.DataType.STRING, 'age': rule_engine.DataType.FLOAT }))
rule = rule_engine.Rule('last_name == "Vader"', context=context)
rule = rule_engine.Rule('first_name + 1', context=context)
Want 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.
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.
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.
.. |badge-build| image:: https://img.shields.io/github/actions/workflow/status/zeroSteiner/rule-engine/ci.yml?branch=master&style=flat-square :alt: GitHub Workflow Status (branch) :target: https://github.com/zeroSteiner/rule-engine/actions/workflows/ci.yml
.. |badge-pypi| image:: https://img.shields.io/pypi/v/rule-engine?style=flat-square :alt: PyPI :target: https://pypi.org/project/rule-engine/
.. |social-github| image:: https://img.shields.io/github/followers/zeroSteiner?style=social :alt: GitHub followers :target: https://github.com/zeroSteiner
.. |social-twitter| image:: https://img.shields.io/twitter/follow/zeroSteiner :alt: Twitter Follow :target: https://twitter.com/zeroSteiner
.. _Change Log: https://zerosteiner.github.io/rule-engine/change_log.html .. _Debug REPL: https://zerosteiner.github.io/rule-engine/debug_repl.html .. _Getting Started: https://zerosteiner.github.io/rule-engine/getting_started.html .. _LICENSE: https://github.com/zeroSteiner/rule-engine/blob/master/LICENSE .. _Semantic Versioning: https://semver.org/ .. _Type Hinting: https://zerosteiner.github.io/rule-engine/getting_started.html#type-hinting
