python api wrapper for stats.nba.com,重点关注nba和wnba应用程序
py-ball的Python项目详细描述
皮球
python api wrapper for stats.nba.com,重点关注nba和wnba应用程序
简介
这样做的动机源于nba_pyby seemethere和nbastatsRby abresler。在nba_py
中实现python api包装器的工作是一个很好的开始,但是缺少stats.nba.comapi的文档。nbastatsR
对于r社区来说是一个非常有价值的资源,这项工作希望扩展该包的广度和深度。在我的研究中,我还发现了最近由swar所做的努力。这看起来类似于nba_py
,我希望能合作。
目标
如果成功,py_ball
应完成以下操作:
- 通过与社区合作,提高stats.nba.com文档的质量。
- 进一步使篮球统计数据的传播能够增加对运动的了解,鼓励篮球分析的实践。
- 利用NBA和WNBA数据进行介绍性分析,通过演示减少进入篮球分析的障碍。
- 关注WNBA,努力强调包容性,为女篮分析做出贡献。
文档
虽然nba_api
在nba_py
中的stats.nba.comapi文档的基础上有了很大的改进,但是py_ball
努力通过以下步骤进一步完善文档:
- 完全文档化的代码,包括函数、类和脚本docstring。
- 扩展端点和参数文档以包括功能定义。
Current Documentation
课程:
包中类的功能记录在docstring和this site中。端点、参数和表记录在wiki中(链接如下):
- BoxScore
- Draft
- Image
- LeaderBoard
- League
- LeagueDash
- PlayByPlay
- Player
- Salaries(使用Hoopshype)
- ScoreBoard
- Shots
- Team
开发
最初映射{a6}api和完整的文档代码。重构代码以生成跨类的更一致的结构。用定义记录端点和参数。(请参见wikihere)- 研究其他与篮球相关的api以绘制地图。
为包编写单元测试。开始篮球分析入门。
安装
这个包是为python 3构建的,并利用了requirements.txt
文件中的包。py_ball
可以通过pip安装(更多信息here):
pip install py_ball
用法
stats.nba.comapi需要所有api调用的请求头。关于这一点,包括获得正确请求头的步骤,可以找到here。使用HEADER
中的请求头,下面的示例演示如何使用包为wnba拉取特许经营历史:
from py_ball import league, image
league_id = '10' #WNBA
franchises = league.League(headers=HEADERS,
endpoint='franchisehistory',
league_id=league_id)
除了Headshot
和Logo
类之外,每个类都有一个data
属性。这是一个字典,包含表名作为键,表数据的字典列表作为值。Headshot
和Logo
类具有作为png对象的image
属性。
联系人
继续更新或在twitter上联系@py_ball_!