Skip to main content

No project description provided

Project description

### haf

The http api auto test framework.

[![Build Status](https://travis-ci.org/tsbxmw/haf.svg?branch=master)](https://travis-ci.org/tsbxmw/haf)
[![Documentation Status](https://readthedocs.org/projects/haf/badge/?version=latest)](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

![report](https://raw.githubusercontent.com/tsbxmw/haf/master/docs/show/report.gif)
![all](https://raw.githubusercontent.com/tsbxmw/haf/master/docs/show/all.gif)

### 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

![map](https://raw.githubusercontent.com/tsbxmw/haf/master/docs/png/HAF-2.0.0.png)

### 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)

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for haf, version 2.1.0
Filename, size File type Python version Upload date Hashes
Filename, size haf-2.1.0-py2.py3-none-any.whl (254.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page