haf 2.1.0

No project description provided

### haf

The http api auto test framework.

[](https://travis-ci.org/tsbxmw/haf)
[](https://haf.readthedocs.io/en/latest/?badge=latest)


### new features


- based on local test runner

- support xlsx,json,yml,py cases

- report generate with html-template

- multi-processes on different machines

- multi-runners

- web-server support restful api based on flask

- only mode : loader/runner/recorder/webserver/bus support


### How to get it

> using pip to get it

```shell
tsbxmw@ps# pip install haf --upgrade
```

> using git tool to get it

```bash
tsbxmw@ps# git clone https://github.com/tsbxmw/haf
tsbxmw@ps# cd haf
tsbxmw@ps# python setup.py install
```


### How to run

#### local bus mode, using local bus to run all cases

- local bus is without --bus-server(-bs) args, when running the program, the bus would be created

##### modify the config.json in testcases

- change the log_path and report_path and case_path to your own path

```json
{
"config":{
"run": {
"log": {
"log_path": "D:/workspace/mine/python/haf/data"
},
"bus": {
"only": false,
"host": "",
"port": "",
"auth_key": ""
},
"report": {
"report_path": "D:/workspace/mine/python/haf/data/report.html"
},
"case": [
{
"case_path": "D:/workspace/mine/python/haf/testcases/test.xlsx"
},
{
"case_path": "D:/workspace/mine/python/haf/testcases/test2.json"
},
{
"case_path": "D:/workspace/mine/python/haf/testcases/test1.xlsx"
},
{
"case_path": "D:/workspace/mine/python/haf/testcases/test3.yml"
}
],
"runner":{
"only": false,
"count": 4
},
"loader": {
"only": false
},
"recorder": {
"only": false
},
"web_server": {
"host": "",
"port": "",
"run": true
}
}
}

}
```

##### create testcase

- create xlsx/json/yml file with template in testcases/

##### run

- run with config

```shell
python -m haf run -c=./testcases/config.json
```

- run with args

```shell
python -m haf run -case=./testcases/test.xlsx,./testcases/test2.json -ld=./data -rh=true -rod=./data/report.html
```

##### other run args

- run with multi-runners (4 runners)

```shell
python -m haf run -rc=4
```

- run with web server

```shell
python -m haf run -ws=true
```

- run with only-mode

```shell
# only loader
python -m haf run -ol=true
# only bus
python -m haf run -ob=true
# only runner
python -m haf run -or=true
# only recorder
python -m haf run -ore=true
```

### web api server suport

- get loader infos

```bash
http://localhost:8888/loader
```

- get runner infos

```bash
http://localhost:8888/runner
```

- get result infos

```bash
http://localhost:8888/result
```

- get report infos

```bash
http://localhost:8888/report
```

### FrameWork

#### Design


### Doc

> [doc url](https://github.com/tsbxmw/haf/blob/master/docs/design.md)

> [read the doc](https://haf-doc.readthedocs.io/en/dev-2.1.0/)

> [wiki home](https://github.com/tsbxmw/haf/wiki)

> [Quick Start](https://github.com/tsbxmw/haf/wiki/Quick-Start)

### Release Note

[release note](https://github.com/tsbxmw/haf/blob/master/docs/releasenote.md)