feat: add stats resource with 10 endpoints #26
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
added 6 commits
November 21, 2025 19:47
Implements comprehensive stats resource providing analytical insights: - Geographic stats (country_players, state_players, state_tournaments) - Historical trends (events_by_year, players_by_year) - Tournament rankings (largest_tournaments, lucrative_tournaments) - Period analytics (points_given_period, events_attended_period) - System metrics (overall) Includes 22 Pydantic models for stats requests/responses. API coverage increased from 36 to 46 endpoints (7 resources total).
Adds 1333 lines of unit tests and 642 lines of integration tests for the Stats API resource. Tests cover all 10 endpoints with inline mock data for unit tests and real API calls for integration. Includes stats-specific test fixtures and helpers in conftest.py: - Date range fixtures (90 days, 180 days, full year) - Stats threshold fixtures for validation - Rank type fixtures for parameterized testing - Helper functions for field validation and ranking assertions
Updates MkDocs documentation to include Stats resource: - Update API coverage count: 36 → 46 endpoints - Add Stats row to resources table with description - Add Stats to resource navigation links - Update mkdocs.yml navigation to include stats.md
Updates README with Stats resource documentation: - Update API coverage: 36 → 46 endpoints, 6 → 7 resources - Add Stats section with usage examples showing: - Overall IFPA statistics - Top point earners by period - Largest tournaments by country - Player counts by country - Most active players by period
Adds comprehensive v0.4.0 release notes documenting: - 10 new Stats API endpoints (geographic, historical, rankings, period-based) - 22 new Pydantic models for stats responses - 1333 lines of unit tests, 642 lines of integration tests - Stats-specific test fixtures and helpers - Known API issue with WOMEN parameter in overall() endpoint Updates version links for 0.4.0 and 0.3.0 releases.
|
Codecov Report❌ Patch coverage is
📢 Thoughts on this report? Let us know! |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds comprehensive Stats API resource with 10 operational endpoints for IFPA statistical data and analytics.
Changes
Core Implementation:
src/ifpa_api/models/stats.py(602 lines)src/ifpa_api/resources/stats/client.py(490 lines)10 Stats Endpoints:
country_players(),state_players(),state_tournaments()events_by_year(),players_by_year()largest_tournaments(),lucrative_tournaments()points_given_period(),events_attended_period()overall()Testing:
Documentation:
Migration Strategy:
Testing
Related Issues
Closes stats resource implementation from project backlog.
Checklist