vkontakte 0.0.1

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+gemspec
+
+gem "activesupport"
+gem "i18n"
+
+gem "rspec", "~> 2.6.0", :require => "spec"
+gem "fakeweb"
+
+# To use debugger (ruby-debug for Ruby 1.8.7+, ruby-debug19 for Ruby 1.9.2+)
+# gem 'ruby-debug'
+# gem 'ruby-debug19'

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 Aimbulance
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,51 @@
+= Vkontakte
+
+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
+
+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
+
+== Install
+  
+  gem 'vkontakte'
+
+== Configure
+
+  Vkontakte.setup do |config|
+    config.app_id = "YOUR Vkontakte API ID"
+    config.app_secret = "YOUR Vkontakte APP SECRET"
+    config.format = :json
+    config.debug = false
+    config.logger = File.open(Rails.root.join('log', 'vkontakte.log'), "a")
+  end
+  
+== Usage
+
+=== Secure API
+
+  @app = Vkontakte::App::Secure.new
+  @app.secure.getAppBalance         # {"response"=>2000}
+  @app.auth                         # {"expires_in"=>0, "access_token"=>"d173f5...319f"}
+
+=== IFrame application
+
+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
+      render :action => "failure"
+    end
+  end
+
+== Test
+
+  rake spec
+
+Copyright (c) 2011 Aimbulance, released under the MIT license

data/Rakefile

@@ -0,0 +1,25 @@
+# encoding: UTF-8
+require 'rubygems'
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rake'
+require 'rdoc/task'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ShareChecker'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/vkontakte.rb

@@ -0,0 +1,29 @@
+require 'active_support/core_ext/module/attribute_accessors'
+require 'active_support/core_ext/object'
+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'
+  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'
+  end
+  
+  mattr_accessor :config
+  @@config = Config.new
+  
+  def self.setup(&block)
+    yield config
+  end
+end

data/lib/vkontakte/api/base.rb

@@ -0,0 +1,13 @@
+module Vkontakte
+  module Api
+    class Base
+      attr_accessor :app
+      
+      delegate :call, :to => :app
+      
+      def initialize(base)
+        @app = base
+      end
+    end
+  end
+end

data/lib/vkontakte/api/friends.rb

@@ -0,0 +1,42 @@
+module Vkontakte
+  module Api
+    module Friends
+    
+      def self.included(base)
+        base.class_eval do
+          define_method :friends do
+            @friends ||= Standart.new(self)
+          end
+        end
+      end
+           
+      class Standart < Api::Base
+        # Возвращает список идентификаторов друзей пользователя или 
+        # расширенную информацию о друзьях пользователя (при использовании параметра fields). 
+        # http://vkontakte.ru/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)
+        end
+      end
+    end
+  end
+end

data/lib/vkontakte/api/groups.rb

@@ -0,0 +1,41 @@
+module Vkontakte
+  module Api
+    module Groups
+    
+      def self.included(base)
+        base.class_eval do
+          define_method :groups do
+            @groups ||= Standart.new(self)
+          end
+        end
+      end
+           
+      class Standart < Api::Base
+        # Возвращает список групп указанного пользователя.
+        # http://vkontakte.ru/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
+      end
+    end
+  end
+end

data/lib/vkontakte/api/photos.rb

@@ -0,0 +1,218 @@
+module Vkontakte
+  module Api
+    module Photos
+    
+      def self.included(base)
+        base.class_eval do
+          define_method :photos do
+            @photos ||= Standart.new(self)
+          end
+        end
+      end
+      
+      module Extended
+        def self.included(base)
+          base.define_method :photos do
+            @photos ||= Extend.new(self)
+          end
+        end
+      end
+      
+      class Standart < Api::Base
+      
+        # возвращает список альбомов пользователя.
+        #
+        def getAlbums(options={})
+          call('photos.getAlbums', options)
+        end
+        
+        # возвращает количество альбомов пользователя.
+        #
+        def getAlbumsCount(options={})
+          call('photos.getAlbumsCount', options)
+        end
+        
+        # возвращает список фотографий в альбоме.
+        #
+        def get(options={})
+          call('photos.get', options)
+        end
+        
+        # возвращает все фотографии пользователя в антихронологическом порядке.
+        #
+        def getAll(options={})
+          call('photos.getAll', options)
+        end
+        
+        # возвращает информацию о фотографиях.
+        #
+        def getById(options={})
+          call('photos.getById', options)
+        end
+        
+        # создает пустой альбом для фотографий.
+        #
+        def createAlbum(options={})
+          call('photos.createAlbum', options)
+        end
+        
+        # обновляет данные альбома для фотографий.
+        #
+        def editAlbum(options={})
+          call('photos.editAlbum', options)
+        end
+        
+        # переносит фотографию из одного альбома в другой.
+        #
+        def move(options={})
+          call('photos.move', options)
+        end
+        
+        # делает фотографию обложкой альбома.
+        #
+        def makeCover(options={})
+          call('photos.makeCover', options)
+        end
+        
+        # меняет порядок альбома в списке альбомов пользователя.
+        #
+        def reorderAlbums(options={})
+          call('photos.reorderAlbums', options)
+        end
+        
+        # меняет порядок фотографий в списке фотографий альбома.
+        #
+        def reorderPhotos(options={})
+          call('photos.reorderPhotos', options)
+        end
+        
+        # возвращает адрес сервера для загрузки фотографий.
+        #
+        def getUploadServer(options={})
+          call('photos.getUploadServer', options)
+        end
+        
+        # сохраняет фотографии после успешной загрузки.
+        #
+        def save(options={})
+          call('photos.save', options)
+        end
+        
+        # возвращает адрес сервера для загрузки фотографии на страницу пользователя.
+        #
+        def getProfileUploadServer(options={})
+          call('photos.getProfileUploadServer', options)
+        end
+        
+        # сохраняет фотографию страницы пользователя после успешной загрузки.
+        #
+        def saveProfilePhoto(options={})
+          call('photos.saveProfilePhoto', options)
+        end
+        
+        # возвращает адрес сервера для загрузки фотографии в специальный альбом, предназначенный для фотографий со стены.
+        #
+        def getWallUploadServer(options={})
+          call('photos.getWallUploadServer', options)
+        end
+        
+        # сохраняет фотографию после успешной загрузки.
+        #
+        def saveWallPhoto(options={})
+          call('photos.saveWallPhoto', options)
+        end
+      end
+      
+      
+      
+      
+      class Extend < Standart    
+        # возвращает список комментариев к фотографии.
+        #
+        def getComments(options={})
+          call('photos.getComments', options)
+        end
+        
+        # возвращает список комментариев к альбому или ко всем альбомам.
+        #
+        def getAllComments(options={})
+          call('photos.getAllComments', options)
+        end
+        
+        # создает новый комментарий к фотографии.
+        #
+        def createComment(options={})
+          call('photos.createComment', options)
+        end
+        
+        # изменяет текст комментария к фотографии.
+        #
+        def editComment(options={})
+          call('photos.editComment', options)
+        end
+        
+        # удаляет комментарий к фотографии.
+        #
+        def deleteComment(options={})
+          call('photos.deleteComment', options)
+        end
+        
+        # восстанавливает комментарий к фотографии.
+        #
+        def restoreComment(options={})
+          call('photos.restoreComment', options)
+        end
+        
+        # возвращает список фотографий, на которых отмечен пользователь.
+        #
+        def getUserPhotos(options={})
+          call('photos.getUserPhotos', options)
+        end
+        
+        # возвращает список отметок на фотографии.
+        #
+        def getTags(options={})
+          call('photos.getTags', options)
+        end
+        
+        # добавляет отметку на фотографию.
+        #
+        def putTag(options={})
+          call('photos.putTag', options)
+        end
+        
+        # удаляет отметку с фотографии.
+        #
+        def removeTag(options={})
+          call('photos.removeTag', options)
+        end
+        
+        # удаляет фотоальбом пользователя.
+        #
+        def deleteAlbumnew(options={})
+          call('photos.deleteAlbumnew', options)
+        end
+        
+        # возвращает адрес сервера для загрузки фотографии в качестве прикрепления к личному сообщению.
+        #
+        def getMessagesUploadServer(options={})
+          call('photos.getMessagesUploadServer', options)
+        end
+        
+        # сохраняет фотографию после загрузки.
+        #
+        def saveMessagesPhoto(options={})
+          call('photos.saveMessagesPhoto', options)
+        end
+        
+        # удаляет фотографию.
+        #
+        def delete(options={})
+          call('photos.delete', options)
+        end
+      end
+      
+      
+    end
+  end
+end

data/lib/vkontakte/api/secure.rb

@@ -0,0 +1,77 @@
+module Vkontakte
+  module Api
+    module Secure
+    
+      def self.included(base)
+        base.class_eval do
+          define_method :secure do
+            @secure ||= Standart.new(self)
+          end
+        end
+      end
+           
+      class Standart < Api::Base
+        
+        def default_options
+          { 
+            :timestamp => Time.now.utc.to_i, 
+            :random => Kernel.rand(10000),
+            :client_secret => Vkontakte.config.app_secret 
+          }
+        end
+        
+        # Отправляет уведомление пользователю.
+        # http://vkontakte.ru/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 = {})
+          options = default_options.merge(options)
+          call("secure.setCounter", options)
+        end
+      end
+    end
+  end
+end

data/lib/vkontakte/app/base.rb

@@ -0,0 +1,112 @@
+require 'httparty'
+
+module Vkontakte
+  module App
+    class Base
+      include ::HTTParty
+      
+      base_uri "https://api.vkontakte.ru"
+      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_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
+      # Site auth:
+      # https://api.vkontakte.ru/oauth/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'
+      #
+      # Response:
+      #   {"access_token":"533bacf01e11f55b536a565b57531ac114461ae8736d6506a3", "expires_in":43200, "user_id":6492}
+      #
+      def authorize(code = nil, options = {})
+        options = { 
+          :client_id => @config[:app_id], 
+          :client_secret => @config[:app_secret],
+          :code => code
+        }.merge(options)
+        
+        # Server auth
+        if options[:code].blank?
+          options.delete(:code)
+          options[:grant_type] = 'client_credentials'
+        end
+        
+        @auth = get("/oauth/access_token", options)
+      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
+      #   METHOD_NAME – название метода из списка функций API,
+      #   PARAMETERS – параметры соответствующего метода API,
+      #   ACCESS_TOKEN – ключ доступа, полученный в результате успешной авторизации приложения. 
+      # Example:
+      # https://api.vkontakte.ru/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
+      #
+      def call(method_name, params = {})
+        params[:access_token] ||= @auth['access_token'] if authorized?
+        
+        unless params[:access_token].blank?
+          get("/method/#{method_name}", params)
+        else
+          raise VkException.new(method_name, {
+            :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)
+          
+          if response['error']
+            raise VkException.new(method_name, response)
+          else
+            return response
+          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"}]}}
+    #
+    class VkException < Exception
+      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
+  end
+end

data/lib/vkontakte/app/iframe.rb

@@ -0,0 +1,71 @@
+module Vkontakte
+  module App
+    # IFrame приложения
+    # More info at http://vkontakte.ru/developers.php?id=-1_27971896&s=1
+    #
+    class Iframe < Base
+      include Api::Photos
+      include Api::Friends
+      include Api::Groups
+      
+      attr_accessor :params
+      
+      # Основные параметры запуска приложения
+      # При отображении приложения посредством flashVars или строки запроса (для IFrame приложений) 
+      # в него передаются следующие параметры: api_url, api_id, user_id, sid, secret, group_id ...
+      # http://vkontakte.ru/developers.php?id=-1_27971896&s=1
+      #
+      def params=(value)
+        @params = value.symbolize_keys
+        
+        if @params[:access_token] && auth.nil?
+          self.auth = { 'access_token' => @params[:access_token] }
+        end
+        
+        @params
+      end
+      
+      # Этот параметр приходит, если в приложении включена система платежей (во вкладке Платежи при редактировании приложения).
+      # auth_key вычисляется на сервере ВКонтакте следующим образом:
+      #   auth_key = md5(api_id + '_' + viewer_id + '_' + api_secret)
+      #
+      def valid_auth_key?
+        !params[:auth_key].blank? && params[:auth_key] == auth_key
+      end
+      
+      # Переменная language может принимать следующие значения:
+      #
+      #  0 – русский язык.
+      #  1 – украинский язык.
+      #  2 – белорусский язык.
+      #  3 – английский язык.
+      #
+      def language
+        return :ru if params[:language].blank?
+        case params[:language].to_s
+          when '0' then :ru
+          when '1' then :uk
+          when '2' then :be
+          when '3' then :en
+        end
+      end
+      
+      # результат выполнения API-запроса, формирующийся при просмотре приложения. 
+      # Параметры этого запроса можно ввести в разделе редактирования приложения. 
+      # Например, для получения информации об указанных пользователях, можно использовать следующий запрос: 
+      #   method=getProfiles&uids={user_id},{viewer_id},1,6492&format=json&v=2.0
+      #
+      def api_result
+        @api_result ||= MultiJson.decode(params[:api_result])
+      end
+      
+      protected
+      
+        # это ключ, необходимый для авторизации пользователя на стороннем сервере
+        #
+        def auth_key
+          Utils.md5( [@config[:app_id], params[:viewer_id], @config[:app_secret]].join('_') )
+        end
+    end
+  end
+end

data/lib/vkontakte/app/secure.rb

@@ -0,0 +1,15 @@
+module Vkontakte
+  module App
+    # Данный метод доступен только с серверной стороны.
+    # More info at http://vkontakte.ru/developers.php?id=-1_27971896&s=1
+    #
+    class Secure < Base
+      include Api::Secure
+      
+      def initialize(app_id = nil, app_secret = nil)
+        super
+        authorize
+      end
+    end
+  end
+end

data/lib/vkontakte/config.rb

@@ -0,0 +1,38 @@
+module Vkontakte
+  class Config < Hash
+    # Creates an accessor that simply sets and reads a key in the hash:
+    #
+    # class Config < Hash
+    #   hash_accessor :routes, :secret_key, :service_number, :project_name
+    # end
+    #
+    # config = Config.new
+    # config.routes = '/posts/message'
+    # config[:routes] #=> '/posts/message'
+    #
+    def self.hash_accessor(*names) #:nodoc:
+      names.each do |name|
+        class_eval <<-METHOD, __FILE__, __LINE__ + 1
+          def #{name}
+            self[:#{name}]
+          end
+
+          def #{name}=(value)
+            self[:#{name}] = value
+          end
+        METHOD
+      end
+    end
+    
+    hash_accessor :app_id, :app_secret, :debug, :logger, :format
+    
+    def initialize(other={})
+      merge!(other)
+      self[:app_id] ||= "Vkontakte API ID"
+      self[:app_secret] ||= "Vkontakte APP SECRET"
+      self[:format] ||= :json
+      self[:debug] ||= false
+      self[:logger] ||= nil
+    end
+  end
+end

data/lib/vkontakte/utils.rb

@@ -0,0 +1,24 @@
+require 'digest/md5'
+
+module Vkontakte
+  module Utils
+    extend self
+    
+    def generate_cookie_sign(data, app_secret)
+      md5(collect_params(data) + app_secret)
+    end
+
+    def generate_api_sign(cookies, data)
+      cookies['secret'] ||= Vkontakte.config.app_secret
+      md5(cookies['mid'], collect_params(data), cookies['secret'])
+    end
+    
+    def collect_params(data)
+      data.sort{|a, b| a.first.to_s <=> b.first.to_s}.collect{|key, value| "#{key}=#{value}"}.join
+    end
+    
+    def md5(*args)
+      Digest::MD5.hexdigest(args.join)
+    end
+  end
+end

data/lib/vkontakte/version.rb

@@ -0,0 +1,3 @@
+module Vkontakte
+  VERSION = "0.0.1".freeze
+end

data/spec/api/friends_spec.rb

@@ -0,0 +1,56 @@
+require "spec_helper"
+
+describe Vkontakte::Api::Friends do
+  it "should be valid" do
+    Vkontakte::Api::Friends.should be_a(Module)
+  end
+  
+  context "iframe" do
+    before(:each) do
+      @token = '3a3d250e705051b03ed479343c3ec2833783eea3eea29860182716ed1d40319'
+      @iframe = Vkontakte::App::Iframe.new
+      @iframe.auth = {'access_token' => @token}
+    end
+    
+    it "should get friends list by uid param" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/friends.get?access_token=#{@token}&uid=81202312", 
+        :body => '{"response":[2592709,3859793,4663468]}')
+      
+      @iframe.friends.get(:uid => 81202312).should == {"response"=>[2592709, 3859793, 4663468]}
+    end
+    
+    it "should get friends list by fields" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/friends.get?access_token=#{@token}&fields=81202312", 
+        :body => '{"response":[{"uid":2592709,"first_name":"Павел","last_name":"Галета","online":0},{"uid":3859793,"first_name":"Мария","last_name":"Семёнова","online":0},{"uid":4663468,"first_name":"Ekaterina","last_name":"Koronotova","online":0}]}')
+      
+      @iframe.friends.get(:fields => 81202312).should == {"response"=>[{"uid"=>2592709, "last_name"=>"\320\223\320\260\320\273\320\265\321\202\320\260", "online"=>0, "first_name"=>"\320\237\320\260\320\262\320\265\320\273"}, {"uid"=>3859793, "last_name"=>"\320\241\320\265\320\274\321\221\320\275\320\276\320\262\320\260", "online"=>0, "first_name"=>"\320\234\320\260\321\200\320\270\321\217"}, {"uid"=>4663468, "last_name"=>"Koronotova", "online"=>0, "first_name"=>"Ekaterina"}]}
+    end
+    
+    it "should get getAppUsers" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/friends.getAppUsers?access_token=#{@token}", 
+        :body => '{"response":[2592709]}')
+      
+      @iframe.friends.getAppUsers.should == {"response" => [2592709]}
+    end
+    
+    it "should get getOnline" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/friends.getOnline?access_token=#{@token}&uid=2592709", 
+        :body => '{"response":[2450999,2488708,2649518,4440077]}')
+      
+      @iframe.friends.getOnline(:uid => 2592709).should == {"response"=>[2450999, 2488708, 2649518, 4440077]}
+    end
+    
+    it "should get getMutual" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/friends.getMutual?target_uid=2450999&access_token=#{@token}&source_uid=2592709", 
+        :body => '{"response":[2301578,2619312,5818827,6391852,6411298,6422462]}')
+      
+      response = @iframe.friends.getMutual(:target_uid => 2450999, :source_uid => 2592709)
+      response.should == {"response" => [2301578,2619312,5818827,6391852,6411298,6422462]}
+    end
+  end
+end

data/spec/api/groups_spec.rb

@@ -0,0 +1,64 @@
+require "spec_helper"
+
+describe Vkontakte::Api::Groups do
+  it "should be valid" do
+    Vkontakte::Api::Groups.should be_a(Module)
+  end
+  
+  context "iframe" do
+    before(:each) do
+      @token = '3a3d250e705051b03ed479343c3ec2833783eea3eea29860182716ed1d40319'
+      @iframe = Vkontakte::App::Iframe.new
+      @iframe.auth = {'access_token' => @token}
+    end
+    
+    it "should get groups list by uid param" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/groups.get?access_token=#{@token}&uid=81202312", 
+        :body => '{"response":[16527885]}')
+      
+      @iframe.groups.get(:uid => 81202312).should == {"response" => [16527885]}
+    end
+    
+    it "should raise permission error on access friend groups" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/groups.get?access_token=#{@token}&uid=2592709", 
+        :body => '{"error":{"error_code":7,"error_msg":"Permission to perform this action is denied by user","request_params":[{"key":"oauth","value":"1"},{"key":"method","value":"groups.get"},{"key":"uid","value":"2592709"},{"key":"access_token","value":"74aee6063ec4aea07047ba3cb47079607f870797079ea90fef75c6361570a5f"}]}}')
+      
+      lambda {
+        @iframe.groups.get(:uid => 2592709)
+      }.should raise_error Vkontakte::App::VkException
+    end
+    
+    context "exists group" do
+      before(:each) do
+        @group_id = 16527885
+      end
+      
+      it "should return group info" do
+        FakeWeb.register_uri(:get, 
+          "https://api.vkontakte.ru/method/groups.getById?access_token=#{@token}&gid=#{@group_id}", 
+          :body => '{"response":[{"gid":16527885,"name":"Club Music Group of Kiev","screen_name":"club16527885","is_closed":0,"type":"group","photo":"http:\/\/cs884.vkontakte.ru\/g16527885\/c_08b73308.jpg","photo_medium":"http:\/\/cs884.vkontakte.ru\/g16527885\/b_6e68053d.jpg","photo_big":"http:\/\/cs884.vkontakte.ru\/g16527885\/a_ba67625c.jpg"}]}')
+          
+        @iframe.groups.getById(:gid => @group_id).should == {"response"=>[{"photo"=>"http://cs884.vkontakte.ru/g16527885/c_08b73308.jpg", "name"=>"Club Music Group of Kiev", "gid"=>16527885, "is_closed"=>0, "photo_medium"=>"http://cs884.vkontakte.ru/g16527885/b_6e68053d.jpg", "type"=>"group", "photo_big"=>"http://cs884.vkontakte.ru/g16527885/a_ba67625c.jpg", "screen_name"=>"club16527885"}]}
+      end
+      
+      it "should return group member" do
+        FakeWeb.register_uri(:get, 
+          "https://api.vkontakte.ru/method/groups.isMember?access_token=#{@token}&gid=#{@group_id}&uid=81202312", 
+          :body => '{"response":1}')
+        
+        @iframe.groups.isMember(:uid => 81202312, :gid => @group_id).should == {"response" => 1}
+      end
+      
+      it "should return all groups members" do
+        FakeWeb.register_uri(:get, 
+          "https://api.vkontakte.ru/method/groups.getMembers?access_token=#{@token}&gid=#{@group_id}&count=5", 
+          :body => '{"response":{"count":29364,"users":[107765962,66506999,145557591,72256631,28639402]}}')
+        
+        response = @iframe.groups.getMembers(:gid => @group_id, :count => 5)
+        response.should == {"response"=>{"count"=>29364, "users"=>[107765962, 66506999, 145557591, 72256631, 28639402]}}
+      end
+    end
+  end
+end

data/spec/api/photos_spec.rb

@@ -0,0 +1,27 @@
+require "spec_helper"
+
+describe Vkontakte::Api::Photos do
+  it "should be valid" do
+    Vkontakte::Api::Photos.should be_a(Module)
+  end
+  
+  context "params" do
+    before(:each) do
+      @token = '3a3d250e705051b03ed479343c3ec2833783eea3eea29860182716ed1d40319'
+      @iframe = Vkontakte::App::Iframe.new
+      @iframe.auth = {'access_token' => @token}
+    end
+    
+    it "should be call getAlbums method" do
+      response = '{"response":[{"aid":"17071606","thumb_id":"98054577","owner_id":"6492","title":"",
+"description":"","created":"1204576880","updated":"1229532461", "size":"3","privacy":"0"}]}'
+
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/photos.getAlbums?access_token=#{@token}", 
+        :body => response)
+      
+      @iframe.photos.getAlbums.should == {"response" => [{"aid" => "17071606","thumb_id" => "98054577","owner_id" => "6492","title" => "", "description" => "","created" => "1204576880","updated" => "1229532461", "size" => "3","privacy" => "0"}]}
+    end
+    
+  end
+end

data/spec/api/secure_spec.rb

@@ -0,0 +1,88 @@
+require "spec_helper"
+
+describe Vkontakte::Api::Secure do
+  it "should be valid" do
+    Vkontakte::Api::Secure.should be_a(Module)
+  end
+  
+  context "secure" do
+    before(:all) do
+      @token = '3a3d250e705051b03ed479343c3ec2833783eea3eea29860182716ed1d40319'
+      
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/oauth/access_token?grant_type=client_credentials&client_id=#{Vkontakte.config.app_id}&client_secret=#{Vkontakte.config.app_secret}",
+        :body => '{"access_token":"#{@token}"}')
+      
+      @app = Vkontakte::App::Secure.new
+      @options = @app.secure.default_options.merge(:access_token => @token)
+    end
+    
+    it "should call sendNotification" do
+      p = @options.merge(:uids => 81202312, :message => "test")
+      
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/secure.sendNotification?" + HTTParty::HashConversions.to_params(p), 
+        :body => '{"response":"81202312"}')
+      
+      @app.secure.sendNotification(p).should == {"response"=>"81202312"}
+    end
+    
+    it "should call getAppBalance" do
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/secure.getAppBalance?" + HTTParty::HashConversions.to_params(@options), 
+        :body => '{"response":5000}')
+      
+      @app.secure.getAppBalance(@options).should == {"response"=>5000}
+    end
+    
+    it "should call getBalance" do
+      p = @options.merge(:uid => 81202312)
+      
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/secure.getBalance?" + HTTParty::HashConversions.to_params(p), 
+        :body => '{"response":350}')
+      
+      @app.secure.getBalance(p).should == {"response"=>350}
+    end
+    
+    it "should call withdrawVotes" do
+      p = @options.merge(:uid => 81202312, :votes => 2)
+      
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/secure.withdrawVotes?" + HTTParty::HashConversions.to_params(p), 
+        :body => '{"response":2}')
+      
+      @app.secure.withdrawVotes(p).should == {"response"=>2}
+    end
+    
+    it "should call getTransactionsHistory" do
+      p = @options.merge(:uid => 81202312, :type => 0, :limit => 2)
+      
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/secure.getTransactionsHistory?" + HTTParty::HashConversions.to_params(p), 
+        :body => '{"response":[{"id":"65968","uid_from":"34804733","uid_to":"33239732","votes":"1000","date":"1243421339"},{"id":"65956","uid_from":"35003049","uid_to":"33239732","votes":"300","date":"1243421213"}]}')
+      
+      @app.secure.getTransactionsHistory(p).should == {"response"=>[{"votes"=>"1000", "uid_to"=>"33239732", "date"=>"1243421339", "id"=>"65968", "uid_from"=>"34804733"}, {"votes"=>"300", "uid_to"=>"33239732", "date"=>"1243421213", "id"=>"65956", "uid_from"=>"35003049"}]}
+    end
+    
+    it "should call addRating" do
+      p = @options.merge(:uid => 81202312, :rate => 200)
+      
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/secure.addRating?" + HTTParty::HashConversions.to_params(p), 
+        :body => '{"response":{"rating_added":200}}')
+      
+      @app.secure.addRating(p).should == {"response" => {"rating_added" => 200}}
+    end
+    
+    it "should call setCounter" do
+      p = @options.merge(:uid => 81202312, :counter => 4)
+      
+      FakeWeb.register_uri(:get, 
+        "https://api.vkontakte.ru/method/secure.setCounter?" + HTTParty::HashConversions.to_params(p), 
+        :body => '{"response":1}')
+      
+      @app.secure.setCounter(p).should == {"response" => 1}
+    end
+  end
+end

data/spec/apps/base_spec.rb

@@ -0,0 +1,5 @@
+require "spec_helper"
+
+describe Vkontakte::App::Base do
+  
+end

data/spec/apps/iframe_spec.rb

@@ -0,0 +1,32 @@
+require "spec_helper"
+
+describe Vkontakte::App::Iframe do
+  it "should be valid" do
+    Vkontakte::App::Iframe.should be_a(Module)
+  end
+  
+  context "params" do
+    before(:each) do
+      @params = {"referrer"=>"profile", "is_app_user"=>"0", "api_settings"=>"0", "parent_language"=>"0", "hash"=>"", "sid"=>"db5aa091133cb1971817421f3cf14a1b78605ad2ab67218e8066c2bd57e736", "language"=>"0", "group_id"=>"0", "user_id"=>"2592709", "viewer_type"=>"1", "secret"=>"492aeb00af", "lc_name"=>"5941f805", "access_token"=>"3a3d250e705051b03ed479343c3ec2833783eea3eea29860182716ed1d40319", "viewer_id"=>"81202312", "api_url"=>"http://api.vkontakte.ru/api.php"}
+      @params["auth_key"] = Vkontakte::Utils.md5([Vkontakte.config.app_id, @params['viewer_id'], Vkontakte.config.app_secret].join('_'))
+      @params["api_result"] = '{"response":[{"uid":81202312,"first_name":"Tester","last_name":"Tester"}]}'
+      @params["app_id"] = Vkontakte.config.app_id
+      
+      @iframe = Vkontakte::App::Iframe.new
+      @iframe.params = @params
+    end
+    
+    it "should parse request params" do
+      @iframe.language.should == :ru
+      @iframe.auth.should_not be_nil
+      @iframe.auth['access_token'].should == @params["access_token"]
+      @iframe.valid_auth_key?.should be_true
+      @iframe.api_result.should == {"response"=>[{"uid"=>81202312, "last_name"=>"Tester", "first_name"=>"Tester"}]}
+    end
+    
+    it "should not be valid auth_key" do
+      @iframe.params = @params.merge("auth_key" => 'wrong')
+      @iframe.valid_auth_key?.should_not be_true
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,35 @@
+require "rubygems"
+require "bundler/setup"
+
+$:.push File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require "vkontakte"
+require "fakeweb"
+
+# Load support files
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
+
+Vkontakte.setup do |config|
+  config.app_id = 10000
+  config.app_secret = "supersecret"
+  config.format = :json
+  config.debug = false
+  config.logger = nil
+end
+
+RSpec.configure do |config|
+  # Remove this line if you don't want RSpec's should and should_not
+  # methods or matchers
+  require 'rspec/expectations'
+  config.include RSpec::Matchers
+
+  # == Mock Framework
+  config.mock_with :rspec
+  
+  config.before(:suite) do
+    FakeWeb.allow_net_connect = false
+  end
+  
+  config.after(:suite) do
+    FakeWeb.allow_net_connect = true
+  end
+end

data/spec/vkontakte_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Vkontakte do
+  it "should be valid" do
+    Vkontakte.should be_a(Module)
+  end
+  
+  context "setup" do
+    before(:each) do
+      Vkontakte.setup do |config|
+        config.app_id = 1234567
+        config.app_secret = "supersecretkey"
+        config.format = :xml
+        config.debug = false
+        config.logger = nil
+      end
+    end
+    
+    it "should set config options" do
+      Vkontakte.config.app_id.should == 1234567
+      Vkontakte.config.app_secret.should == 'supersecretkey'
+      Vkontakte.config.format.should == :xml
+    end
+    
+    it "should raise error on not exists option" do
+      lambda {
+        Vkontakte.config.some_param
+      }.should raise_error(StandardError)
+    end
+  end
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification 
+name: vkontakte
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Igor Galeta
+- Pavlo Galeta
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-11-11 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: "The easiest way to access Vkontakte API and some other utils. "
+email: galeta.igor@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- lib/vkontakte/app/secure.rb
+- lib/vkontakte/app/iframe.rb
+- lib/vkontakte/app/base.rb
+- lib/vkontakte/utils.rb
+- lib/vkontakte/api/secure.rb
+- lib/vkontakte/api/friends.rb
+- lib/vkontakte/api/groups.rb
+- lib/vkontakte/api/base.rb
+- lib/vkontakte/api/photos.rb
+- lib/vkontakte/config.rb
+- lib/vkontakte/version.rb
+- lib/vkontakte.rb
+- MIT-LICENSE
+- Rakefile
+- Gemfile
+- README.rdoc
+- spec/api/secure_spec.rb
+- spec/api/friends_spec.rb
+- spec/api/photos_spec.rb
+- spec/api/groups_spec.rb
+- spec/vkontakte_spec.rb
+- spec/apps/base_spec.rb
+- spec/apps/iframe_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/galetahub/vkontakte
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Vkontakte API
+test_files: 
+- spec/api/secure_spec.rb
+- spec/api/friends_spec.rb
+- spec/api/photos_spec.rb
+- spec/api/groups_spec.rb
+- spec/vkontakte_spec.rb
+- spec/apps/base_spec.rb
+- spec/apps/iframe_spec.rb
+- spec/spec_helper.rb