用于xmlstat api的python客户端
Xmlstats-p的Python项目详细描述
xmlstats py
一个python模块,用于与xmlstats API
此模块旨在紧密镜像xmlstats提供的方法 参数和输出结构方面的api。
安装
pip install xmlstats-py
针对python 2.7、3.2-3.6进行测试
使用量
使用有效的访问令牌和用户实例化xmlstats对象 从xmlstats API获得的代理。
stats=Xmlstats(access_token=MY_ACCESS_TOKEN,user_agent=MY_USER_AGENT)
此对象公开许多方法(每个api端点一个),这些方法 返回api提供的数据的namedtuple表示。这个 json响应是用json.loads处理的,并且 object_hook用于在以下情况下将json对象转换为namedtuples 他们遇到了。这意味着可以使用点访问字段 符号。
方法
xmlstats类公开的每个方法都旨在镜像端点 由API提供。请参阅API documentation以获得完整的 参数和结果说明。
API Endpoint | Class Method |
---|---|
Events | events |
Roster | roster |
Standings | standings |
Teams | teams |
Team Schedule/Results | team_results |
NBA Box Score | nba_box_score |
NBA Draft | nba_draft |
NBA Daily Leaders | nba_daily_leaders |
NBA Team Stats | nba_team_stats |
MLB Box Score | mlb_box_score |
MLB Wild Card Standings | mlb_wild_card_standings |
示例
获取给定日期的boxScores-yyyymmdd
stats=Xmlstats(access_token=MY_ACCESS_TOKEN,user_agent=MY_USER_AGENT)events=stats.events(date="20141028",sport="nba")# returns NamedTuple "Events" which mirrors data structure explained in API documentation, containing all NBA events on given dateevent_ids=[event.event_idforeventinevents.event]boxscores=[stats.nba_box_score(eid)foreidinevent_ids]
更改日志
1.0.1(2017-08-09)
- 修复了多个nba和mlb特定方法中与方法请求的添加参数相关的错误。
1.0.0(2017-03-17)
- 使用此库时,完全彻底检查返回和表示数据的方式。数据现在作为namedtuples返回,而不是像以前的版本那样作为简单的字典/列表或“对象化”数据返回。
- 方法被重新实现以匹配xmlstats api的端点。xmlstats类公开的每个方法对应于api提供的单个端点,并接受相同的参数和参数。这意味着这个库的用户可以基本上引用已经存在的XMLSTATS API文档。
0.1.5(2015-11-03)
修复:
- 修正了在xlmstats服务器发出429响应代码后,无法在下一个请求中包含参数的http-get错误。
0.1.4(2015-11-02)
修复:
- 修复了阻止高级API函数工作的格式结果错误。
测试:
- 添加了一些基本测试,使用travis ci集成
文档:
- 向readmeg添加travis ci嵌入式状态图像
0.1.3(2015-11-02)
修复:
- 修复了从xmlstats api服务器获取429响应的http嫒u处理中的错误。在继续发出请求之前,http_get now将等待服务器429响应指定的时间量。