Home

Strava.cz Python API - Wiki

Welcome to the strava-cz-python library documentation! This is a high-level Python API for interacting with the Strava.cz web application (Czech school canteen ordering system).

📚 Table of Contents

Getting Started

• Installation Guide - How to install and set up the library
• Quick Start - Get up and running in 5 minutes
• Authentication - Login, logout, and session management

Core Concepts

• Menu System - Understanding the Menu class and meal data structure
• Meal Types and Orders - MealType and OrderType enums explained

Advanced Usage

• Ordering Meals - How to order and cancel meals
• Error Handling - Understanding exceptions and error recovery

Development

• API Internals - Understanding the Strava.cz API endpoints
• Contributing - How to contribute to the project
• Changelog - Version history and breaking changes

Migration

• Migration Guide v0.2.0 - Upgrading from v0.1.x to v0.2.0

🚀 Quick Example

from strava_cz import StravaCZ, MealType, OrderType

# Login
strava = StravaCZ(
    username="your.username",
    password="YourPassword123",
    canteen_number="3753"
)

# Get menu
strava.menu.fetch()
strava.menu.print()

# Order meals
strava.menu.order_meals(3, 6)

# Logout
strava.logout()

📦 Features

• ✅ Authentication System - Login/logout functionality
• ✅ Menu Browsing - Fetch and display canteen menu
• ✅ Meal Ordering - Order and cancel meals by ID
• ✅ Smart Filtering - Filter meals by type, order status, and more
• ✅ Automatic Validation - Duplicate detection, type checking, balance verification
• ✅ Error Handling - Comprehensive exception system
• ✅ Balance Tracking - Real-time account balance monitoring

🔗 Links

• GitHub Repository: jsem-nerad/strava-cz-python
• PyPI Package: strava-cz
• Issue Tracker: GitHub Issues

📄 License

This project is licensed under the GPL-3.0-or-later License.

⚠️ Current Version

v0.2.0 - This version includes breaking changes from v0.1.x. See the Migration Guide for details.

AI usage

These wiki pages have been created and formated by an LLM

Tato wiki dokumentace byla vytvorena a formatovana za pomoci LLM