ergast

Python HTTP client to the Ergast Motor Racing Data API


Keywords
ergast, formula1, racing, motorsports, http, client
License
MIT
Install
pip install ergast==0.0.0

Documentation

ergast-python

Python HTTP client to the Ergast Motor Racing Data API

This is a work in progress. The goal is to create a convenient python client for the Ergast Developer API.

It should:

  • include all the resource types the API makes available
  • allow a wide range of the filtering and custom requests of the API
  • be organized into packages for each resource type
  • convert the data to not all be strings. (ergast sends back all strings)
  • be well tested, unit and integration.
  • have methods for really commmon requests
  • have aquery builder for custom requests
  • inspire more ideas as I go.
  • have constantly improving documentation

Generic Custom Request

from ergast import Request, client

req = Request(resource='results', id='1', criteria=dict(drivers='ricciardo'))

result = client.send(req)
# Result is the data from following request listing the races won by Daniel Ricciardo
# GET http://ergast.com/api/f1/drivers/ricciardo/results/1.json

Convenience Methods by resource type

import ergast

ergast.seasons.by_driver('ricciardo')

# Convenience for doing:
# req = Request(resource='seasons', criteria=dict(drivers='ricciardo'))
# result_data = client.send(req)
# result_data['MRData']['SeasonTable']['Seasons']