用于weewar xml api的python包装器
python-weewar的Python项目详细描述
Weewar(http://weewar.com)是一个“获奖的回合制多人策略” 游戏”。除了非常容易上瘾之外,它还提供了两个api:
- 一个只读api,用于播放器和
- 名为eliza的bot api
在http://weewar.wikispaces.com/api上可以找到关于这两者的进一步文档。
此模块旨在使您能够方便地调用这些api函数中的每一个 从您的python脚本中。
可用的API调用
提供以下功能:
- game(id)返回游戏状态并提供有关 参赛选手。
- open_games()以ID列表的形式返回当前所有可用的打开游戏。
- all_users()返回上次联机的所有用户的列表 7天,包括他们目前的排名。
- user(username)返回有关单个用户的详细信息, 包括所有在个人资料页和游戏中可见的内容 用户正在参与。
- latest_maps()返回最新发布的地图,包括 预览、图像和其他详细信息。
- headquarter(username, apikey)返回您的 总部。包括有关ID、URL、状态和 游戏名称。如果游戏需要注意,则添加一个属性, 例如:用户轮到了,或者游戏还没有开始,或者用户被邀请了 到这个游戏(需要验证)。
- game_state(username, apikey, id)提供了有关状态的更多信息 游戏的(需要验证)。
- map_layout(id)返回完整的地图布局。
每个游戏也可以通过这些命令来控制(这些命令是 伊莱扎API):
- finish_turn(username, apikey, id)完成交卷游戏。
- accept_invitation(username, apikey, id)接受游戏邀请。
- decline_invitation(username, apikey, id)拒绝游戏邀请。
- send_reminder(username, apikey, id)发送有关游戏的提醒。
- surrender_game(username, apikey, id)投降!
- abandon_game(username, apikey, id)放弃游戏。
- remove_game(username, apikey, id)删除游戏。
- chat(username, apikey, game_id, msg)向游戏发送聊天信息 董事会。
- build_unit(username, apikey, game_id, (x, y), unit)发送聊天信息 去游戏板。
- unit_move_options(username, apikey, game_id, unit, (x, y))请求单元 移动选项。这和你选择一个 常规比赛中的一个单位。
- unit_attack_options(username, apikey, game_id, unit, (x, y), moved=None) 请求可能的目标。“moved”属性是可选的,它描述 单位已移动的圈数。这对喷气机和 战舰。
- move_unit(username, apikey, game_id, unit, from, to)移动一个单位。
- attack_with(username, apikey, game_id, unit, from, target)攻击目标 单位在指定位置。
- capture_base(username, apikey, game_id, unit, at)捕获具有 单位。你得先搬过去!
- repair_unit(username, apikey, game_id, unit, at)修复一个单元。
身份验证
提供的一些函数需要用户名和密码。利用你的 Weewar帐户用户名和API令牌可通过 http://weewar.com/apiToken。
许可证
此模块的代码在GNU Lesser General Public下发布 许可证版本3。