# regorus
**Regorus** is
- *Rego*-*Rus(t)* - A fast, light-weight [Rego](https://www.openpolicyagent.org/docs/latest/policy-language/)
interpreter written in Rust.
- *Rigorous* - A rigorous enforcer of well-defined Rego semantics.
Regorus can be used in Python via `regorus` package. (It is not yet available in PyPI, but can be manually built.)
See [Repository](https://github.com/microsoft/regorus).
To build this binding, see [building](https://github.com/microsoft/regorus/blob/main/bindings/python/building.md)
## Usage
```Python
import regorus
# Create engine
engine = regorus.Engine()
# Load policies
engine.add_policy_from_file('../../tests/aci/framework.rego')
engine.add_policy_from_file('../../tests/aci/api.rego')
engine.add_policy_from_file('../../tests/aci/policy.rego')
# Add policy data
data = {
"metadata": {
"devices": {
"/run/layers/p0-layer0": "1b80f120dbd88e4355d6241b519c3e25290215c469516b49dece9cf07175a766",
"/run/layers/p0-layer1": "e769d7487cc314d3ee748a4440805317c19262c7acd2fdbdb0d47d2e4613a15c",
"/run/layers/p0-layer2": "eb36921e1f82af46dfe248ef8f1b3afb6a5230a64181d960d10237a08cd73c79",
"/run/layers/p0-layer3": "41d64cdeb347bf236b4c13b7403b633ff11f1cf94dbc7cf881a44d6da88c5156",
"/run/layers/p0-layer4": "4dedae42847c704da891a28c25d32201a1ae440bce2aecccfa8e6f03b97a6a6c",
"/run/layers/p0-layer5": "fe84c9d5bfddd07a2624d00333cf13c1a9c941f3a261f13ead44fc6a93bc0e7a"
}
}
}
engine.add_data(data)
# Set input
input = {
"containerID": "container0",
"layerPaths": [
"/run/layers/p0-layer0",
"/run/layers/p0-layer1",
"/run/layers/p0-layer2",
"/run/layers/p0-layer3",
"/run/layers/p0-layer4",
"/run/layers/p0-layer5"
],
"target": "/run/gcs/c/container0/rootfs"
}
engine.set_input(input)
# Eval rule
value = engine.eval_rule('data.framework.mount_overlay')
# Print value
print(value)
```
Raw data
{
"_id": null,
"home_page": null,
"name": "teserak-regorus",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "interpreter, opa, policy-as-code, rego",
"author": null,
"author_email": null,
"download_url": null,
"platform": null,
"description": "# regorus\n\n**Regorus** is\n\n - *Rego*-*Rus(t)* - A fast, light-weight [Rego](https://www.openpolicyagent.org/docs/latest/policy-language/)\n interpreter written in Rust.\n - *Rigorous* - A rigorous enforcer of well-defined Rego semantics.\n\nRegorus can be used in Python via `regorus` package. (It is not yet available in PyPI, but can be manually built.)\n\nSee [Repository](https://github.com/microsoft/regorus).\n\nTo build this binding, see [building](https://github.com/microsoft/regorus/blob/main/bindings/python/building.md)\n\n## Usage\n```Python\nimport regorus\n\n# Create engine\nengine = regorus.Engine()\n\n# Load policies\nengine.add_policy_from_file('../../tests/aci/framework.rego')\nengine.add_policy_from_file('../../tests/aci/api.rego')\nengine.add_policy_from_file('../../tests/aci/policy.rego')\n\n# Add policy data\ndata = {\n \"metadata\": {\n \"devices\": {\n \"/run/layers/p0-layer0\": \"1b80f120dbd88e4355d6241b519c3e25290215c469516b49dece9cf07175a766\",\n \"/run/layers/p0-layer1\": \"e769d7487cc314d3ee748a4440805317c19262c7acd2fdbdb0d47d2e4613a15c\",\n \"/run/layers/p0-layer2\": \"eb36921e1f82af46dfe248ef8f1b3afb6a5230a64181d960d10237a08cd73c79\",\n \"/run/layers/p0-layer3\": \"41d64cdeb347bf236b4c13b7403b633ff11f1cf94dbc7cf881a44d6da88c5156\",\n \"/run/layers/p0-layer4\": \"4dedae42847c704da891a28c25d32201a1ae440bce2aecccfa8e6f03b97a6a6c\",\n \"/run/layers/p0-layer5\": \"fe84c9d5bfddd07a2624d00333cf13c1a9c941f3a261f13ead44fc6a93bc0e7a\"\n }\n }\n}\nengine.add_data(data)\n\n# Set input\ninput = {\n \"containerID\": \"container0\",\n \"layerPaths\": [\n \"/run/layers/p0-layer0\",\n \"/run/layers/p0-layer1\",\n \"/run/layers/p0-layer2\",\n \"/run/layers/p0-layer3\",\n \"/run/layers/p0-layer4\",\n \"/run/layers/p0-layer5\"\n ],\n \"target\": \"/run/gcs/c/container0/rootfs\"\n}\nengine.set_input(input)\n\n# Eval rule\nvalue = engine.eval_rule('data.framework.mount_overlay')\n\n# Print value\nprint(value)\n\n```\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Regorus copy - for easy install",
"version": "0.1.5",
"project_urls": {
"Source Code": "https://github.com/microsoft/regorus/bindings/python"
},
"split_keywords": [
"interpreter",
" opa",
" policy-as-code",
" rego"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1facc057138074d78d34358acea33cc5e9b8ffe6fd916444429eb1f50fc83a18",
"md5": "06810df0075e494536d4e5386c993902",
"sha256": "d3a326bf3a3f2801fd9aaf6df25b53e9016e01a27b46f48fe1b3f01e77825a25"
},
"downloads": -1,
"filename": "teserak_regorus-0.1.5-cp311-cp311-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "06810df0075e494536d4e5386c993902",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.8",
"size": 2358729,
"upload_time": "2024-06-10T05:15:36",
"upload_time_iso_8601": "2024-06-10T05:15:36.028086Z",
"url": "https://files.pythonhosted.org/packages/1f/ac/c057138074d78d34358acea33cc5e9b8ffe6fd916444429eb1f50fc83a18/teserak_regorus-0.1.5-cp311-cp311-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-10 05:15:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "microsoft",
"github_project": "regorus",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "teserak-regorus"
}
JSON
