Firstcycling Api

🚀 第一個騎行API

這是一個非官方的Python API封裝庫，可用於訪問https://firstcycling.com/ ，為用戶提供便捷的賽事、騎手和排名等信息查詢服務。

🚀 快速開始

本API封裝庫支持以下端點：

• 賽事頁面
• 騎手頁面
• 排名頁面

有關完整文檔，請參閱https://firstcyclingapi.readthedocs.io/en/latest/ 。

💻 使用示例

基礎用法

賽事結果

>>> from first_cycling_api import RaceEdition
>>> amstel_2019 = RaceEdition(race_id=9, year=2019) # race_id來自賽事頁面URL
>>> amstel_2019.results().results_table.head() # 返回一個包含賽事結果的pandas DataFrame

騎手結果

>>> from first_cycling_api import RiderResults
>>> rider_results = RiderResults(rider_id=7569, year=2019)
>>> rider_results.results.head() # 返回一個包含指定騎手比賽結果的pandas DataFrame

排名表

>>> from first_cycling_api import RankingTable
>>> ranking = RankingTable(rank=1, y=2020, page=2) # 參數來自對應的URL
>>> ranking.table.head() # 返回一個包含排名表的pandas DataFrame

🤝 貢獻

歡迎貢獻！請隨時打開問題、拉取請求和/或討論。

特別是，以下領域有改進的空間：

• 映射更多端點（例如以https://firstcycling.com/team.php 開頭的頁面）
• 解析來自更多頁面的結果（例如賽事出發名單、賽事統計）

要運行測試，請先pip install pytest和pip install vcrpy。然後在根目錄的shell中運行py.test。

📄 許可證

見LICENSE文件。此項目與firstcycling.com沒有任何關聯。