Skip to content

About

Utilize the Challonge! API with preconfigured ActiveResource classes.

Resources

Stars

0 stars

Watchers

1 watching

Forks

 
 

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Challonge Ruby Gem

Utilize the CHALLONGE! API with preconfigured ActiveResource classes.

Install and Configure

Add challonge-api to your Gemfile:

gem 'challonge-api'

Add challonge-api as a dependency for your project and set your username and API key on startup.

Challonge::API.username = 'username'
Challonge::API.key = '123keyayaonge'

Basic Usage

Get all your tournaments:

Challonge::Tournament.find(:all)

Get a filtered set of tournaments:

Challonge::Tournament.find(:all, :params => {:state => 'in_progress'})

Run a basic tournament from start to finish:

t = Challonge::Tournament.new
t.name = 'Basic Single Elim Tournament'
t.url = 'unique_url_123'
t.tournament_type = 'single elimination'
t.save
# if save returns false, view validation errors with t.errors.full_messages

# add some participants
Challonge::Participant.create(:name => 'Joe', :tournament => t)
Challonge::Participant.create(:name => 'Bob', :tournament => t)

t.start!
# at this point, t.live_image_url and t.full_challonge_url are available (t.reload to refetch)

m = t.matches(:first)
m.scores_csv = '3-1,3-2'
m.winner_id = m.player1_id
m.save
# congratulations, Joe

t.finalize!
# Finalize a tournament, rendering its results permanent.

About

Utilize the Challonge! API with preconfigured ActiveResource classes.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages