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:
- All tests pass
- Code is formatted with black
- Type hints are included
- Documentation is updated
Author
Prathap Pandian
- Email: mprathappandian@gmail.com
- GitHub: @mprathappandian
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.