feat: Enhances Route API with file export and athlete ID parameter

[obalunenko]

Summary

This pull request significantly enhances the Strava Go API client by enabling direct export of GPX and TCX route files and ensuring the GetRoutesByAthleteId endpoint correctly utilizes the athlete ID as a path parameter. It also includes comprehensive improvements to development tooling and the integration test suite.

Type of change (select all that apply)

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Refactoring (a change that only restructures existing code)
• Build related changes (related to building the application or its environment)
• Documentation change (a change to documentation only)

What's Changed

• The GetRouteAsGPX and GetRouteAsTCX methods in the Routes API now return ([]byte, error), providing the raw file content directly.
• The GetRoutesByAthleteId method has been updated to accept the athlete ID as a required path parameter.
• The client initialization now registers custom consumers for application/gpx+xml, application/tcx+xml, and other relevant XML/text MIME types to correctly handle file downloads.
• Integration tests in examples/client_example_test.go are now marked with an integration build tag, include new tests for fetching routes by athlete ID and exporting files, and feature more robust skipping logic.
• The README.md has been updated with instructions for running integration tests.
• The deployments/docker-compose/go-tools-docker-compose.yml file has been streamlined by removing several unused build and test services.
• Minor correction in Makefile for the format-code phony target.
• The docs/swagger.json reflects the updated route export produces media types and the id path parameter for getRoutesByAthleteId.
• A parameter setting for sportType in CreateActivity was corrected from SetType(&sportType) to SetSportType(sportType).

Breaking Changes

The following changes are breaking for users of the client/routes.go interface:

• The GetRouteAsGPX and GetRouteAsTCX method signatures have changed from (ctx context.Context, id int64) error to (ctx context.Context, id int64) ([]byte, error).
• The GetRoutesByAthleteId method signature has changed from (ctx context.Context, opts ...GetRoutesByAthleteIdOpts) ([]models.Route, error) to (ctx context.Context, id int64, opts ...GetRoutesByAthleteIdOpts) ([]models.Route, error), adding a required id parameter.

Proposed Changes

• Implement robust file export capabilities for Strava routes in GPX and TCX formats, allowing direct retrieval of file content.
• Ensure the GetRoutesByAthleteId endpoint strictly adheres to the OpenAPI specification by correctly processing the athlete ID as a path parameter.
• Enhance the client's ability to handle diverse media types by explicitly registering consumers for various XML and text formats.
• Optimize the development and testing workflow by refactoring integration tests, introducing a dedicated build tag, and expanding test coverage for route functionalities.
• Streamline the project's build and development environment by pruning the go-tools-docker-compose.yml file.

Additional Information

These changes were made on the develop branch, reflecting ongoing feature development and improvements.

Related Issues