https://github.com/endel/songsterr-api

A Ruby wrapper for the Songsterr REST API
https://github.com/endel/songsterr-api

Last synced: about 1 year ago
JSON representation

A Ruby wrapper for the Songsterr REST API

• Host: GitHub
• URL: https://github.com/endel/songsterr-api
• Owner: endel
• License: mit
• Created: 2011-11-13T03:49:19.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2012-01-22T18:12:27.000Z (over 14 years ago)
• Last Synced: 2025-04-12T20:07:09.708Z (about 1 year ago)
• Language: Ruby
• Homepage: https://rubygems.org/gems/songsterr
• Size: 168 KB
• Stars: 2
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
songsterr-api

===

Simple [Songsterr API](http://www.songsterr.com/a/wa/api) Consumer written in Ruby.

Tested on Ruby 1.9.2

Installation

---

    gem install songsterr

Documentation

----

See API documentation on [here](http://endel.github.com/songsterr-api)

Usage sample

---

Finding songs.

    # Each case above returns an Array of Song

    Songsterr::Song.where(:pattern => "Marley")

    Songsterr::Song.where(:artist => "Black Sabbath")

    Songsterr::Song.where(:artists => ["Black Sabbath", "Metallica"])

Getting song information:

    # Get first Song from some artist

    song = Songsterr::Song.where(:artist => "Black Sabbath").first

    song.title

    # => "Iron Man"

    song.revision.tracks

    # => [#, #, #, ...]

    song.revision.tracks.first.title

    # => "Geezer Butler"

License

----

This library is distributed under the MIT license. Please see the [LICENSE](https://github.com/endel/songsterr-api/blob/master/LICENSE) file.