bishl

A tiny little ruby wrapper around the XML api of www.bishl.de .

Installation via Bundler is easy to setup. Put the following line to your Gemfile:

gem "bishl"

To ride "cutting edge" use github as gem source:

gem "bishl", :git => "git://github.com/dsci/bishl.git"

Pure Ruby

For Ruby implementation take a closer look to the RSpec files. Due to the fact that the XML API of the BISHL website currently only supports standings for several years, getting involved with the bishl Ruby gem is very simple:

require "rubygems"
require "bishl"

standings = BISHL.standings(:season => "2010", :cs => "LLA")

Standings is an array. Every item of the array is accessible as Hash:

standing.map(&:hashify)

Sample for hashify

next_games = BISHL.next_game_for(:season => "2012", :cs => "LLA",  :team => "74")

p next_games.map(&:hashify)

#=> [{:startdate=>#<DateTime: 2012-04-22T18:00:00+02:00 (14736241/6,1/12,2299161)>, :hometeam=>"Pleiszegeier Leipzig", :awayteam=>"Powerkrauts Berlin", :gameid=>1423, :stadium=>"Mehrzweckhalle Taucha", :goalshome=>"", :goalsaway=>"", :overtime=>0, :shootout=>0, :awayteamid=>4, :hometeamid=>74}]  

Same for parsing schedule.

require "rubygems"
require "bishl"

schedule = BISHL.schedule(:season => "2010", :cs => "LLA", :team => 74)

Note the additional team id.

It also gives you the opportunity to fetch the team's logo:

  BISHL.logo_for(:team => 74)

which returns an url.

Sinatra

In your Sinatra file:

require "rubygems"
require "bishl"

include Bishl::HtmlHelper

In your View:

    <%=bishl_standings({:season => "2010", :cs => "LLA", :css =>
                                      {:table_class => "myTable",
                                       :odd_class => "myOdd",
                                       :even_class => "myEven"}
                       })%>

Rails

For rails just include the gem to your Gemfile and and follow the instruction at the Sinatra/View section.

The creator of the BISHL website (bishl.de), Marian Strüby compiles an overview of possible combinations:

Notice, that the bishl Ruby gem forces you to specify the season and cs params.

h2. Contributing to bishl

• Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
• Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
• Fork the project
• Start a feature/bugfix branch
• Commit and push until you are happy with your contribution
• Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
• Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

h2. Copyright

Copyright (c) 2011 Daniel Schmidt. See LICENSE.txt for further details.