vkontakte 0.0.2 → 0.0.3

data/Gemfile

@@ -8,6 +8,9 @@ gem "i18n"
 gem "rspec", "~> 2.6.0", :require => "spec"
 gem "fakeweb"
 
+gem "rake"
+gem "rdoc"
+
 # To use debugger (ruby-debug for Ruby 1.8.7+, ruby-debug19 for Ruby 1.9.2+)
 # gem 'ruby-debug'
 # gem 'ruby-debug19'

data/README.rdoc

@@ -1,16 +1,16 @@
 = Vkontakte
 
-The easiest way to access Vkontakte API and some other utils. 
+The easiest way to access Vkontakte API and some other utils.
 More info about API:
 
-1. http://vkontakte.ru/developers.php?oid=-1&p=%D0%90%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F
+1. http://vk.com/developers.php?oid=-1&p=%D0%90%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F
 
-2. http://vkontakte.ru/developers.php?oid=-1&p=%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2_%D0%BA_API
+2. http://vk.com/developers.php?oid=-1&p=%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2_%D0%BA_API
 
 3. http://vk.com/developers.php?oid=-1&p=%D0%9F%D1%80%D0%B0%D0%B2%D0%B0_%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%B0_%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9
 
 == Install
-  
+
   gem 'vkontakte'
 
 == Configure
@@ -22,7 +22,7 @@ More info about API:
     config.debug = false
     config.logger = File.open(Rails.root.join('log', 'vkontakte.log'), "a")
   end
-  
+
 == Usage
 
 === User API by access_token
@@ -31,27 +31,29 @@ More info about API:
   user.fetch # {"response"=>[{"uid"=>2592709, ...
 
 Profile
-  
-  user.profile.isAppUser()      # {"response"=>"1"}
-  user.profile.getUserBalance()
-  user.profile.getUserSettings()
+
+  user.profile.isAppUser      # {"response"=>"1"}
+  user.profile.getUserBalance
+  user.profile.getUserSettings
   user.profile.likesGetList(:type => 'post')
 
 Photos
 
-  user.photos.getAlbums()
-  user.photos.getAlbumsCount()
+  user.photos.getAlbums
+  user.photos.getAlbumsCount
   user.photos.get(:aid => 'album_id')
 
 Groups
 
-  user.groups.get()
+  user.groups.get
   user.groups.isMember(:gid => 'group_id')
+  user.groups.join(:gid => 1)
+  user.groups.leave(:gid => 1)
 
 Friends
-  
-  user.friends.get()
-  user.friends.getOnline()
+
+  user.friends.get
+  user.friends.getOnline
 
 === Secure API
 
@@ -66,7 +68,7 @@ Check if auth_key is valid:
   def index
     @app = Vkontakte::App::Iframe.new
     @app.params = params
-    
+
     if @app.valid_auth_key?
       session[:viewer_id] = params[:viewer_id]
     else

data/lib/vkontakte.rb

@@ -5,26 +5,27 @@ require 'active_support/core_ext/string'
 module Vkontakte
   autoload :Config, 'vkontakte/config'
   autoload :Utils, 'vkontakte/utils'
-  
+
   module App
     autoload :Base, 'vkontakte/app/base'
     autoload :Iframe, 'vkontakte/app/iframe'
     autoload :Secure, 'vkontakte/app/secure'
     autoload :User, 'vkontakte/app/user'
   end
-  
+
   module Api
     autoload :Base, 'vkontakte/api/base'
-    autoload :Photos, 'vkontakte/api/photos'
     autoload :Friends, 'vkontakte/api/friends'
     autoload :Groups, 'vkontakte/api/groups'
-    autoload :Secure, 'vkontakte/api/secure'
+    autoload :Likes, 'vkontakte/api/likes'
+    autoload :Photos, 'vkontakte/api/photos'
     autoload :Profile, 'vkontakte/api/profile'
+    autoload :Secure, 'vkontakte/api/secure'
   end
-  
+
   mattr_accessor :config
   @@config = Config.new
-  
+
   def self.setup(&block)
     yield config
   end

data/lib/vkontakte/api/base.rb

@@ -2,20 +2,20 @@ module Vkontakte
   module Api
     class Base
       attr_accessor :app, :default_params
-      
+
       delegate :call, :to => :app
-      
+
       def initialize(base)
         @app = base
       end
-      
+
       def default_params
         @default_params ||= {}
       end
-      
+
       def call(method_name, params = {})
         params = default_params.merge(params)
-        @app.call(method_name, params)
+        @app.call(method_name, params)['response']
       end
     end
   end

data/lib/vkontakte/api/friends.rb

@@ -1,7 +1,7 @@
 module Vkontakte
   module Api
     module Friends
-    
+
       def self.included(base)
         base.class_eval do
           define_method :friends do
@@ -9,29 +9,29 @@ module Vkontakte
           end
         end
       end
-           
+
       class Standart < Api::Base
-        # Возвращает список идентификаторов друзей пользователя или 
-        # расширенную информацию о друзьях пользователя (при использовании параметра fields). 
-        # http://vkontakte.ru/developers.php?oid=-1&p=friends.get
+        # Возвращает список идентификаторов друзей пользователя или
+        # расширенную информацию о друзьях пользователя (при использовании параметра fields).
+        # http://vk.com/developers.php?oid=-1&p=friends.get
         #
         def get(options = {})
           call('friends.get', options)
         end
-        
-        # Возвращает список идентификаторов друзей текущего пользователя, которые установили данное приложение. 
+
+        # Возвращает список идентификаторов друзей текущего пользователя, которые установили данное приложение.
         #
         def getAppUsers(options = {})
           call('friends.getAppUsers', options)
         end
-        
-        # Возвращает список идентификаторов, находящихся на сайте друзей, текущего пользователя. 
+
+        # Возвращает список идентификаторов, находящихся на сайте друзей, текущего пользователя.
         #
         def getOnline(options = {})
           call('friends.getOnline', options)
         end
-        
-        # Возвращает список идентификаторов общих друзей между парой пользователей. 
+
+        # Возвращает список идентификаторов общих друзей между парой пользователей.
         #
         def getMutual(options = {})
           call('friends.getMutual', options)

data/lib/vkontakte/api/groups.rb

@@ -1,7 +1,7 @@
 module Vkontakte
   module Api
     module Groups
-    
+
       def self.included(base)
         base.class_eval do
           define_method :groups do
@@ -9,32 +9,46 @@ module Vkontakte
           end
         end
       end
-           
+
       class Standart < Api::Base
         # Возвращает список групп указанного пользователя.
-        # http://vkontakte.ru/developers.php?oid=-1&p=groups.get
+        # http://vk.com/developers.php?oid=-1&p=groups.get
         #
         def get(options = {})
           call('groups.get', options)
         end
-        
-        # Возвращает информацию о заданной группе или о нескольких группах. 
+
+        # Возвращает информацию о заданной группе или о нескольких группах.
         #
         def getById(options = {})
           call('groups.getById', options)
         end
-        
-        # Возвращает информацию о том является ли пользователь участником заданной группы. 
+
+        # Возвращает информацию о том является ли пользователь участником заданной группы.
         #
         def isMember(options = {})
           call('groups.isMember', options)
         end
-        
-        # Возвращает список участников группы. 
+
+        # Возвращает список участников группы.
         #
         def getMembers(options = {})
           call('groups.getMembers', options)
         end
+
+        # Добавляет как участника группы
+        # http://vk.com/developers.php?o=-1&p=groups.join
+        #
+        def join(options = {})
+          call('groups.join', options)
+        end
+
+        # Добавляет как участника группы
+        # http://vk.com/developers.php?o=-1&p=groups.leave
+        #
+        def leave(options = {})
+          call('groups.leave', options)
+        end
       end
     end
   end

data/lib/vkontakte/api/likes.rb

@@ -0,0 +1,28 @@
+module Vkontakte
+  module Api
+    module Likes
+
+      def self.included(base)
+        base.class_eval do
+          define_method :likes do
+            @likes ||= Standart.new(self)
+          end
+        end
+      end
+
+      class Standart < Api::Base
+        # http://vk.com/developers.php?oid=-1&p=likes.getList
+        #
+        def getList(options = {})
+          call('likes.getList', options)
+        end
+
+        # http://vk.com/developers.php?o=-1&p=likes.isLiked
+        #
+        def isLiked(options = {})
+          call('likes.isLiked', options)
+        end
+      end
+    end
+  end
+end

data/lib/vkontakte/api/secure.rb

@@ -1,7 +1,7 @@
 module Vkontakte
   module Api
     module Secure
-    
+
       def self.included(base)
         base.class_eval do
           define_method :secure do
@@ -9,62 +9,62 @@ module Vkontakte
           end
         end
       end
-           
+
       class Standart < Api::Base
-        
+
         def default_options
-          { 
-            :timestamp => Time.now.utc.to_i, 
+          {
+            :timestamp => Time.now.utc.to_i,
             :random => Kernel.rand(10000),
-            :client_secret => Vkontakte.config.app_secret 
+            :client_secret => Vkontakte.config.app_secret
           }
         end
-        
+
         # Отправляет уведомление пользователю.
-        # http://vkontakte.ru/developers.php?oid=-1&p=secure.sendNotification
+        # http://vk.com/developers.php?oid=-1&p=secure.sendNotification
         #
         def sendNotification(options = {})
           options = default_options.merge(options)
           call('secure.sendNotification', options)
         end
-        
-        # Возвращает платежный баланс (счет) приложения в сотых долях голоса. 
+
+        # Возвращает платежный баланс (счет) приложения в сотых долях голоса.
         #
         def getAppBalance(options = {})
           options = default_options.merge(options)
           call("secure.getAppBalance", options)
         end
-        
-        # Возвращает баланс пользователя на счету приложения в сотых долях голоса. 
+
+        # Возвращает баланс пользователя на счету приложения в сотых долях голоса.
         #
         def getBalance(options = {})
           options = default_options.merge(options)
           call("secure.getBalance", options)
         end
-        
+
         # Списывает голоса со счета пользователя на счет приложения (в сотых долях).
         #
         def withdrawVotes(options = {})
           options = default_options.merge(options)
           call("secure.withdrawVotes", options)
         end
-        
-        # Выводит историю транзакций по переводу голосов между пользователями и приложением. 
+
+        # Выводит историю транзакций по переводу голосов между пользователями и приложением.
         #
         def getTransactionsHistory(options = {})
           options = default_options.merge(options)
           call("secure.getTransactionsHistory", options)
         end
-        
-        # Поднимает пользователю рейтинг от имени приложения. 
+
+        # Поднимает пользователю рейтинг от имени приложения.
         #
         def addRating(options = {})
           options = default_options.merge(options)
           call("secure.addRating", options)
         end
-        
-        # Устанавливает счетчик, который выводится пользователю жирным шрифтом в левом меню. 
-        # Это происходит только в том случае, если пользователь добавил приложение в левое меню со страницы приложения, 
+
+        # Устанавливает счетчик, который выводится пользователю жирным шрифтом в левом меню.
+        # Это происходит только в том случае, если пользователь добавил приложение в левое меню со страницы приложения,
         # списка приложений или настроек.
         #
         def setCounter(options = {})

data/lib/vkontakte/app/base.rb

@@ -4,84 +4,83 @@ module Vkontakte
   module App
     class Base
       include ::HTTParty
-      
-      base_uri "https://api.vkontakte.ru"
+
+      base_uri "https://api.vk.com"
       format Vkontakte.config.format
       debug_output Vkontakte.config.logger
-      
+
       attr_accessor :auth
-      
+
       def initialize(app_id = nil, app_secret = nil)
         @config = {
-          :app_id => (app_id || Vkontakte.config.app_id), 
+          :app_id => (app_id || Vkontakte.config.app_id),
           :app_secret => (app_secret || Vkontakte.config.app_secret)
         }
       end
-      
-      # http://vkontakte.ru/developers.php?oid=-1&p=%D0%90%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F
+
+      # http://vk.com/developers.php?oid=-1&p=%D0%90%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F
       # Site auth:
-      # https://api.vkontakte.ru/oauth/access_token?
+      # https://oauth.vk.com/access_token?
       #   client_id=APP_ID&
       #   client_secret=APP_SECRET&
       #   code=7a6fa4dff77a228eeda56603b8f53806c883f011c40b72630bb50df056f6479e52a
       #
       # Server auth:
-      # https://api.vkontakte.ru/oauth/access_token?
-      #   client_id=' + APP_ID + '&client_secret=' + APP_SECRET + '&grant_type=client_credentials'
+      # https://oauth.vk.com/access_token?client_id=' + APP_ID + '&client_secret=' + APP_SECRET + '&grant_type=client_credentials'
       #
       # Response:
       #   {"access_token":"533bacf01e11f55b536a565b57531ac114461ae8736d6506a3", "expires_in":43200, "user_id":6492}
       #
-      def authorize(code = nil, options = {})
-        options = { 
-          :client_id => @config[:app_id], 
+      def authorize(code = nil, params = {})
+        params = {
+          :client_id => @config[:app_id],
           :client_secret => @config[:app_secret],
           :code => code
-        }.merge(options)
-        
+        }.merge(params)
+
         # Server auth
-        if options[:code].blank?
-          options.delete(:code)
-          options[:grant_type] = 'client_credentials'
+        if params[:code].blank?
+          params.delete(:code)
+          params[:grant_type] = 'client_credentials'
         end
-        
-        @auth = get("/oauth/access_token", options)
+
+        @auth = get("/access_token", {:query => params, :base_uri => "https://oauth.vk.com"})
       end
-      
+
       # Check if app is authorized
       #
       def authorized?
         auth && auth['access_token']
       end
-      
-      # Выполнение запросов к API 
-      # https://api.vkontakte.ru/method/METHOD_NAME?PARAMETERS&access_token=ACCESS_TOKEN
+
+      # Выполнение запросов к API
+      # https://api.vk.com/method/METHOD_NAME?PARAMETERS&access_token=ACCESS_TOKEN
       #   METHOD_NAME – название метода из списка функций API,
       #   PARAMETERS – параметры соответствующего метода API,
-      #   ACCESS_TOKEN – ключ доступа, полученный в результате успешной авторизации приложения. 
+      #   ACCESS_TOKEN – ключ доступа, полученный в результате успешной авторизации приложения.
       # Example:
-      # https://api.vkontakte.ru/method/getProfiles?uid=66748&access_token=533bacf01e11f55b536a565b57531ac114461ae8736d6506a3
+      # https://api.vk.com/method/getProfiles?uid=66748&access_token=533bacf01e11f55b536a565b57531ac114461ae8736d6506a3
       #
-      # More info: http://vkontakte.ru/developers.php?oid=-1&p=%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2_%D0%BA_API
+      # More info: http://vk.com/developers.php?oid=-1&p=%D0%92%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2_%D0%BA_API
       #
       def call(method_name, params = {})
         params[:access_token] ||= @auth['access_token'] if authorized?
-        
+
         unless params[:access_token].blank?
-          get("/method/#{method_name}", params)
+          get("/method/#{method_name}", {:query => params, :base_uri => "https://api.vk.com"})
         else
           raise VkException.new(method_name, {
-            :error => 'access_token is blank', 
+            :error => 'access_token is blank',
             :error_description => 'You need first authorize app before call API methods.'
           })
         end
       end
-      
+
       protected
-      
+
         def get(method_name, options = {})
-          response = self.class.get(method_name, :query => options)
-          
+          response = self.class.get(method_name, options)
+
           if response['error']
             raise VkException.new(method_name, response)
           else
@@ -89,7 +88,7 @@ module Vkontakte
           end
         end
     end
-    
+
     # Errors
     # {"error":"invalid_grant","error_description":"Code is expired."}
     # {"error":{"error_code":5,"error_msg":"User authorization failed: invalid application type","request_params":[{"key":"oauth","value":"1"},{"key":"method","value":"getProfiles"},{"key":"uid","value":"66748"},{"key":"access_token","value":"533bacf01e11f55b536a565b57531ac114461ae8736d6506a3"}]}}
@@ -98,13 +97,13 @@ module Vkontakte
       def initialize(method_name, options)
         error_hash = options.symbolize_keys
         @message = "Error in #{method_name}: "
-        
+
         if error_hash[:error].is_a?(Hash)
           @message += error_hash[:error].inspect
         else
           @message += [error_hash[:error], error_hash[:error_description]].join('-')
         end
-        
+
         super @message
       end
     end