Commit a0d657fc authored by Aurélien Campéas's avatar Aurélien Campéas
Browse files

doc: complete the README with command line instructions

parent a352db01254f
This is a library to store/retrieve pandas timeseries to/from a
postgres database, tracking their successive versions.
# Principles
......@@ -73,3 +76,70 @@ Freq: D
It is important to note that the third value was replaced, and the two
last values were just appended.
# Command line operations
A command line tool is provided, called `tsh`. It provides its usage
$ tsh --help
Usage: tsh [OPTIONS] COMMAND [ARGS]...
--help Show this message and exit.
It currently provides two basic operations `info` and `log`.
`Info` provides an overview of the time series repository (number of
committed changes, number and series and their names).
$ tsh info postgres://babar:babarpassword@dataserver:5432/banana_studies
changeset count: 209
series count: 144
series names: banana_spot_price, banana_trades, banana_turnover
`Log` provides the full history of editions to time series in the
$ tsh log postgres://babar:babar@dataserver:5432/banana_studies --limit 3
revision: 206
author: BABAR
date: 2017-06-06 15:32:51.502507
series: banana_spot_price
revision: 207
author: BABAR
date: 2017-06-06 15:32:51.676507
series: banana_trades
revision: 209
author: CELESTE
date: 2017-06-06 15:32:51.977507
series: banana_turnover
All options of all commands can be obtained by using the `--help`
$ tsh log --help
Usage: tsh log [OPTIONS] DB_URI
-l, --limit TEXT
-s, --serie TEXT
--from-rev TEXT
--to-rev TEXT
--help Show this message and exit.
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment