0.0
No commit activity in last 3 years
No release in over 3 years
Ruby client for the Riksteatern API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 1.3
>= 0
 Project Readme

Riksteatern

A small Ruby client for the Riksteatern API.

You can find out more about the API (In Swedish) on http://data.riksteatern.se/.

Build Status Gem Version

Dependencies

No runtime dependencies. Bundler, Rake and Minitest are required for development.

Installation

Add this line to your application's Gemfile:

gem 'riksteatern'

And then execute:

$ bundle

Or install it yourself as:

$ gem install riksteatern

Usage

You need to be authenticated to use the API.

Access request: http://data.riksteatern.se/ansokan/

Riksteatern.account('<USERNAME>', '<PASSWORD>')

Now you are ready to start fetching data :)

# Find an event by id
e = Riksteatern::Event.find(992423)
e.name #=> "En mans föreställning"

# Number of events in Stockholms län
Riksteatern::Event.all(regionName: 'Stockholms län').size #=> 46

# Find a venue by id
v = Riksteatern::Venue.find(2260101)

## The region name of the location
v.location.region #=> "Västernorrlands län"

## Print the address of the venue
puts v.address

# Find a production by id
p = Riksteatern::Production.find(42)

## Get the number of pictures
p.pictures.size #=> 4

## Get the categories of the production
p.categories #=> ["Barn/Skola", "Teater", "Mim", "Musikteater"]

You might also want to take a look at the specs

Suggestions for improving the API

  • Correct the spelling of accesibility sic
  • Change category to categories since it is a list
  • Upper limit on how many results to return
  • Pagination of results

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request