<commit_before>RATS: Remote Android Test Service
-----

![Imgur](http://i.imgur.com/s9Dl1ih.png)

###What is RATS?
RATS is an easy to run Test Runner Service that can be hosted anywhere a device can be connected.  It was designed to thwart device hogs and provide a level playing field for shops who can't afford more expensive testing services.

It should be as simple to setup as it is to run thanks to the [gradle plugin](https://www.github.com/wmbest2/rats-gradle-plugin)

### Why Rats?
"RATS!" was what I anticipated our developers at [VOKAL Interactive](http://www.vokalinteractive.com) saying whenever their tests failed.

###Installation

Binaries:

[Temporary Dropbox](https://www.dropbox.com/sh/z0spjt91pqufyh1/sOZ7cJ34-i)

Go-Pros:

1. `go get github.com/wmbest2/rats_server`
2. `rats_server -port 8080 -db mongodb://somehost`

### Run Your Tests

  `curl -X POST myserver.local:8080/api/run -F apk=@myapk.apk -F test-apk=@myapk-test.apk`

  _Seriously, that's it!_

  Parameters:

  * `apk` Main apk
  * `test-apk` Test package apk
  * `count` Number of devices
  * `serials` Comma separated list of device serials
  * `strict` Strict mode (will run forever if devices dont match)

###Capabilities

* Concurrent Test Running on all devices requested
 * Devices are held only as long as the test runs freeing them up sooner for more testing
 * Active Device monitoring lets you see which devices are in use
* Filter Devices for a particular run
 * Device count filter so you don't piss off your coworkers <commit_msg>Updated binary documentation<commit_after>RATS: Remote Android Test Service
-----

![Imgur](http://i.imgur.com/s9Dl1ih.png)

###What is RATS?
RATS is an easy to run Test Runner Service that can be hosted anywhere a device can be connected.  It was designed to thwart device hogs and provide a level playing field for shops who can't afford more expensive testing services.

It should be as simple to setup as it is to run thanks to the [gradle plugin](https://www.github.com/wmbest2/rats-gradle-plugin)

### Why Rats?
"RATS!" was what I anticipated our developers at [VOKAL Interactive](http://www.vokalinteractive.com) saying whenever their tests failed.

###Installation

Binaries:

https://github.com/wmbest2/rats-server/releases/latest

1. Unzip public.zip in the folder of your choice
2. Download the binary for your architecture and os and place in the same folder
3. `rats_server -port 8080 -db mongodb://somehost`

Go-Pros:

1. `go get github.com/wmbest2/rats_server`
2. `rats_server -port 8080 -db mongodb://somehost`

### Run Your Tests

  `curl -X POST myserver.local:8080/api/run -F apk=@myapk.apk -F test-apk=@myapk-test.apk`

  _Seriously, that's it!_

  Parameters:

  * `apk` Main apk
  * `test-apk` Test package apk
  * `count` Number of devices
  * `serials` Comma separated list of device serials
  * `strict` Strict mode (will run forever if devices dont match)

###Capabilities

* Concurrent Test Running on all devices requested
 * Devices are held only as long as the test runs freeing them up sooner for more testing
 * Active Device monitoring lets you see which devices are in use
* Filter Devices for a particular run
 * Device count filter so you don't piss off your coworkers 
{'fraction_non_alphanumeric': 0.09000927930714507, 'fraction_numerical': 0.013300340241261985, 'mean_word_length': 4.076923076923077, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 4, 'lorem ipsum': 0, 'www.': 5, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1478863', 'n_tokens_mistral': 1062, 'n_tokens_neox': 980, 'n_words': 419}