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を実行してください。その後、ルートディレクトリのシェルでpy.testを実行します。

📄 ライセンス

LICENSEファイルを参照してください。このプロジェクトは、firstcycling.comとは一切関係ありません。