SwimRankings Python Library

A modern Python library for interacting with swimrankings.net (opens in a new tab), providing easy access to athlete data, search functionality, and more.

Features

• 🏊‍♀️ Athlete Search: Search for athletes by name, gender, and other criteria
• 📊 Type Hints: Full type annotation support for better IDE experience
• 🔍 Flexible Filtering: Filter athletes by gender, country, club, etc.
• 🚀 Robust: Comprehensive error handling and testing

Quick Start

Installation

pip install swimrankings

Basic Usage

from swimrankings import Athletes
 
# Search for athletes by name
athletes = Athletes(name="Druwel")
for athlete in athletes:
    print(f"{athlete.full_name} ({athlete.birth_year}) - {athlete.country}")
 
# Search for male athletes only
male_athletes = Athletes(name="Druwel", gender="male")
 
# Search for female athletes only  
female_athletes = Athletes(name="Druwel", gender="female")

Getting Started

Community

Ready to dive in? Check out the installation guide to get started!