weglide-client

WeGlide Python Client

A Python client library for the WeGlide API. WeGlide is an online platform where glider pilots can share and analyze their flights, participate in competitions, and connect with the global gliding community.

This package is automatically generated by the OpenAPI Generator project:

• API version: 0.1.0
• Package version: 0.1.5
• Generator version: 7.12.0

Requirements

• Python 3.9+
• Dependencies:
  • urllib3 >= 1.25.3, < 3.0.0
  • python-dateutil >= 2.8.2
  • typing-extensions >= 4.7.1
  • pydantic >= 2.10.6

Installation

From PyPI

pip install weglide-client

For Development

Clone the repository and install in development mode:

git clone https://github.com/develmusa/weglide-python-client.git
cd weglide-python-client
pip install -e .
pip install --group dev .

Or using uv:

git clone https://github.com/develmusa/weglide-python-client.git
cd weglide-python-client
uv venv
uv pip install -e .
uv pip install --group dev .

Getting Started

Basic Usage

import weglide_client
from weglide_client.rest import ApiException
from pprint import pprint

# Configure the API client
# The host defaults to https://api.weglide.org if not specified
configuration = weglide_client.Configuration(
    host="https://api.weglide.org"
)

# Create an API client instance
with weglide_client.ApiClient(configuration) as api_client:
    # Create an instance of an API class
    airport_api = weglide_client.AirportApi(api_client)
    
    try:
        # Get information about a specific airport
        airport_id = 161522  # Example airport ID
        api_response = airport_api.get_airport_v1_airport_id_get(id=airport_id)
        print("Airport information:")
        pprint(api_response)
    except ApiException as e:
        print(f"Exception when calling AirportApi: {e}")

Authentication

For endpoints that require authentication, you'll need to provide an API token:

import weglide_client
from weglide_client.rest import ApiException

# Configure API key authorization
configuration = weglide_client.Configuration(
    host="https://api.weglide.org",
    api_key={"Authorization": "YOUR_API_KEY"},
    api_key_prefix={"Authorization": "Bearer"}
)

# Use the authenticated client
with weglide_client.ApiClient(configuration) as api_client:
    # Access protected endpoints
    flight_api = weglide_client.FlightApi(api_client)
    # ...

Environment Variables

You can also configure the client using environment variables:

import os
import weglide_client

# Set environment variables
os.environ["WEGLIDE_API_URL"] = "https://api.weglide.org"
os.environ["WEGLIDE_API_KEY"] = "YOUR_API_KEY"

# Configure using environment variables
configuration = weglide_client.Configuration()
configuration.host = os.environ.get("WEGLIDE_API_URL", "https://api.weglide.org")
if "WEGLIDE_API_KEY" in os.environ:
    configuration.api_key = {"Authorization": os.environ["WEGLIDE_API_KEY"]}
    configuration.api_key_prefix = {"Authorization": "Bearer"}

Available API Endpoints

The client provides access to the following WeGlide API endpoints:

• Achievement API: Access user achievements
• Aircraft API: Manage aircraft information
• Airport API: Access airport data
• Auth API: Handle authentication
• Badge API: Access badge information
• Club API: Manage club data
• Comment API: Handle flight comments
• Competition API: Access competition data
• Flight API: Manage flight data and uploads
• User API: Manage user profiles
• Waypoint API: Access waypoint information

For detailed API documentation, visit the WeGlide API Documentation.

Examples

Fetching Flights

import weglide_client
from weglide_client.rest import ApiException

configuration = weglide_client.Configuration()
with weglide_client.ApiClient(configuration) as api_client:
    flight_api = weglide_client.FlightApi(api_client)
    
    try:
        # Get recent flights
        flights = flight_api.get_flights_v1_flight_get(limit=10)
        for flight in flights:
            print(f"Flight ID: {flight.id}, Pilot: {flight.user.name}, Date: {flight.date}")
    except ApiException as e:
        print(f"Exception when calling FlightApi: {e}")

Working with Airports

import weglide_client
from weglide_client.rest import ApiException

configuration = weglide_client.Configuration()
with weglide_client.ApiClient(configuration) as api_client:
    airport_api = weglide_client.AirportApi(api_client)
    
    try:
        # Search for airports
        airports = airport_api.search_airports_v1_airport_search_get(
            query="Munich",
            limit=5
        )
        for airport in airports:
            print(f"Airport: {airport.name}, ICAO: {airport.icao}, Elevation: {airport.elevation}m")
    except ApiException as e:
        print(f"Exception when calling AirportApi: {e}")

Testing

Run the tests using unittest:

python -m unittest discover -s test

Or using tox to test across multiple Python versions:

tox

License

This project is licensed under the MIT License.

Links

• PyPI Package
• GitHub Repository
• WeGlide Website
• WeGlide API Documentation