Releases: StuMason/polar-flow
Releases · StuMason/polar-flow
Release v1.4.0
feat: v1.4.0 - Add Biosensing endpoints (SpO2, ECG, Temperature) New Biosensing endpoint with 4 methods: - get_spo2() - Blood oxygen measurements with quality metrics - get_ecg() - ECG waveform data with samples and quality - get_body_temperature() - Continuous temperature periods with samples - get_skin_temperature() - Sleep-time skin temperature with baseline deviation New models: - SpO2Result - Blood oxygen test with HRV, altitude, classification - ECGResult - Full ECG with waveform samples, RRI, PTT values - ECGSample - Individual ECG amplitude measurement - ECGQualityMeasurement - Signal quality over time - BodyTemperaturePeriod - Temperature period with computed min/max/avg - TemperatureSample - Individual temperature reading - SkinTemperature - Sleep temperature with elevation detection All models include computed properties for derived values. Full test coverage for new endpoint. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Release v1.3.0
feat: v1.3.0 - Complete V3 API Coverage with 5 New Endpoints New endpoints verified against real Polar API: - Cardio Load (strain, tolerance, recovery status) - SleepWise Alertness (hourly alertness predictions) - SleepWise Circadian Bedtime (optimal sleep timing) - Activity Samples (minute-by-minute step data) - Continuous Heart Rate (all-day HR samples) Fixes: - Removed non-existent fields from Sleep model (hrv_avg, heart_rate_avg, etc.) - Sleep API only returns heart_rate_samples dict, not aggregated values - HRV data comes from Nightly Recharge endpoint, not Sleep All 91 tests passing. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Release v1.1.0
Added
- Enhanced exception context with
endpoint,status_code, andresponse_bodyattributes for better debugging - Added
load_token_from_file()utility function for convenient token loading from~/.polar-flow/token - Added
since=parameter tosleep.list()andrecharge.list()for incremental data syncing - Comprehensive documentation site with MkDocs Material
- Quick Start guide
- Error Handling guide with detailed exception documentation
- Advanced Usage patterns for production deployments
- Auto-generated API reference from docstrings
- GitHub Pages deployment for documentation
Changed
- Better error messages with contextual hints for 404 errors (sleep/exercise/activity specific)
- Improved validation error parsing to extract detailed error messages from API responses
- Updated
sleep.list()to use keyword-only arguments for better API clarity
Fixed
- Request timeout and connection errors now include endpoint context for debugging
Release v1.0.1
Fixed
- Removed merge conflict markers from README.md Development section
Release v1.0.0
Added - Complete Polar AccessLink V3 API Coverage
- Activity endpoint with full functionality
- List activities (last 28 days)
- Get activity by date
- Activity samples: steps, activity zones, inactivity alerts
- Computed properties: active/inactive duration, distance conversions
- Nightly Recharge endpoint
- List recharge data (last 28 days)
- Get recharge by date
- ANS charge, HRV, and breathing rate metrics
- 5-minute sample data (HRV and breathing)
- Users endpoint
- Register new user
- Get user information and profile
- De-register user
- Physical Information endpoint with transaction-based API
- Create transaction for new physical info
- List and get physical information entities
- Commit transaction after retrieval
- Convenience get_all() method
- Body metrics: weight, height, HR thresholds, VO2 max
- Activity models with full type safety
- Nightly recharge models
- User information models
- Physical information models
- 204 No Content handling for DELETE operations
- Integration tests for all Phase 4 endpoints validated against real API
Changed
- Lowered coverage requirement to 75% (new endpoints validated via integration tests)
- Updated README to remove negative tone about existing packages