Metadata-Version: 2.1
Name: data_golf
Version: 0.3.0
Summary: API Wrapper for Data golf endpoints
Author: Corey Schaf
Author-email: cschaf@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: httpx
Description-Content-Type: text/markdown

[![Data-Golf-API](https://github.com/coreyjs/data-golf-api/actions/workflows/python-app.yml/badge.svg)](https://github.com/coreyjs/data-golf-api/actions/workflows/python-app.yml)
[![PyPI version](https://badge.fury.io/py/data_golf.svg)](https://badge.fury.io/py/data_golf)


# Data Golf API (Unofficial)

### An Unofficial API Library for DataGolf.com APIs

This is a Python library for interacting with the DataGolf APIs. DataGolf is a golf analytics platform that provides a wide range of data and analytics for golf tournaments, players, and courses.

**This is an unofficial API lib, and it is not affiliated with DataGolf in any way.**


This is being built to support some ML projects I am working on.  I will be 
continuing to add more endpoints as I need them.  If you have a specific endpoint you need, please open a ticket for submit a PR.



---
# Usage
(Currently this only supports JSON formats, CSV is in progress)

```python
pip install data_golf
```

```python
from data_golf import DataGolfClient

client = DataGolfClient(api_key="YOUR_API_KEY")

# For more request logging
client = DataGolfClient(api_key="YOUR_API_KEY", verbose=True)
```


# General APIs

```python
# Player List
players = client.general.player_list()

# Current Season Tour  Schedule
# Can use optinal parameter 'tour' to filter by tour: pga, euro, kft, alt, liv
tour_schedule = client.general.tour_schedule()
tour_schedule = client.general.tour_schedule(tour="pga")
tour_schedule = client.general.tour_schedule(tour="liv")
```
