# twerk

`twerk` is a command-line utility for performing various QA tasks.

## Requirements
* Python `^2.7`

## Installation
Your machine needs to be setup to access Twitch's internal install of [Localshop](https://twitchtv.atlassian.net/wiki/display/SYS/Localshop).  Follow the instructions on the wiki page to set it up.

Once you've got Localshop setup, then to install twerk, simply run:

```
pip install twerk
```

You should now be able to run `twerk` from anywhere via the command-line.  Run:

```
twerk -h
```

If you see help output, then you should be good to go.

## Usage
Twerk has a collection of subcommands within.  You can run `twerk -h` to see what these commands are and what args they take.  They are also listed below:

### `get_tests`
Provided a list of JUnit `.xml` files, this command will merge the files into one `test_results.xml` which will be in the JUnit format.  If a directory is provided in the list, then it will recursively scan the directory for `.xml` files and merge those into the final file as well.  Any files that fail to merge into the file will display a warning message and be skipped.
