HaloStats
A ruby gem wrapper for the Halo 5 API.
Requirements
All versions of MRI 1.9.3+ and up are supported (and tested via CircleCI), the gem is currently unsupported on JRuby, MRI 1.8-1.9.2, and Rubinus. Support of these platforms is a future goal for the project.
Installation
Add this line to your application's Gemfile:
gem 'halo_stats'
And then execute:
$ bundle
Or install it yourself as:
$ gem install halo_stats
Usage
Quick Use
The first step is to instantiate some clients for the data we would like to grab:
stats_client = Halo::StatsClient.new(api_key: 'APIKEY')
profile_client = Halo::StatsClient.new(api_key: 'APIKEY')
metadata_client = Halo::StatsClient.new(api_key: 'APIKEY')
From here you can begin calling your any api methods! So an example of call flow would be:
matches_response = stats_client.get_matches('GAMERTAG')
arena_match_response = stats_client.get_arena_carnage_report(match_response.first["Id"]["MatchId"])
game_variant_response = metadata_client.get_game_variants(match_response["GameVariantId"])
spartan_image_url = profile_client.get_spartan_image('GAMERTAG')
Results are returned as parsed ruby objects (generally a hash or an array of hashes).
Contributing
- Fork it ( https://github.com/kylegrantlucas/halo_stats/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request