summaryrefslogtreecommitdiff
path: root/README.md
blob: 25737d22d0ff79eb2af91a0077fd29819c2f9f09 (plain)
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
# ymlstash

A simple ORM-like utility for operating on local YAML files via Python dataclasses.

## Usage

Define a dataclass:

```python
from dataclasses import dataclass
from typing import ClassVar

@dataclass
class User:
    name: str
    age: int
    active: bool
    key: ClassVar[str] = "name"
```

Note the special `key` field which is used to denote that `name` should be used as the primary key field.

Instantiate a new object:

```python
user = User(name="yuval", age=42, active=True)
```

Save it to file:

```python
from ymlstash import YmlStash

stash = YmlStash(User, "path/to/db")
stash.save(user)
```

Load from file:

```python
user = stash.load("yuval")
```