Metadata-Version: 2.0
Name: oscillo
Version: 0.2.2
Summary: Record the system load at the execution of the command line and display it graphically
Home-page: https://github.com/raomuyang/cmd-oscillo
Author: Rao Mengnan
Author-email: raomengnan@gmail.com
Maintainer: Rao Mengnan
Maintainer-email: raomengnan@gmail.com
License: UNKNOWN
Platform: Independent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Intended Audience :: Customer Service
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Description-Content-Type: text/markdown
Requires-Dist: psutil (<=5.6.1,>=5.2.2)
Requires-Dist: matplotlib
Requires-Dist: numpy (>=1.13.1)
Requires-Dist: PyYAML (==3.13)
Requires-Dist: terminaltables (==3.1.0)

# oscillo

记录命令执行过程中对系统产生的负载，以图片的形式展现出来

Record the system load at the execution of the command line and display it graphically

![demo](https://raw.githubusercontent.com/raomuyang/cmd-oscillo/master/demo/metrix.log.png)

![demo](https://raw.githubusercontent.com/raomuyang/cmd-oscillo/master/demo/cli.png)

## 安装方式 / Installation
* Install from pypi
```shell
pip install oscillo
```

* Install from local
```shell
python setup.py install
```


## 使用方式 / Usage


* 通过命令行参数启动 / Boot start by command line parameter

``` 
oscillo -c 'test: echo "">1.txt&&md5 1.txt' -o 1.png

```

* -c 代表将执行一个linux cmd 命令。参数后面可以跟以空格隔开的多个参数

* -o 结果输出文件

* 会在当前目录下生成一个log 文件。文本结构是json 格式. 数据结构如下
```
{
  "test": {
            "elapsed": 0.022143125534057617,  //总执行时间
            "cpu": [], 
            "memory": []
          }
}

```

* 通过配置文件启动 / Boot start by config file

当命令很长或者很多时，可以使用配置文件启动
Whe the commands is too many, you can boot start by config file

```shell
oscillo --config </path/to/config-file.yml> [-g]
```

## 配置文件模板 / Config file



The command line in commands will be executed in order

```yml
# Demo
commands:
  -
    name: gzip
    cmd: gzip big-file

  -
    name: tar
    cmd: tar -zcf tmp.tar.gz big-file

output: gzip-and-tar-gz
```



