`;
```
--------------------------------
### Calculate Career Statistics with Python
Source: https://context7.com/thecommishdeuce/tennisabstract/llms.txt
Computes lifetime aggregated statistics for a player based on their match history.
```python
from mod import get_player_matches, calculate_career_stats
matches = get_player_matches("Serena Williams")
career = calculate_career_stats(matches)
print(career.loc['career', ['W-L', 'win%', 'tb_W-L', 'tb_win%', 'top5_W-L', 'top5_win%']])
# W-L 857-153
# win% 84.8
# tb_W-L 142-98
# tb_win% 59.2
# top5_W-L 98-45
# top5_win% 68.5
```
--------------------------------
### Access Player Directory
Source: https://context7.com/thecommishdeuce/tennisabstract/llms.txt
Retrieves ranked player lists and provides autocomplete suggestions for player names.
```python
from mod import get_players, suggest_players
# Get all ranked players
all_players = get_players()
print(f"ATP players: {len(all_players['ATP'])}, WTA players: {len(all_players['WTA'])}")
# Get specific tour
atp_players = get_players(tour='ATP')
print(f"Top 5 ATP: {[p['name'] for p in atp_players[:5]]}")
# Force refresh from web
fresh_players = get_players(tour='WTA', force_refresh=True)
# Autocomplete suggestions
suggestions = suggest_players("nad", limit=5)
print(suggestions)
# [{'label': 'Rafael Nadal', 'value': 'Rafael Nadal', 'tour': 'ATP'}]
# Filter by tour
wta_suggestions = suggest_players("sab", limit=3, tour='WTA')
print(wta_suggestions)
# [{'label': 'Aryna Sabalenka', 'value': 'Aryna Sabalenka', 'tour': 'WTA'}]
```
--------------------------------
### Render Match Statistics HTML
Source: https://github.com/thecommishdeuce/tennisabstract/blob/main/templates/career.html
Generates the HTML structure for displaying match statistics like hold percentage and opponent rank comparisons.
```javascript
class="stat-name">Hold %
`; $('#yearStats').html(statsHtml); updateTrendChart(surface);
```
--------------------------------
### Retrieve Career Statistics via REST API
Source: https://context7.com/thecommishdeuce/tennisabstract/llms.txt
Fetches comprehensive career statistics for a specified player using a POST request.
```bash
# Get career statistics for a player
curl -X POST "http://localhost:5002/career" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "player=Iga Swiatek"
```
--------------------------------
### Player Autocomplete Search
Source: https://context7.com/thecommishdeuce/tennisabstract/llms.txt
Provides autocomplete suggestions for player names. Accepts a query parameter 'q' for the search term and an optional 'tour' parameter to filter results. The 'limit' parameter controls the number of suggestions returned.
```bash
# Search for players matching query
curl -X GET "http://localhost:5002/api/player-suggest?q=djok&limit=5"
```
```json
{
"suggestions": [
{"label": "Novak Djokovic", "value": "Novak Djokovic", "tour": "ATP"}
]
}
```
```bash
# Filter by tour
curl -X GET "http://localhost:5002/api/player-suggest?q=iga&tour=WTA&limit=3"
```
```json
{
"suggestions": [
{"label": "Iga Swiatek", "value": "Iga Swiatek", "tour": "WTA"}
]
}
```
--------------------------------
### Render ATP Player List in Jinja2
Source: https://github.com/thecommishdeuce/tennisabstract/blob/main/templates/players.html
Iterates through the ATP player list to display rank, name, country, and age. Uses Jinja2 templating for dynamic content generation.
```html
{% for p in atp_players %} {% endfor %}
Rank
Player
Nat
Age
{{ p.rank }}
[{{ p.name }}]({{ url_for('career_stats', player=p.name) }})
{{ p.country or '-' }}
{% if p.age is not none %} {{ "%.1f"|format(p.age) }} {% else %} - {% endif %}
```
--------------------------------
### API and Request Configuration
Source: https://context7.com/thecommishdeuce/tennisabstract/llms.txt
Configures API base URLs, request delays, and retry attempts. Adjust these settings to manage API interaction and prevent rate limiting.
```python
# API Configuration
BASE_URL = 'https://www.tennisabstract.com'
TA_REPORTS_BASE = f"{BASE_URL}/reports"
REQUEST_DELAY = 0.5 # Delay between requests in seconds
REQUEST_RETRIES = 3 # Number of retries for failed requests
```
--------------------------------
### Format Player Form String
Source: https://github.com/thecommishdeuce/tennisabstract/blob/main/templates/career.html
Formats a string representing a player's recent match results (W for win, L for loss) into HTML badges. Displays up to the first 10 results.
```javascript
function displayFormString(formString) {
let html = '';
for (let i = 0; i < formString.length && i < 10; i++) {
const result = formString[i];
html += `${result}`;
}
return html;
}
```
--------------------------------
### Generate Year and Surface Navigation - JavaScript
Source: https://github.com/thecommishdeuce/tennisabstract/blob/main/templates/career.html
Dynamically generates HTML for year and surface navigation buttons based on response data. Includes event listeners for displaying statistics.
```javascript
contentHtml += ''; const sortedYears = response.yearly_stats.map(y => y.year).sort((a, b) => b - a); sortedYears.forEach(year => { contentHtml +=
`
`; }); contentHtml += ''; contentHtml +=
`
';
return html;
}
```
--------------------------------
### Jinja Template Structure for Player Comparison
Source: https://github.com/thecommishdeuce/tennisabstract/blob/main/templates/compare.html
This Jinja template defines the overall structure for the player comparison page, including placeholders for player names, year, and comparison results. It also includes logic for iterating through years.
```html
{% extends "base.html" %} {% block content %}
Player Comparison
-----------------
Player 1
Player 2
Year Career {% for year in range(current_year, 1999, -1) %} {{ year }} {% endfor %}
Compare Players
Loading...
Analyzing player statistics...
{% endblock %} {% block extra_js %}
```
--------------------------------
### Head to Head Analysis Frontend Logic
Source: https://github.com/thecommishdeuce/tennisabstract/blob/main/templates/h2h.html
Handles form submission, AJAX data fetching, and dynamic DOM manipulation for displaying match history and charts.
```javascript
function getSurfaceClass(surface) { const surfaceMap = { 'Hard': 'surface-hard', 'Clay': 'surface-clay', 'Grass': 'surface-grass', 'Carpet': 'surface-hard' }; return surfaceMap[surface] || 'surface-hard'; } let h2hProgressChart = null, h2hSurfacesChart = null, h2hRoundsChart = null; $('#h2hForm').on('submit', function(e) { e.preventDefault(); $('.loading').show(); $('.error-message').hide(); $('#results').empty(); $.ajax({ url: '/h2h', method: 'POST', data: $(this).serialize(), success: function(response) { $('.loading').hide(); const p1 = response.summary.player1; const p2 = response.summary.player2; // Hero summary let summaryHtml = `