openfga-dsl-parser 1.0.0

Parsing and JSON transformer for the OpenFGA authorization DSL
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! # OpenFGA DSL Parser
//!
//! The OpenFGA DSL Parser provides utilities for parsing DSL file string inputs into an AST representation, as well as transforming them into a JSON representation.
//!
//! This library is meant to be a utility for services using [OpenFGA](https://openfga.dev/) for their authorization solution, but need a way to translate from their DSL to the JSON format the HTTP API expects. A [Typescript library](https://github.com/openfga/syntax-transformer) is available that does something similar, however this aims to target Rust, as well as be a base for other potential languages to bind to.
//!
//! # Usage
//!
//! ```
//! # fn parse() -> openfga_dsl_parser::ParseResult<()> {
//! use openfga_dsl_parser::{json, Parser};
//!
//! let input = "type group
//!   relations
//!     define member as self
//! type resource
//!   relations
//!     define writer as self
//!     define reader as self but not writer";
//!
//! let mut parser = Parser::new(input);
//! let doc = parser.parse_document()?;
//!
//! let json = json::JsonTransformer::new(&doc).serialize();
//! # Ok(())
//! # }
//! ```

pub mod ast;
pub mod json;
pub mod lexer;
mod parser;

pub use parser::*;