siilar 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d972ebb4830794176e2472aa14225629ae5b2c28
-  data.tar.gz: 677fd50447cf59e058e9f1e6abd5c62319febce2
+  metadata.gz: 5ca39c15768d357e7f84fcb1bcccf2e3c4ca806c
+  data.tar.gz: 6ace98f69649c6f64582204454f26b6b055646f1
 SHA512:
-  metadata.gz: 13f6fdf7903adecb9fabdd779e577ffe1189a96985a2ae6735e8e17c30c12d0c0a3b2192986303abfb72c3f5b78d109da3bcf768db65394a4647f9851a2308e3
-  data.tar.gz: f197eded5bf3bb66174ea1053b496e469e0888fd4e9d6ce4f20ad70e4ab19a0a87b866d97359a06e4ff1b74592efbac5497accc40e3a5b956be035d04feea647
+  metadata.gz: 5fd797ad4a8ff0626f7ad4a37fefb71aff08dbd9bab941c41b4f64a473407a21070e9fe0182dcce0d1e0958128d798ba94d025d83af4e370741a4eea7b58ad8a
+  data.tar.gz: f98c8b75e8850c8f6005a8d1c9d5efecc05c7e83d55d4897658caf6459fa44c51133e64d19bbe1e97f68b8d3ec550fa5b161c7df28ae2f98ad40e4a4758301fc

data/README.md

@@ -1,6 +1,6 @@
 # Siilar Ruby Client [![Build Status](https://travis-ci.org/craftsmen/niland-siilar-ruby.svg?branch=better-methods-names)](https://travis-ci.org/craftsmen/niland-siilar-ruby)
 
-A Ruby client for the [Siilar API](http://api.siilar.com/1.0/doc/).
+A Ruby client for the [Siilar API](http://api.niland.io/1.0/doc/).
 
 ## Installation
 
@@ -18,7 +18,7 @@ Or install it yourself as:
 
 ## Usage
 
-This library is a Ruby client you can use to interact with the [Siilar API](http://api.siilar.com/1.0/doc/).
+This library is a Ruby client you can use to interact with the [Siilar API](http://api.niland.io/1.0/doc/).
 
 Here's a short example.
 

data/lib/siilar/client/clients.rb

@@ -1,8 +1,8 @@
 module Siilar
   class Client
 
-    def tracks
-      @services[:tracks] ||= Client::TracksService.new(self)
+    def radios
+      @services[:radios] ||= Client::RadiosService.new(self)
     end
 
     def search
@@ -13,6 +13,14 @@ module Siilar
       @services[:tags] ||= Client::TagsService.new(self)
     end
 
+    def tracks
+      @services[:tracks] ||= Client::TracksService.new(self)
+    end
+
+    def users
+      @services[:users] ||= Client::UsersService.new(self)
+    end
+
     class ClientService < ::Struct.new(:client)
     end
 
@@ -33,5 +41,17 @@ module Siilar
     class TagsService < ClientService
       include Client::Tags
     end
+
+    require 'siilar/client/users'
+
+    class UsersService < ClientService
+      include Client::Users
+    end
+
+    require 'siilar/client/radios'
+
+    class RadiosService < ClientService
+      include Client::Radios
+    end
   end
 end

data/lib/siilar/client/radios.rb

@@ -0,0 +1,82 @@
+module Siilar
+  class Client
+    module Radios
+
+      # Get a list of your radios.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#list-radios
+      def list
+        response = client.get('1.0/radios')
+        response.map { |radio| Struct::Radio.new(radio) }
+      end
+
+      # Get a radio.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#get-a-radio
+      def get(radio)
+        response = client.get("1.0/radios/#{radio}")
+        Struct::Radio.new(response)
+      end
+
+      # Create a radio.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#create-a-radio
+      def create(attributes = {})
+        response = client.post('1.0/radios', attributes)
+        Struct::Radio.new(response)
+      end
+
+      # Edit a radio.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#edit-a-radio
+      def edit(radio, attributes = {})
+        response = client.patch("1.0/radios/#{radio}", attributes)
+        Struct::Radio.new(response)
+      end
+
+      # Get next radio tracks
+      #
+      # @see http://api.niland.io/1.0/doc/radios#get-next-radio-tracks
+      def get_next(radio)
+        response = client.get("1.0/radios/#{radio}/next")
+        response.map { |track| Struct::Track.new(track) }
+      end
+
+      # Notify a skip.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#notify-a-skip
+      def notify_skip(radio, attributes = {})
+        Extra.validate_mandatory_attributes(attributes, [:track])
+        response = client.post("1.0/radios/#{radio}/skips", attributes)
+        Struct::Radio.new(response)
+      end
+
+      # Notify a like.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#notify-a-like
+      def notify_like(radio, attributes = {})
+        Extra.validate_mandatory_attributes(attributes, [:track])
+        response = client.post("1.0/radios/#{radio}/likes", attributes)
+        Struct::Radio.new(response)
+      end
+
+      # Notify a dislike.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#notify-a-dislike
+      def notify_dislike(radio, attributes = {})
+        Extra.validate_mandatory_attributes(attributes, [:track])
+        response = client.post("1.0/radios/#{radio}/dislikes", attributes)
+        Struct::Radio.new(response)
+      end
+
+      # Notify a favorite.
+      #
+      # @see http://api.niland.io/1.0/doc/radios#notify-a-favorite
+      def notify_favorite(radio, attributes = {})
+        Extra.validate_mandatory_attributes(attributes, [:track])
+        response = client.post("1.0/radios/#{radio}/favorites", attributes)
+        Struct::Radio.new(response)
+      end
+    end
+  end
+end

data/lib/siilar/client/search.rb

@@ -4,7 +4,7 @@ module Siilar
 
       # Search for a track
       #
-      # @see http://api.siilar.com/1.0/doc/search-and-analyze#search
+      # @see http://api.niland.io/1.0/doc/search-and-analyze#search
       def similar(query = {})
         options = { query: query }
         response = client.get('1.0/search', options)
@@ -14,7 +14,7 @@ module Siilar
 
       # Search for a track from external ids
       #
-      # @see http://api.siilar.com/1.0/doc/search-and-analyze#search-from-external
+      # @see http://api.niland.io/1.0/doc/search-and-analyze#search-from-external
       def similar_from_external(query = {})
         options = { query: query }
         response = client.get('1.0/search-from-external', options)

data/lib/siilar/client/tags.rb

@@ -4,7 +4,7 @@ module Siilar
       
       # Get all the tag collections
       #
-      # @see http://api.siilar.com/1.0/doc/tags#list-tag-collections
+      # @see http://api.niland.io/1.0/doc/tags#list-tag-collections
       def tag_collections
         response = client.get('1.0/tag-collections')
 
@@ -13,7 +13,7 @@ module Siilar
 
       # Get one tag collection
       #
-      # @see http://api.siilar.com/1.0/doc/tags#get-tag-collections
+      # @see http://api.niland.io/1.0/doc/tags#get-tag-collections
       def tag_collection(collection)
         response = client.get("1.0/tag-collections/#{collection}")
 
@@ -22,7 +22,7 @@ module Siilar
 
       # Create a tag collection
       #
-      # @see http://api.siilar.com/1.0/doc/tags#create-tag-collections
+      # @see http://api.niland.io/1.0/doc/tags#create-tag-collections
       def create_tag_collection(attributes = {})
         Extra.validate_mandatory_attributes(attributes, [:name])
         response = client.post('1.0/tag-collections', attributes)
@@ -32,7 +32,7 @@ module Siilar
 
       # Edit a tag collection
       #
-      # @see http://api.siilar.com/1.0/doc/tags#edit-tag-collections
+      # @see http://api.niland.io/1.0/doc/tags#edit-tag-collections
       def edit_tag_collection(collection, attributes = {})
         response = client.patch("1.0/tag-collections/#{collection}", attributes)
 
@@ -41,14 +41,14 @@ module Siilar
 
       # Delete a tag collection
       #
-      # @see http://api.siilar.com/1.0/doc/tags#delete-tag-collections
+      # @see http://api.niland.io/1.0/doc/tags#delete-tag-collections
       def delete_tag_collection(collection)
         client.delete("1.0/tag-collections/#{collection}")
       end
       
       # Find tags
       #
-      # @see http://api.siilar.com/1.0/doc/tags#find-tags
+      # @see http://api.niland.io/1.0/doc/tags#find-tags
       def find_tags(attributes = {})
         response = client.get('1.0/tags', attributes)
 

data/lib/siilar/client/tracks.rb

@@ -4,7 +4,7 @@ module Siilar
 
       # Gets a track.
       #
-      # @see http://api.siilar.com/1.0/doc/tracks#get-a-track
+      # @see http://api.niland.io/1.0/doc/tracks#get-a-track
       def track(track)
         response = client.get("1.0/tracks/#{track}")
 
@@ -26,12 +26,12 @@ module Siilar
       def from_external(track)
         response = client.get("1.0/from-external/#{track}")
 
-        Struct::Track.new(response)
+        response.map { |r| Struct::Track.new(r) }
       end
 
       # Creates a track.
       #
-      # @see http://api.siilar.com/1.0/doc/tracks#create-a-track
+      # @see http://api.niland.io/1.0/doc/tracks#create-a-track
       def create(attributes = {})
         Extra.validate_mandatory_attributes(attributes, [:title, :external_id])
         response = client.post('1.0/tracks', attributes)
@@ -41,7 +41,7 @@ module Siilar
 
       # Updates a track.
       #
-      # @see http://api.siilar.com/1.0/doc/tracks#edit-a-track
+      # @see http://api.niland.io/1.0/doc/tracks#edit-a-track
       def update(track, attributes = {})
         response = client.patch("1.0/tracks/#{track}", attributes)
 
@@ -50,7 +50,7 @@ module Siilar
 
       # Deletes a track.
       #
-      # @see http://api.siilar.com/1.0/doc/tracks#delete-a-track
+      # @see http://api.niland.io/1.0/doc/tracks#delete-a-track
       def delete(track)
         client.delete("1.0/tracks/#{track}")
       end

data/lib/siilar/client/users.rb

@@ -0,0 +1,88 @@
+module Siilar
+  class Client
+    module Users
+
+      # Get a list of your users.
+      #
+      # @see http://api.niland.io/1.0/doc/users#list-users
+      def list(query = {})
+        response = client.get('1.0/users')
+        response.map { |user| Struct::User.new(user) }
+      end
+
+      # Get a user.
+      #
+      # @see http://api.niland.io/1.0/doc/users#get-a-user
+      def get(user)
+        response = client.get("1.0/users/#{user}")
+        Struct::User.new(response)
+      end
+
+      # Create a user.
+      #
+      # @see http://api.niland.io/1.0/doc/users#create-a-user
+      def create(attributes = {})
+        Extra.validate_mandatory_attributes(attributes, [:external_id])
+        response = client.post('1.0/users', attributes)
+        Struct::User.new(response)
+      end
+
+      # Update a user.
+      #
+      # @see http://api.niland.io/1.0/doc/users#update-a-user
+      def update(user, attributes = {})
+        response = client.patch("1.0/users/#{user}", attributes)
+        Struct::User.new(response)
+      end
+
+      # Delete a user.
+      #
+      # @see http://api.niland.io/1.0/doc/users#delete-a-user
+      def delete(user)
+        client.delete("1.0/users/#{user}")
+      end
+
+      # Get next user tracks
+      #
+      # @see http://api.niland.io/1.0/doc/users#get-next-user-tracks
+      def get_next(user)
+        response = client.get("1.0/users/#{user}/next")
+        response.map { |user| Struct::User.new(response) }
+      end
+
+      # Get liked tracks.
+      #
+      # @see https://api.niland.io/doc/users#get-liked-tracks
+      def get_liked_tracks(user)
+        response = client.get("1.0/users/#{user}/likes")
+        response.map { |track| Struct::Track.new(track) }
+      end
+
+      # Add liked tracks.
+      #
+      # @see https://api.niland.io/doc/users#add-liked-track
+      def add_liked_track(user, attributes = {})
+        Extra.validate_mandatory_attributes(attributes, [:track])
+        response = client.post("1.0/users/#{user}/likes", attributes)
+        Struct::Track.new(response)
+      end
+
+      # Get disliked tracks.
+      #
+      # @see https://api.niland.io/doc/users#get-disliked-tracks
+      def get_disliked_tracks(user)
+        response = client.get("1.0/users/#{user}/dislikes")
+        response.map { |track| Struct::Track.new(track) }
+      end
+
+      # Add disliked tracks.
+      #
+      # @see https://api.niland.io/doc/users#add-disliked-track
+      def add_disliked_track(user, attributes = {})
+        Extra.validate_mandatory_attributes(attributes, [:track])
+        response = client.post("1.0/users/#{user}/dislikes", attributes)
+        Struct::Track.new(response)
+      end
+    end
+  end
+end

data/lib/siilar/default.rb

@@ -1,6 +1,6 @@
 module Siilar
   module Default
-    API_ENDPOINT = "http://api.siilar.com/".freeze
+    API_ENDPOINT = "https://api.niland.io/".freeze
     USER_AGENT = "niland-siilar-ruby/#{VERSION}".freeze
 
     class << self

data/lib/siilar/struct/radio.rb

@@ -0,0 +1,47 @@
+module Siilar
+  module Struct
+
+    class Radio < Base
+      attr_accessor :id
+      def current_tracks 
+        @current_tracks ||= []
+      end
+      
+      def current_tracks=(attrs)
+        if attrs
+          @current_tracks = attrs.map { |track| Struct::Track.new(track) }
+        end
+      end
+
+      def seeds
+        @seeds ||= []
+      end
+
+      def seeds=(attrs)
+        if attrs
+          @seeds = attrs.map { |seed| Struct::Track.new(seed) }
+        end
+      end
+      
+      def tags 
+        @tags ||= []
+      end
+
+      def tags=(attrs)
+        if attrs
+          @tags = attrs.map { |tag| Struct::Tag.new(tag) }
+        end
+      end
+
+      def user
+        @tags ||= {}
+      end
+
+      def user=(attrs)
+        if attrs
+          @user = Struct::User.new(attrs)
+        end
+      end
+    end
+  end
+end

data/lib/siilar/struct/track.rb

@@ -2,7 +2,7 @@ module Siilar
   module Struct
 
     class Track < Base
-      attr_accessor :id, :hash, :title, :popularity, :duration, :external_id, :isrc, :waveform_url
+      attr_accessor :id, :hash, :title, :popularity, :duration, :external_id, :isrc, :year
 
       def album
         @album ||= {}

data/lib/siilar/struct/user.rb

@@ -0,0 +1,8 @@
+module Siilar
+  module Struct
+
+    class User < Base
+      attr_accessor :external_id, :birthdate, :gender, :country, :city
+    end
+  end
+end

data/lib/siilar/struct.rb

@@ -12,9 +12,11 @@ module Siilar
   end
 end
 
-require 'siilar/struct/track'
-require 'siilar/struct/external_track'
 require 'siilar/struct/album'
 require 'siilar/struct/artist'
+require 'siilar/struct/external_track'
+require 'siilar/struct/radio'
 require 'siilar/struct/tag'
 require 'siilar/struct/tag_collection'
+require 'siilar/struct/track'
+require 'siilar/struct/user'

data/lib/siilar/version.rb

@@ -1,3 +1,3 @@
 module Siilar
-  VERSION = '1.3.0'
+  VERSION = '1.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: siilar
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Mehdi Lahmam
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-12-07 00:00:00.000000000 Z
+date: 2016-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -85,9 +85,11 @@ files:
 - lib/siilar.rb
 - lib/siilar/client.rb
 - lib/siilar/client/clients.rb
+- lib/siilar/client/radios.rb
 - lib/siilar/client/search.rb
 - lib/siilar/client/tags.rb
 - lib/siilar/client/tracks.rb
+- lib/siilar/client/users.rb
 - lib/siilar/default.rb
 - lib/siilar/error.rb
 - lib/siilar/extra.rb
@@ -95,9 +97,11 @@ files:
 - lib/siilar/struct/album.rb
 - lib/siilar/struct/artist.rb
 - lib/siilar/struct/external_track.rb
+- lib/siilar/struct/radio.rb
 - lib/siilar/struct/tag.rb
 - lib/siilar/struct/tag_collection.rb
 - lib/siilar/struct/track.rb
+- lib/siilar/struct/user.rb
 - lib/siilar/version.rb
 - siilar.gemspec
 homepage: https://github.com/craftsmen/niland-siilar-ruby