mirror of
https://github.com/microsoft/regorus.git
synced 2026-08-05 02:16:11 +00:00
761d11ef48
* Instructions for WASM/JS binding Signed-off-by: Anand Krishnamoorthi <anakrish@microsoft.com> * Document Python, WASM/JS bindings Signed-off-by: Anand Krishnamoorthi <anakrish@microsoft.com> --------- Signed-off-by: Anand Krishnamoorthi <anakrish@microsoft.com>
82 lines
1.4 KiB
Markdown
82 lines
1.4 KiB
Markdown
# regorusjs
|
|
|
|
**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.
|
|
|
|
`regorusjs` is Regorus compiled into WASM.
|
|
|
|
See [Repository](https://github.com/microsoft/regorus).
|
|
|
|
To build this binding, see [building](https://github.com/microsoft/regorus/bindings/wasm/building.md)
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
```javascript
|
|
|
|
var regorus = require('regorusjs')
|
|
|
|
// Create an engine.
|
|
var engine = new regorus.Engine();
|
|
|
|
// Add Rego policy.
|
|
engine.add_policy(
|
|
// Associate this file name with policy
|
|
'hello.rego',
|
|
|
|
// Rego policy
|
|
`
|
|
package test
|
|
|
|
# Join messages
|
|
message = concat(", ", [input.message, data.message])
|
|
`)
|
|
|
|
// Set policy data
|
|
engine.add_data_json(`
|
|
{
|
|
"message" : "World!"
|
|
}
|
|
`)
|
|
|
|
// Set policy input
|
|
engine.set_input_json(`
|
|
{
|
|
"message" : "Hello"
|
|
}
|
|
`)
|
|
|
|
// Eval query
|
|
results = engine.eval_query('data.test.message')
|
|
|
|
// Display
|
|
console.log(results)
|
|
// {
|
|
// "result": [
|
|
// {
|
|
// "expressions": [
|
|
// {
|
|
// "value": "Hello, World!",
|
|
// "text": "data.test.message",
|
|
// "location": {
|
|
// "row": 1,
|
|
// "col": 1
|
|
// }
|
|
// }
|
|
// ]
|
|
// }
|
|
// ]
|
|
// }
|
|
|
|
// Convert results to object
|
|
results = JSON.parse(results)
|
|
|
|
// Process result
|
|
console.log(results.result[0].expressions[0].value)
|
|
// Hello, World!
|
|
```
|