vkontakte_api 1.0.rc → 1.0.rc2

data/.travis.yml

@@ -2,4 +2,4 @@ rvm:
   - 1.8.7
   - 1.9.2
   - 1.9.3
-  - ruby-head
+  # - ruby-head

data/README.md

@@ -6,13 +6,13 @@
 
 ``` ruby
 # Gemfile
-gem 'vkontakte_api', '~> 1.0.rc'
+gem 'vkontakte_api', '~> 1.0.rc2'
 ```
 
 или просто
 
 ``` sh
-$ gem install vkontakte_api
+$ gem install vkontakte_api --pre
 ```
 
 ## Использование
@@ -42,7 +42,6 @@ users = @vk.users.get(uids: [1, 2, 3])
 users.first.uid        # => 1
 users.first.first_name # => "Павел"
 users.first.last_name  # => "Дуров"
-users.first.online?    # => true
 
 # если метод, возвращающий массив, вызывается с блоком,
 # то блок будет выполнен для каждого элемента,
@@ -91,10 +90,17 @@ redirect_to VkontakteApi.authorization_url(scope: [:friends, :photos])
 @vk.is_app_user?
 ```
 
-Также в этот момент полезно сохранить полученный токен в БД либо в сессии, чтобы использовать его повторно:
+Клиент будет содержать id пользователя, авторизовавшего приложение; его можно получить с помощью метода `VkontakteApi::Client#user_id`:
+
+``` ruby
+@vk.user_id # => 123456
+```
+
+Также в этот момент полезно сохранить полученный токен (и, при необходимости, id пользователя) в БД либо в сессии, чтобы использовать их повторно:
 
 ``` ruby
 current_user.token = @vk.token
+current_user.vk_id = @vk.user_id
 current_user.save
 # позже
 @vk = VkontakteApi::Client.new(current_user.token)
@@ -187,4 +193,4 @@ $ rails generate vkontakte_api:install
 
 Если вы хотите поучаствовать в разработке проекта, форкните репозиторий, положите свои изменения в отдельную ветку и отправьте мне pull request.
 
-`vkontakte_api` тестируется под MRI `1.8.7`, `1.9.2`, `1.9.3` и `2.0.0-dev`. Если в одной из этих сред что-то работает неправильно, либо вообще не работает, то это следует считать багом, и написать об этом в [issues на Github](https://github.com/7even/vkontakte_api/issues).
+`vkontakte_api` тестируется под MRI `1.8.7`, `1.9.2` и `1.9.3`. Если в одной из этих сред что-то работает неправильно, либо вообще не работает, то это следует считать багом, и написать об этом в [issues на Github](https://github.com/7even/vkontakte_api/issues).

data/lib/vkontakte_api/client.rb

@@ -4,14 +4,21 @@ module VkontakteApi
     include Resolver
     
     # An access token needed by authorized requests.
+    # @return [String]
     attr_reader :token
+    # Current user id.
+    # @return [Integer]
+    attr_reader :user_id
     
     # A new API client.
+    # If given an `OAuth2::AccessToken` instance, it extracts and keeps
+    # the token string and the user id; otherwise it just stores the given token.
     # @param [String, OAuth2::AccessToken] token An access token.
     def initialize(token = nil)
-      if token.respond_to?(:token)
+      if token.respond_to?(:token) && token.respond_to?(:params)
         # token is an OAuth2::AccessToken
-        @token = token.token
+        @token   = token.token
+        @user_id = token.params['user_id']
       else
         # token is a String or nil
         @token = token

data/lib/vkontakte_api/version.rb

@@ -1,4 +1,4 @@
 module VkontakteApi
   # Library version.
-  VERSION = '1.0.rc'
+  VERSION = '1.0.rc2'
 end

data/spec/vkontakte_api/client_spec.rb

@@ -2,8 +2,9 @@ require 'spec_helper'
 
 describe VkontakteApi::Client do
   before(:each) do
+    @user_id      = stub("User id")
     @string_token = stub("Access token as a String")
-    @oauth2_token = stub("Access token as an OAuth2::AccessToken", :token => @string_token)
+    @oauth2_token = stub("Access token as an OAuth2::AccessToken", :token => @string_token, :params => {'user_id' => @user_id})
   end
   
   describe "#initialize" do
@@ -26,6 +27,7 @@ describe VkontakteApi::Client do
         it "extracts the string token and uses it" do
           client = VkontakteApi::Client.new(@oauth2_token)
           client.token.should == @string_token
+          client.user_id.should == @user_id
         end
       end
     end

data/vkontakte_api.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |s|
   s.authors     = ['Vsevolod Romashov']
   s.email       = ['7@7vn.ru']
   s.homepage    = 'http://7even.github.com/vkontakte_api'
-  s.summary     = %q{Ruby-way wrapper for VKontakte API}
-  s.description = %q{A transparent wrapper for API of vk.com social network called VKontakte. Supports ruby-way method naming (without any method lists inside), result typecasting and any faraday-supported http adapter of your choice (no hardcoded Net::HTTP).}
+  s.summary     = %q{Ruby wrapper for VKontakte API}
+  s.description = %q{A transparent wrapper for VKontakte API. Supports ruby-way naming of API methods (without method lists inside), optional authorization, files uploading, logging and any faraday-supported http adapter of your choice.}
   
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vkontakte_api
 version: !ruby/object:Gem::Version
-  version: 1.0.rc
+  version: 1.0.rc2
   prerelease: 4
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-08 00:00:00.000000000 Z
+date: 2012-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -155,9 +155,9 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: A transparent wrapper for API of vk.com social network called VKontakte.
-  Supports ruby-way method naming (without any method lists inside), result typecasting
-  and any faraday-supported http adapter of your choice (no hardcoded Net::HTTP).
+description: A transparent wrapper for VKontakte API. Supports ruby-way naming of
+  API methods (without method lists inside), optional authorization, files uploading,
+  logging and any faraday-supported http adapter of your choice.
 email:
 - 7@7vn.ru
 executables: []
@@ -232,7 +232,7 @@ rubyforge_project:
 rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: Ruby-way wrapper for VKontakte API
+summary: Ruby wrapper for VKontakte API
 test_files:
 - spec/integration_spec.rb
 - spec/spec_helper.rb