topfreegames / pitaya-bot

Testing framework for Pitaya, providing automated tests

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Deprecation Notice

Pitaya-bot is no longer the recommended way to load test pitaya applications. We recommend using xk6-pitaya

pitaya-bot GoDoc Docs Go Report Card MIT licensed Build Status Coverage Status

Pitaya-Bot is an easy to use, fast and lightweight test server framework for Pitaya. The goal of pitaya-bot is to provide a basic development framework for testing pitaya servers via integration tests or stress tests.

Getting Started

Prerequisites

  • Go >= 1.10
  • etcd (optional: for running the testing example)
  • nats (optional: for running the testing example)
  • docker (optional: for running the testing example)

Installing

clone the repo

go get -u github.com/topfreegames/pitaya-bot

setup pitaya-bot dependencies

cd $GOPATH/src/github.com/topfreegames/pitaya-bot/
make setup

Running pitaya-bot

Here's how to run the testing example with JSON serializer:

Start the dependencies (this command requires docker-compose, but you may run the dependencies locally if need be) and the pitaya server:

$ make run-testing-json-server

Now a pitaya server should be running in one terminal. In another one, you can run pitaya-bot with the test specs:

$ make run-testing-json-bots

For the examples with protobuf, instead run:

$ make run-testing-proto-server
$ make run-testing-proto-bots

Running the tests

make test

Contributing

#TODO

Authors

  • TFG Co - Initial work

License

MIT License

Resources

About

Testing framework for Pitaya, providing automated tests

License:MIT License


Languages

Language:Go 96.7%Language:Makefile 1.5%Language:Python 0.8%Language:Shell 0.6%Language:Dockerfile 0.4%