vk_api 0.1.0

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in vk_api.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,18 @@
+= Vkontakte Api
+
+== Описание
+
+Библиотека VkApi имеет один значимый класс - <tt>VK:Session</tt>. После создания экземпляра сессии
+вы можете вызывать методы ВКонтакте как будто это методы сессии, например:
+  session = ::VkApi::Session.new app_id, api_secret
+  session.friends.get :uid => 12
+Такой вызов вернёт вам массив хэшей в виде:
+  => [{'uid' => '123'}, {:uid => '321'}]
+
+== Установка
+  gem install vk_api
+
+== Лицензия
+
+Copyright (c) 2011 Nikolay Karev
+MIT License (http://www.opensource.org/licenses/mit-license.php)

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/vk_api.rb

@@ -0,0 +1,4 @@
+# encoding: utf-8
+module VkApi
+  autoload :Session, 'vk_api/session'
+end

data/lib/vk_api/session.rb

@@ -0,0 +1,103 @@
+# encoding: utf-8
+# VK - это небольшая библиотечка на Ruby, позволяющая прозрачно обращаться к API ВКонтакте
+# из Ruby.
+#
+# Author:: Nikolay Karev
+# Copyright:: Copyright (c) 2011- Nikolay Karev
+# License:: MIT License (http://www.opensource.org/licenses/mit-license.php)
+#
+# Библиотека VkApi имеет один класс - +::VK:Session+. После создания экземпляра сессии
+# вы можете вызывать методы ВКонтакте как будто это методы сессии, например:
+#   session = ::VkApi::Session.new app_id, api_secret
+#   session.friends.get :uid => 12
+# Такой вызов вернёт вам массив хэшей в виде:
+#   # => [{'uid' => '123'}, {:uid => '321'}]
+
+require 'net/http'
+require 'uri'
+require 'digest/md5'
+require 'json'
+
+module VkApi
+  # Единственный класс библиотеки, работает как "соединение" с сервером ВКонтакте.
+  # Постоянное соединение с сервером не устанавливается, поэтому необходимости в явном
+  # отключении от сервера нет.
+  # Экземпляр +Session+ может обрабатывать все методы, поддерживаемые API ВКонтакте
+  # путём делегирования запросов.
+  class Session
+    VK_API_URL = 'http://api.vk.com/api.php'
+    VK_OBJECTS = %w(friends photos wall audio video places secure language notes pages offers 
+      questions messages newsfeed status polls subscriptions)
+    attr_accessor :app_id, :api_secret
+
+    # Конструктор. Получает следующие аргументы:
+    # * app_id: ID приложения ВКонтакте.
+    # * api_secret: Ключ приложения со страницы настроек
+    def initialize app_id, api_secret, method_prefix = nil
+      @app_id, @api_secret, @prefix = app_id, api_secret, method_prefix
+    end
+
+
+    # Выполняет вызов API ВКонтакте
+    # * method: Имя метода ВКонтакте, например friends.get
+    # * params: Хэш с именованными аргументами метода ВКонтакте
+    # Возвращаемое значение: хэш с результатами вызова.
+    # Генерируемые исключения: +ServerError+ если сервер ВКонтакте вернул ошибку.
+    def call(method, params = {})
+      params[:method] = @prefix ? "#{@prefix}.#{method}" : method
+      params[:api_id] = app_id
+      params[:format] = 'json'
+      params[:sig] = sig(params.tap do |s|
+        # stringify keys
+        s.keys.each {|k| s[k.to_s] = s.delete k  }
+      end)
+      response = JSON.parse(Net::HTTP.post_form(URI.parse(VK_API_URL), params).body)      
+      raise ServerError.new self, method, params, response['error'] if response['error']
+      response['response']
+    end
+    
+    # Генерирует подпись запроса
+    # * params: параметры запроса
+    def sig(params)
+      Digest::MD5::hexdigest(
+      params.keys.sort.map{|key| "#{key}=#{params[key]}"}.join + 
+      api_secret) 
+    end
+
+    # Генерирует методы, необходимые для делегирования методов ВКонтакте, так friends, 
+    # images
+    def self.add_method method
+      ::VkApi::Session.class_eval do 
+        define_method method do 
+          if (! var = instance_variable_get("@#{method}"))
+            instance_variable_set("@#{method}", var = ::VkApi::Session.new(app_id, api_secret, method))
+          end
+          var
+        end
+      end
+    end
+
+    for method in VK_OBJECTS
+      add_method method
+    end
+    
+    # Перехват неизвестных методов для делегирования серверу ВКонтакте
+    def method_missing(name, *args)
+      call name, *args
+    end
+
+  end
+  
+  # Базовый класс ошибок
+  class Error < ::StandardError; end
+  
+  # Ошибка на серверной стороне
+  class ServerError < Error
+    attr_accessor :session, :method, :params, :error
+    def initialize(session, method, params, error)
+      super "Server side error calling VK method: #{error}"
+      @session, @method, @params, @error = session, method, params, error
+    end
+  end
+  
+end

data/lib/vk_api/version.rb

@@ -0,0 +1,4 @@
+# encoding: utf-8
+module VkApi
+  VERSION = "0.1.0"
+end

data/vk_api.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "vk_api/version"
+
+Gem::Specification.new do |s|
+  s.name        = "vk_api"
+  s.version     = VkApi::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Nikolay Karev", "Nick Recobra"]
+  s.email       = ["oruenu@gmail.com"]
+  s.homepage    = "https://github.com/oruen/vk_api"
+  s.summary     = %q{Гем для общения с Open API сайта ВКонтакте}
+  s.description = %q{Гем для общения с Open API сайта ВКонтакте без использования пользовательских сессий.}
+
+  s.rubyforge_project = "vk_api"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: vk_api
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Nikolay Karev
+- Nick Recobra
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-04 00:00:00 +03:00
+default_executable: 
+dependencies: []
+
+description: "\xD0\x93\xD0\xB5\xD0\xBC \xD0\xB4\xD0\xBB\xD1\x8F \xD0\xBE\xD0\xB1\xD1\x89\xD0\xB5\xD0\xBD\xD0\xB8\xD1\x8F \xD1\x81 Open API \xD1\x81\xD0\xB0\xD0\xB9\xD1\x82\xD0\xB0 \xD0\x92\xD0\x9A\xD0\xBE\xD0\xBD\xD1\x82\xD0\xB0\xD0\xBA\xD1\x82\xD0\xB5 \xD0\xB1\xD0\xB5\xD0\xB7 \xD0\xB8\xD1\x81\xD0\xBF\xD0\xBE\xD0\xBB\xD1\x8C\xD0\xB7\xD0\xBE\xD0\xB2\xD0\xB0\xD0\xBD\xD0\xB8\xD1\x8F \xD0\xBF\xD0\xBE\xD0\xBB\xD1\x8C\xD0\xB7\xD0\xBE\xD0\xB2\xD0\xB0\xD1\x82\xD0\xB5\xD0\xBB\xD1\x8C\xD1\x81\xD0\xBA\xD0\xB8\xD1\x85 \xD1\x81\xD0\xB5\xD1\x81\xD1\x81\xD0\xB8\xD0\xB9."
+email: 
+- oruenu@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/vk_api.rb
+- lib/vk_api/session.rb
+- lib/vk_api/version.rb
+- vk_api.gemspec
+has_rdoc: true
+homepage: https://github.com/oruen/vk_api
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: vk_api
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: "\xD0\x93\xD0\xB5\xD0\xBC \xD0\xB4\xD0\xBB\xD1\x8F \xD0\xBE\xD0\xB1\xD1\x89\xD0\xB5\xD0\xBD\xD0\xB8\xD1\x8F \xD1\x81 Open API \xD1\x81\xD0\xB0\xD0\xB9\xD1\x82\xD0\xB0 \xD0\x92\xD0\x9A\xD0\xBE\xD0\xBD\xD1\x82\xD0\xB0\xD0\xBA\xD1\x82\xD0\xB5"
+test_files: []
+