# walrusquant/pgatourpy architecture

> Architecture diagram of the GitHub repository walrusquant/pgatourpy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/walrusquant/pgatourpy
- Repository: https://github.com/walrusquant/pgatourpy

## Overview

pgatourPY is a Python client that exposes PGA Tour data as pandas DataFrames. Users call its public functions for live tournament data, player and tournament records, statistics and standings, or editorial content; those functions retrieve API data and shape it for use. The internal request layer handles GraphQL, REST and configuration requests, while parsing helpers normalize labels and compressed payloads. The README documents the capabilities; sampled source confirms request handling and parsing, but not every client-to-operation mapping.

Main entry points: [`src/pgatourpy/_api.py`](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/_api.py) (Request Layer), [`src/pgatourpy/__init__.py`](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/__init__.py) (Public Functions), [`src/pgatourpy/client.py`](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py) (Client Functions), [`src/pgatourpy/stat_ids.py`](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/stat_ids.py) (Stat Lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public API"]
  node_exports["Public Functions<br/>[__init__.py]"]
end

subgraph group_sports["Golf Data"]
  node_tournament["Tournament Data<br/>[client.py]"]
  node_live["Live Scoring<br/>[client.py]"]
  node_shots["Shot Tracking<br/>[client.py]"]
  node_stats["Stats &amp; Standings<br/>[client.py]"]
  node_statids["Stat Lookup<br/>[stat_ids.py]"]
  node_players["Player Profiles<br/>[client.py]"]
end

subgraph group_content["Content"]
  node_contentdata["News &amp; Video<br/>[client.py]"]
  node_generic["CMS Content<br/>[client.py]"]
end

subgraph group_internal["Client Internals"]
  node_client["Client Functions<br/>[client.py]"]
  node_transport["Request Layer<br/>[_api.py]"]
  node_queries["GraphQL Operations"]
  node_parsing["Parsing Helpers<br/>[_parse.py]"]
end

node_user(("Python User"))
node_graphqlsvc{{"PGA GraphQL API"}}
node_restsvc{{"PGA REST API"}}
node_configsvc{{"PGA Config API"}}

node_user -->|"calls"| node_exports
node_exports -->|"exports"| node_client
node_user -->|"requests"| node_tournament
node_user -->|"requests"| node_live
node_user -->|"requests"| node_shots
node_user -->|"requests"| node_stats
node_user -->|"requests"| node_players
node_user -->|"requests"| node_contentdata
node_user -->|"requests"| node_generic
node_client -->|"requests data"| node_transport
node_transport -->|"loads queries"| node_queries
node_transport -->|"sends GraphQL"| node_graphqlsvc
node_transport -->|"sends REST"| node_restsvc
node_transport -->|"requests config"| node_configsvc
node_client -->|"uses helpers"| node_parsing
node_exports -->|"exports lookup"| node_statids

click node_exports "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/__init__.py"
click node_tournament "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_live "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_shots "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_stats "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_statids "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/stat_ids.py"
click node_players "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_contentdata "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_generic "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_client "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py"
click node_transport "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/_api.py"
click node_queries "https://github.com/walrusquant/pgatourpy/tree/main/src/pgatourpy/graphql"
click node_parsing "https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/_parse.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_exports,node_user toneBlue
class node_tournament,node_live,node_shots,node_stats,node_statids,node_players toneAmber
class node_contentdata,node_generic,node_graphqlsvc,node_restsvc,node_configsvc toneMint
class node_client,node_transport,node_queries,node_parsing toneRose
```

## Components

### Public API

- [Public Functions](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/__init__.py): `src/pgatourpy/__init__.py`

### Golf Data

- [Tournament Data](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`
- [Live Scoring](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`
- [Shot Tracking](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`
- [Stats & Standings](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`
- [Stat Lookup](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/stat_ids.py): `src/pgatourpy/stat_ids.py`
- [Player Profiles](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`

### Content

- [News & Video](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`
- [CMS Content](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`

### Client Internals

- [Client Functions](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/client.py): `src/pgatourpy/client.py`
- [Request Layer](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/_api.py): `src/pgatourpy/_api.py`
- [GraphQL Operations](https://github.com/walrusquant/pgatourpy/tree/main/src/pgatourpy/graphql): `src/pgatourpy/graphql`
- [Parsing Helpers](https://github.com/walrusquant/pgatourpy/blob/main/src/pgatourpy/_parse.py): `src/pgatourpy/_parse.py`

### Other components

- **Python User**
- **PGA GraphQL API**
- **PGA REST API**
- **PGA Config API**

## Connections

- Python User → Public Functions: calls (evidence: `README.md`)
- Public Functions → Client Functions: exports (evidence: `src/pgatourpy/__init__.py`)
- Python User → Tournament Data: requests (evidence: `README.md`)
- Python User → Live Scoring: requests (evidence: `README.md`)
- Python User → Shot Tracking: requests (evidence: `README.md`)
- Python User → Stats & Standings: requests (evidence: `README.md`)
- Python User → Player Profiles: requests (evidence: `README.md`)
- Python User → News & Video: requests (evidence: `README.md`)
- Python User → CMS Content: requests (evidence: `README.md`)
- Client Functions → Request Layer: requests data (evidence: `src/pgatourpy/client.py`)
- Request Layer → GraphQL Operations: loads queries (evidence: `src/pgatourpy/_api.py`)
- Request Layer → PGA GraphQL API: sends GraphQL (evidence: `src/pgatourpy/_api.py`)
- Request Layer → PGA REST API: sends REST (evidence: `src/pgatourpy/_api.py`)
- Request Layer → PGA Config API: requests config (evidence: `src/pgatourpy/_api.py`)
- Client Functions → Parsing Helpers: uses helpers (evidence: `src/pgatourpy/client.py`)
- Public Functions → Stat Lookup: exports lookup (evidence: `src/pgatourpy/__init__.py`)
