1
0
Fork 0
musicbrainz.org Ruby client
Go to file
Gregory Eremin 20a2391c0b Version bump to 0.3.0 2011-09-13 14:52:44 +04:00
lib Models moved into module, safe loading, v0.2.0 2011-09-13 14:06:52 +04:00
test Models moved into module, safe loading, v0.2.0 2011-09-13 14:06:52 +04:00
.document Initial commit to musicbrainz. 2011-07-18 03:46:18 +04:00
.gitignore Initial commit to musicbrainz. 2011-07-18 03:46:18 +04:00
Gemfile Releasing 2011-07-18 07:02:37 +04:00
Gemfile.lock Releasing 2011-07-18 07:02:37 +04:00
LICENSE.txt Initial commit to musicbrainz. 2011-07-18 03:46:18 +04:00
README.rdoc Releasing 2011-07-18 07:02:37 +04:00
Rakefile Releasing 2011-07-18 07:02:37 +04:00
VERSION Version bump to 0.3.0 2011-09-13 14:52:44 +04:00
musicbrainz.gemspec Models moved into module, safe loading, v0.2.0 2011-09-13 14:06:52 +04:00

README.rdoc

= MusicBrainz Web Service wrapper

=== Installation

    gem install musicbrainz

=== Usage

    require 'musicbrainz'
    
    @kasabian = MusicBrainzArtist.find('69b39eab-6577-46a4-a9f5-817839092033')
    
    @empire_tracks = @kasabian.release_groups[8].releases.first.tracks

=== Future

It should work all like ActiveRecord models.

=== Api

MusicBrainzArtist

    MusicBrainzArtist.find(mbid)
    MusicBrainzArtist.id
    MusicBrainzArtist.type
    MusicBrainzArtist.name
    MusicBrainzArtist.country
    MusicBrainzArtist.date_begin
    MusicBrainzArtist.date_end
    MusicBrainzArtist.release_groups

MusicBrainzReleaseGroup

    MusicBrainzReleaseGroup.find(mbid)
    MusicBrainzReleaseGroup.id
    MusicBrainzReleaseGroup.type
    MusicBrainzReleaseGroup.title
    MusicBrainzReleaseGroup.first_release_date
    MusicBrainzReleaseGroup.releases

MusicBrainzRelease

    MusicBrainzRelease.find(mbid)
    MusicBrainzRelease.id
    MusicBrainzRelease.title
    MusicBrainzRelease.status
    MusicBrainzRelease.date
    MusicBrainzRelease.country
    MusicBrainzRelease.tracks

MusicBrainzTrack

    MusicBrainzTrack.find(mbid)
    MusicBrainzTrack.position
    MusicBrainzTrack.recording_id
    MusicBrainzTrack.title
    MusicBrainzTrack.length


=== Contributing
 
* 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.

=== Copyright

Copyright (c) 2011 Gregory Eremin. See LICENSE.txt for further details.