jason-rs 0.1.4

A library for parsing Jason-like files into JSON, YAML, or TOML with support for inline file expansion.
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

# jason-RS

[![Crates.io](https://img.shields.io/crates/v/jason-rs)](https://crates.io/crates/jason-rs)
[![Docs](https://docs.rs/jason-rs/badge.svg)](https://docs.rs/jason-rs)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

**jason** is a lightweight JSON templating tool that transforms reusable `.jason` template files into standard JSON. Build modular and composable JSON structures with parameter support and file inclusion.

## ✨ Features

- **Template Parameters** - Define reusable templates with named parameters
- **File Inclusion** - Compose JSON from multiple `.jason` files
- **1:1 Conversion** - Clean mapping from `.jason` syntax to standard JSON
- **Library-First** - Designed for seamless integration into Rust projects

## 🚀 Quick Start

Add `jason-rs` to your `Cargo.toml`:

```toml
[dependencies]
jason-rs = "0.1"
```

Parse a Jason file:

```rust
use jason_rs::jason_to_json;

fn main() {
    //outputs raw json source
    let json = jason_to_json("./Page.jason").unwrap();
    println!("{}", json);
}
```

##  Example

### Jason Templates

**Person.jason** - A reusable person template
```jason
(name, age) {
    "name": #name,
    "age": #age
}
```

**Studio.jason** - A static studio object
```jason
{
    "name": "GameInc",
    "ceo": "Dave Something"
}
```

**Team.jason** - Composing multiple templates
```jason
(project) {
    "studio": <./Studio.jason>,
    "project": #project,
    "workers": [
        <./Person.jason | "jay", 12>,
        <./Person.jason | "mark", 14>,
        <./Person.jason | "lee", 15>
    ]
}
```

**Page.jason** - The head of the composition.
```jason
{
    "team": <./Team.jason | "Mario">
}
```

### Generated JSON

```json
{
  "team": {
    "project": "Mario",
    "studio": {
      "name": "GameInc",
      "ceo": "Dave Something"
    },
    "workers": [
      {
        "name": "jay",
        "age": 12
      },
      {
        "name": "mark",
        "age": 14
      },
      {
        "name": "lee",
        "age": 15
      }
    ]
  }
}
```

## Syntax Overview

| Syntax | Description |
|--------|-------------|
| `(param1, param2)` | Define template parameters |
| `#param` | Reference a parameter value |
| `<./File.jason>` | Include another Jason file |
| `<./File.jason \| arg1, arg2>` | Include with arguments |



Parses a `.jason` file at the given path and returns the resulting JSON as a `String`.

##  License

Licensed under the **Apache License 2.0**. See [LICENSE](LICENSE) for details.