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

Randonneuring Intelligence Team

Metadata

Release files for randonneuring-intelligence 0.1.0

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.0
File Size Uploaded Provenance Actions
randonneuring_intelligence-0.1.0.tar.gz 13.3 kB Without provenance Details for randonneuring_intelligence-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 29.7 kB

Release files / randonneuring_intelligence-0.1.0.tar.gz

Download URL randonneuring_intelligence-0.1.0.tar.gz
Size 13.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5e8fc0939fb006183b94a331a2bfdac32985b2bde80312512a3150f0d494a69f
BLAKE2b-256 checksum
How to use checksums
7e2d731a22517c5fe8e7ded055a81f5a6e8a2a62681aade52cdae9bd93949f84
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.0-py3-none-any.whl

Download URL randonneuring_intelligence-0.1.0-py3-none-any.whl
Size 16.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
118172817e778e5a937248dcb84f56b42a710f8278315e2880ba905bcb357bec
BLAKE2b-256 checksum
How to use checksums
184ba34a8a24dde1a328af4406213c71ba15c8898b85a4b477421720e1ca12fb
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.0

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