blob: 651832c5ad21b7d77b0395d2cdeeecc214a60f6b (
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
# 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. If an object has `name: "foo"`, it will be saved as `foo.yml` in the stash root directory.
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)
```
This will create a `yuval.yml` file in the stash root directory.
When saving to file, a `key` field must be present on the dataclass, otherwise an explicit `key` must be passed:
```python
stash.save(obj, key="custom-key")
```
Load from file:
```python
user = stash.load("yuval")
```
List all keys existing in stash:
```python
keys = stash.list_keys()
```
## License
[MIT](LICENSE)
|
