124 lines
2.1 KiB
Markdown
124 lines
2.1 KiB
Markdown
---
|
|
title: Recfiles Extended Example
|
|
tags:
|
|
- data
|
|
- database
|
|
- recfiles
|
|
requires:
|
|
- data/recfiles.md
|
|
---
|
|
|
|
## Create
|
|
|
|
Make a database for your boardgames, specifying only one field and value:
|
|
|
|
```sh
|
|
database=games.rec
|
|
n=Name
|
|
g=Vojvodina
|
|
touch ${database}
|
|
recins -f ${n} --value ${g} ${database}
|
|
recsel ${database}
|
|
```
|
|
|
|
Insert a few more, with the estimated playtime:
|
|
|
|
```sh
|
|
recins -f Name -v Saboter -f Playtime -v 30 ${database}
|
|
recins -f Name -v Chess -f Playtime -v 30 ${database}
|
|
```
|
|
|
|
View all games, or select one by number:
|
|
|
|
```sh
|
|
recsel ${database}
|
|
recsel -n 0 ${database}
|
|
```
|
|
|
|
Each game should note whether or not you have played it yet, so you can add that field and set the default to `yes`.
|
|
|
|
```sh
|
|
f=played
|
|
v=yes
|
|
recset -f ${f} -a ${v} ${database}
|
|
```
|
|
|
|
...but the field is wrong, it should have a capital letter:
|
|
|
|
```sh
|
|
new_field=Played
|
|
recset -f ${f} --rename ${new_field}
|
|
```
|
|
|
|
## Read
|
|
|
|
Check how many records the database has:
|
|
|
|
```sh
|
|
recinf ${database}
|
|
```
|
|
|
|
Look at just the games you've never played:
|
|
|
|
```sh
|
|
recsel --expression="Played = 'no'" ${database}
|
|
```
|
|
|
|
Print how many, then just print the names:
|
|
|
|
```sh
|
|
recsel -e "Played = 'no'" --count ${database}
|
|
recsel -e "Played = 'no'" --print=Name ${database}
|
|
```
|
|
|
|
## Update
|
|
|
|
To change a game's `Played` field from `no` to `yes`, use `recset` to specify the number, and change that field.
|
|
|
|
```sh
|
|
num=0
|
|
f=Played
|
|
value=yes
|
|
recsel --number=${num} ${database}
|
|
recset --number=${num} -f ${f} --set=${value} ${database}
|
|
```
|
|
|
|
Find all games with a playtime of `30`, and set the field `Max_Players` to `4`.
|
|
|
|
```sh
|
|
recset -e "Playtime = 40" -f Max_Players --set 50 games.rec
|
|
```
|
|
|
|
This doesn't work, because that field does not exist.
|
|
You can `--set-add` the field, to add it wherever it does not exist.
|
|
|
|
```sh
|
|
recset -e "Playtime = 40" -f Max_Players --set-add 50 games.rec
|
|
```
|
|
|
|
## Delete
|
|
|
|
Remove `Played` record from first game:
|
|
|
|
```sh
|
|
num=0
|
|
recset --number=${num} -f Played --delete ${database}
|
|
```
|
|
|
|
You can comment the line instead of deleting it:
|
|
|
|
```sh
|
|
num=1
|
|
recset --number=${num} -f Played --delete ${database}
|
|
recsel ${database}
|
|
cat ${database}
|
|
```
|
|
|
|
Delete an entire record:
|
|
|
|
```sh
|
|
num=2
|
|
recdel --number=${num} ${database}
|
|
```
|
|
|