Skip to main content

Randonneuring Intelligence

A comprehensive Python library for processing and analyzing randonneuring cycling event data from multiple sources.

Overview

This library provides two main modules for working with randonneuring data:

  • audax_india: Process and analyze Audax India event and participant data
  • lrm: Process and analyze Long Randonnée Medal (LRM) results from worldwide events

Features

Audax India Module (32 functions)

  • Load and merge event catalogs with detailed participant data
  • Filter events by year, club, location, state, distance, status
  • Filter participants by name, club, result status, medal, fee payment
  • Statistical analysis: event stats, club stats, rider stats, completion rates
  • Query functions for unique values across all dimensions

LRM Module (21 functions)

  • Load worldwide LRM result data
  • Filter by year, rider, country, event, club, distance, gender, time
  • Statistical analysis: rider stats, club stats, event stats, time analysis
  • Gender distribution analysis
  • Query functions for unique values

Installation

From source

cd intelligence
pip install -e .

With development dependencies

pip install -e ".[dev]"

Quick Start

Audax India

from randonneuring_intelligence.audax_india import (
    load_events,
    filter_events_by_year,
    get_club_statistics
)

# Load data
events = load_events('data/audax_india/events.json')

# Filter 2023 events
events_2023 = filter_events_by_year(events, year=2023)

# Get club statistics
stats = get_club_statistics(events, "Pune Randonneurs")
print(f"Total events: {stats['total_events']}")

LRM

from randonneuring_intelligence.lrm import (
    load_data,
    filter_by_year,
    get_rider_stats
)

# Load data
records = load_data('data/lrm/results.json')

# Filter and analyze
records_2023 = filter_by_year(records, year=2023)
stats = get_rider_stats(records, "SMITH, John")
print(f"Total events: {stats['total_events']}")

Project Structure

intelligence/
├── src/
│   └── randonneuring_intelligence/
│       ├── __init__.py
│       ├── audax_india/          # Audax India module
│       │   ├── __init__.py
│       │   ├── data_loader.py
│       │   ├── filters.py
│       │   ├── aggregations.py
│       │   └── queries.py
│       └── lrm/                  # LRM module
│           ├── __init__.py
│           ├── data_loader.py
│           ├── filters.py
│           ├── aggregations.py
│           └── queries.py
├── tests/
│   ├── audax_india/
│   └── lrm/
├── docs/
│   ├── audax_india/
│   └── lrm/
├── data/                         # Data files location
├── pyproject.toml               # Project configuration
├── LICENSE
└── README.md

Development

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=src --cov-report=html

# Run specific module tests
pytest tests/audax_india/
pytest tests/lrm/

Code Quality

# Format code
black src/ tests/

# Lint
flake8 src/ tests/

# Type checking
mypy src/

Documentation

Detailed documentation for each module:

Requirements

  • Python >= 3.8
  • No external runtime dependencies (pure Python standard library)

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please ensure:

  1. All tests pass
  2. Code is formatted with black
  3. Type hints are included
  4. Documentation is updated

Author

Prathap Pandian

Metadata

Release files for randonneuring-intelligence 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for randonneuring-intelligence 0.1.2
File Size Uploaded Provenance Actions
randonneuring_intelligence-0.1.2.tar.gz 13.4 kB Without provenance Details for randonneuring_intelligence-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for randonneuring-intelligence 0.1.2
File Interpreter ABI Platform Actions
randonneuring_intelligence-0.1.2-py3-none-any.whl Python 3 none any Details for randonneuring_intelligence-0.1.2-py3-none-any.whl

Total release size: 29.8 kB

Release files / randonneuring_intelligence-0.1.2.tar.gz

Download URL randonneuring_intelligence-0.1.2.tar.gz
Size 13.4 kB
Tags Source
SHA-256 checksum
How to use checksums
978376d61da36796072820c50d7401ac4e57ef64a0fc63eeb5f18c2afd224fed
BLAKE2b-256 checksum
How to use checksums
e9f7a6d7c4d07899b5476b7fd2659d4a33c0bf9ca525c37ff28ce1eba2b1add2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.3

Release files / randonneuring_intelligence-0.1.2-py3-none-any.whl

Download URL randonneuring_intelligence-0.1.2-py3-none-any.whl
Size 16.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cc891f8cb9aa70b8b8259d65c3ee2dfed1fd556eb48a39f67ee8f66359701ef8
BLAKE2b-256 checksum
How to use checksums
a7e73d58357651ac7fe4ca2d34f15d23264ebdb3884164c39d7e3f9bbd84c421
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.3

Security for randonneuring-intelligence 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page