Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/slub/statsdelta
A commandline command (Python3 program) that compares two (CSV) statistics with each other and generates delta values from the (old and the new) values
https://github.com/slub/statsdelta
cli command-line-tool csv delta python statistics
Last synced: about 2 months ago
JSON representation
A commandline command (Python3 program) that compares two (CSV) statistics with each other and generates delta values from the (old and the new) values
- Host: GitHub
- URL: https://github.com/slub/statsdelta
- Owner: slub
- License: apache-2.0
- Created: 2018-03-20T12:02:02.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-05T12:29:28.000Z (over 6 years ago)
- Last Synced: 2024-04-14T22:49:13.876Z (9 months ago)
- Topics: cli, command-line-tool, csv, delta, python, statistics
- Language: Python
- Size: 16.6 KB
- Stars: 3
- Watchers: 15
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# statsdelta - statistics delta
statsdelta is a commandline command (Python3 program) that compares two (CSV) statistics with each other and generates delta values from the (old and the new) values.
## Usage
```
statsdelta
required arguments:
-from FROM_FILE The file to use as the left or from source for the delta calculation (default: None)
-to TO_FILE The file to use as the right or to source for the delta calculation (default: None)
-key-field KEY_FIELD The key field name (column name) (default: None)
optional arguments:
-h, --help show this help message and exit
-delimiter DELIMITER The field delimiter used within the file; use TAB for tab-delimited (default: ,)
-output-fields OUTPUT_FIELDS The names of the fields (column names) to include in the delta output (if this argument is not specified, then the header from the "from" CSV file is taken (i.e. all columns from the "from" CSV file); it's always mandatory that these columns only contain numeric values (otherwise an error will be thrown at processing time)) (default: None)
```
* example:
```
statsdelta -from [PATH THE FROM CSV FILE] -to [PATH TO THE TO CSV FILE] -key-field [KEY FIELD NAME] > [PATH TO THE OUTPUT CSV FILE]
```
### Note
Please make sure that the choosen output fields (columns) only contain numeric values (otherwise an error will be thrown at processing time). This is especially important when the argument '-output-fields' is not specified, because then the header from the "from" CSV file is taken (i.e. all columns from the "from" CSV file).
### Current Limitations
Currently, column indices/numbers are not supported (see [issue #1](https://github.com/slub/statsdelta/issues/1)), i.e., only column names. So header in the CSV files are mandatory.
## Run
* clone this git repo or just download the [statsdelta.py](statsdelta/statsdelta.py) file
* run ./statsdelta.py
* for a hackish way to use statsdelta system-wide, copy to /usr/local/bin
### Install system-wide via pip
```
sudo -H pip3 install --upgrade [ABSOLUTE PATH TO YOUR LOCAL GIT REPOSITORY OF STATSDELTA]
```
(which provides you ```statsdelta``` as a system-wide commandline command)
## Description
### Diff Status
|Diff Status|Description|
|-----------|-----------|
|changed|some values (/statistics; included in this comparison) have been changed for this field (key)|
|not changed|no values (/statistics; included in this comparison) have been changed for this field (key)|
|added|this field (key) has been added to the 'to' statistic|
|deleted|this field (key) has been removed from the 'to' statistic|