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

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, which support passing in types of string, int, list and dict. Auto-Completions builtin.

6. Stream encrypt support built in.

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.

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.

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'}

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 to run:

python main.py test/config.py