Skip to content

Latest commit

 

History

History
76 lines (42 loc) · 1.83 KB

README.md

File metadata and controls

76 lines (42 loc) · 1.83 KB

SpeedRunsLive Ruby Client

Ruby library to retrieve data from SpeedRunsLive.com.

Notes

I have moved all of my work over to GitLab; you can find this project's new home at https://gitlab.com/bedmonds/srl-api

Installation

The gem is hosted on RubyGems, so you can either install it with gem install srl-api or, if you are using bundler, by adding it to your program's Gemfile and running bundle install.

Documentation

rdoc lib/ from the project root, or let RubyGems do it for you in $GEM_HOME.

Sample Usage

Short version:

require 'srl'

puts SRL.past_races(player: 'Artea', game: 'ffhacks').records.size # => Some number probably in the low 20s.

The examples/ directory should provide you with an adequate amount of usable, real-world examples.

Client code should focus on the SRL module, with its relevant functions being found in lib/srl/api.rb.

One-liners

Fetch a player's stream:

SRL.player('Foobar').stream

Get the leaderboard for a particular game:

SRL.leaderboard('alttphacks') # => array

Retrieve a game's total time played:

SRL.game('ffhacks').stats.total_time_played

OS / Ruby Support

While the code probably runs on Ruby 2.1+, I have not yet tested it on anything lower than 2.3.0.

The library itself should work fine on MS Windows, though the examples will not.

Maintainer

Brian Edmonds "Artea" <brian@bedmonds.net>

Disclaimer

I am not affiliated in any way with SpeedRunsLive.com; I'm just a runner and viewer that likes the convenience of CLI tools. I wrote this small library for myself and my tools, but thought other people might like to use it as well.

Do try to not be a twat; servers and bandwidth cost money, so don't go around writing a cron job that requests outrageous amounts of data every five seconds.