game-robot

Simple and Easy-to-Use robot client for game server.

Features

1. Provide high level synchronous api based on gevent

2. Multiple protos support. sproto and protobuf so far.

3. Two modes support. client mode for interaction on command line, simulator mode for async running which is often used in pressure test.

4. Simple and Easy-to-use api. Mostly only one line needed to add a command or request handler.

5. Simple but powerful command client, features passing in python types(string, int, list and dict, e.t.c), and Auto-Completions builtin.

6. Stream encrypt support built in.

Setup && Launch

Run

git submodule update --init --recursive

after first clone.

Run

make

to build.

You need a config file to launch. see test/config.py for detail.

Game logic

Please put your logic functions into game.py.

use @addcmd(ARGS, COMMAND_NAME) decorator to add client command.

use @addhandle(protoname) decorator to add handle function for game server's request.

Check test/config.py to see how to config client.

Test

test cmdclient

To launch test server:

python -m test/server  sproto

To launch client:

python main.py test/config.py

Now you've got a client to play with:

$ python2 main.py test/config.py
connect to ('127.0.0.1', 8251)
> help
help ['cmdname']
notify_addone ['i']
addone ['i']
echo ['msg']
login ['user']
addlist ['l']
> login "foobar"
hello, foobar
[foobar] > addlist [1,3,5,7]
answer: 16
[foobar] > echo "hello"
{'msg': 'hello'}

test simulator

To launch test server:

python -m test/server  sproto

Uncomment following block in test/config.py:

mode = "simulator"                 # client / simulator
run = [
    {
        "cmd" : "echo",
        "args" : ["hello world!"],
        "count" : 5,            # how many clients to launch to run this command
    },
    {
        "cmd": "addlist",
        "args" : [ [1,2,3,4,5] ],
        "count" : 3,
    }
]

Run client:

python main.py test/config.py