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

Authors

Prathap Pandian (mprathappandian@gmail.com)

Metadata

Release files for randonneuring-intelligence 0.1.1

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.1
File Size Uploaded Provenance Actions
randonneuring_intelligence-0.1.1.tar.gz 13.4 kB Without provenance Details for randonneuring_intelligence-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 29.7 kB

Release files / randonneuring_intelligence-0.1.1.tar.gz

Download URL randonneuring_intelligence-0.1.1.tar.gz
Size 13.4 kB
Tags Source
SHA-256 checksum
How to use checksums
5b57fea9cc57b35e5cfc6f2ef997b66ae77a812c4dd1a730fe158ed69582f1ec
BLAKE2b-256 checksum
How to use checksums
c5a75b3334730ed5453b677f8218d923f6eb15ec58239a09d6d219ff15058a2d
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.1-py3-none-any.whl

Download URL randonneuring_intelligence-0.1.1-py3-none-any.whl
Size 16.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4e2afc5320476835b75215a3c7049756b50199569c1c307079fb6f962cd67eef
BLAKE2b-256 checksum
How to use checksums
48762914ce417095161b4bb4f75913f1927f890bcc2a5ef0f8146cad055078f3
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.1

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