civex history
See what changed, and when, and undo a change to a record. Entry ids are the short ones listed here.
| Command | Description |
|---|---|
collection |
Show what changed on a collection, newest first. |
compact |
Store history written before this version as what changed rather than two whole copies of a thing per edit. The server does this by itself in the background; this does it now, with a progress bar. Each entry is checked to read the same before it is rewritten, and stopping (Ctrl+C) loses nothing: running it again carries on. |
record |
Show what changed on a record, newest first. |
revert |
Undo a change to a record. |
schema |
Show what changed on a schema and its own fields, newest first. |
show |
Show one history entry with every change in full. |
civex history collection
Show what changed on a collection, newest first.
Usage
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
NAME |
str |
yes | Collection name or ID |
Options
| Option | Type | Default | Description |
|---|---|---|---|
--action, -a |
str |
Only entries of this action (create, update, …) | |
--limit, -n |
int range |
20 |
How many entries to show |
--offset |
int range |
0 |
Skip this many entries |
civex history compact
Store history written before this version as what changed rather than two whole copies of a thing per edit. The server does this by itself in the background; this does it now, with a progress bar. Each entry is checked to read the same before it is rewritten, and stopping (Ctrl+C) loses nothing: running it again carries on.
Usage
Options
| Option | Type | Default | Description |
|---|---|---|---|
--vacuum |
flag | false |
Afterwards, give the room this frees back to the disk (SQLite). Needs about the database file's size in free disk while it runs. |
civex history record
Show what changed on a record, newest first.
Usage
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
RECORD_ID |
str |
yes | Record ID or short prefix |
Options
| Option | Type | Default | Description |
|---|---|---|---|
--action, -a |
str |
Only entries of this action (create, update, …) | |
--limit, -n |
int range |
20 |
How many entries to show |
--offset |
int range |
0 |
Skip this many entries |
civex history revert
Undo a change to a record.
An update puts the fields it changed back to what they were, a delete restores the record, and a create deletes it. Fields edited since are left alone unless --force is given. The revert is recorded in the record's history like any other edit, so it can be undone too.
Usage
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
ENTRY_ID |
str |
yes | History entry ID or short prefix |
Options
| Option | Type | Default | Description |
|---|---|---|---|
--field, -f |
str |
Only put this field back (repeat for several). Default: every field the entry changed | |
--force |
flag | false |
Also overwrite fields that were edited since the entry |
--yes, -y |
flag | false |
Skip confirmation prompt |
civex history schema
Show what changed on a schema and its own fields, newest first.
Usage
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
NAME |
str |
yes | Schema name |
Options
| Option | Type | Default | Description |
|---|---|---|---|
--action, -a |
str |
Only entries of this action (create, update, …) | |
--limit, -n |
int range |
20 |
How many entries to show |
--offset |
int range |
0 |
Skip this many entries |
civex history show
Show one history entry with every change in full.
Usage
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
ENTRY_ID |
str |
yes | History entry ID or short prefix |