Add total_elevation_gain and total_elevation_loss to Stream

[dblock]

Description

Closes #54.

Strava's API doesn't provide a native total_elevation_loss (descent) property on any model. As discussed in the issue, computing it requires either cross-referencing data from multiple endpoints (e.g. Activity for gain plus Stream for start/end elevation), or computing gain/loss directly from an altitude stream's data points.

This PR takes the self-contained approach: it adds total_elevation_gain and total_elevation_loss methods (plus formatted _s helpers) to Strava::Models::Stream, computed by summing the positive/negative deltas between consecutive altitude data points. This requires only a single altitude stream request and no cross-model composition.

streams = client.activity_streams(1946417534, keys: %w[altitude])

streams.altitude.total_elevation_gain # => 725.3
streams.altitude.total_elevation_loss # => 680.1
streams.altitude.total_elevation_gain_s # => "725.3m"
streams.altitude.total_elevation_loss_s # => "680.1m"

Changes

• Adds total_elevation_gain, total_elevation_loss, total_elevation_gain_s and total_elevation_loss_s to Strava::Models::Stream.
• Adds unit tests in spec/strava/models/stream_spec.rb.
• Updates README with usage example.
• Updates CHANGELOG.

[github-actions]

Danger Report

No issues found.

View run