yandex-api-fotki 0.1.9 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c7fa951b52c92886ef597d9618a778a833311ad1
-  data.tar.gz: 653fa71a2011ba83b3f8c45830cd67fbca4da880
+  metadata.gz: 474d696beaa797f90dbb3f88ecc3fce68a4f5d0b
+  data.tar.gz: 0ab018f05997e946e525dcc0065755c7cb4a5b23
 SHA512:
-  metadata.gz: 96b378e80c898c09d2ce4ff8207124315dabb80d6b9554df531bdd7d3ecf160d96e3ca6e373298f93b1be986e166f24af24ece3b8b3435b071d35fe382971a1d
-  data.tar.gz: c3324548a71805ead2b1289b3c1889083e42ad347f692d9040274cfa7e4317c0bc1afc0b88f21ec3c7e3f89f968224df235ea40a2ab76d56d013e44540fc4f8e
+  metadata.gz: d2452e808240219bbf1c224c51d5264d4d96a87b3e45b68d75c813f930908a607126783f01c099e0e9ab1ce3ac3dd27d5db9d8d1aac0d7fca2616a040632c835
+  data.tar.gz: 85fde0ede6a15ab7a29f02668112db60e8702c6419189a571904ad77b549bb5c4b50a0d7846e9c91aec5200ddb14e29a6e2655fd576b54afb1f86a3bd9dfca1d

data/README.md

@@ -1,7 +1,7 @@
 # Yandex::Api::Fotki
 
 [![Gem Version](https://badge.fury.io/rb/yandex-api-fotki.svg)](https://rubygems.org/gems/yandex-api-fotki)
-[![Build Status](https://travis-ci.org/1v/yandex-api-fotki.svg?branch=master)](https://travis-ci.org/1v/yandex-api-fotki)
+[![Build Status](https://travis-ci.org/1v/yandex-api-fotki.svg?branch=0.1)](https://travis-ci.org/1v/yandex-api-fotki)
 [![Dependency Status](https://gemnasium.com/badges/github.com/1v/yandex-api-fotki.svg)](https://gemnasium.com/github.com/1v/yandex-api-fotki)
 [![Code Climate](https://codeclimate.com/github/1v/yandex-api-fotki/badges/gpa.svg)](https://codeclimate.com/github/1v/yandex-api-fotki)
 [![Test Coverage](https://codeclimate.com/github/1v/yandex-api-fotki/badges/coverage.svg)](https://codeclimate.com/github/1v/yandex-api-fotki/coverage)
@@ -17,7 +17,12 @@ API wrapper for Yandex Fotki
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'yandex-api-fotki'
+# for ruby >= 2.2.2
+gem 'yandex-api-fotki', '~> 1.0', '>= 1.0.0'
+```
+```ruby
+# for ruby < 2.2.2
+gem 'yandex-api-fotki', '~> 0.1', '>= 0.1.8'
 ```
 
 And then execute:
@@ -25,8 +30,14 @@ And then execute:
     $ bundle
 
 Or install it yourself as:
-
-    $ gem install yandex-api-fotki
+```bash
+# for ruby >= 2.2.2
+$ gem install yandex-api-fotki -v '~> 1.0'
+```
+```bash
+# for ruby < 2.2.2
+$ gem install yandex-api-fotki -v '~> 0.1'
+```
     
 And require:
 ```ruby
@@ -37,10 +48,10 @@ require 'yandex-api-fotki'
 Instruction how to get OAUTH_CODE [`tech.yandex.ru`](https://tech.yandex.ru/oauth/doc/dg/tasks/get-oauth-token-docpage/)
 ```ruby
 fotki = Yandex::API::Fotki.oauth(OAUTH_CODE)
-photo = fotki.photos.upload(:image => File.new('/file.png'),
-                            :access => 'private',
-                            :album => 123456,
-                            :title => "My Image")
+photo = fotki.photos.upload(image:  File.new('/file.png'),
+                            access: 'private',
+                            album:  123456,
+                            title:  'My Image')
 photo.id
 => 123456
 photo.links

data/lib/yandex/api/fotki.rb

@@ -1,11 +1,17 @@
 require 'rest-client'
 require 'active_support/core_ext/hash/conversions'
 
-require 'yandex/api/fotki/version'
+require_relative 'fotki/version'
+require_relative 'fotki/me'
+require_relative 'fotki/albums'
+require_relative 'fotki/album'
+require_relative 'fotki/photos'
+require_relative 'fotki/photo'
 
 module Yandex
   module API
     module Fotki
+      API_HOST = 'http://api-fotki.yandex.ru'
       class RuntimeError < RuntimeError ; end
       #
       # Main method for authentification
@@ -16,9 +22,9 @@ module Yandex
       # @see https://tech.yandex.ru/oauth/doc/dg/reference/web-client-docpage/
       #
       def self.oauth(oauth_code)
-        return self unless @api_urls.nil?
+        return self if !@api_urls.nil? && @oauth_code === oauth_code
         @oauth_code = oauth_code
-        me = RestClient.get('http://api-fotki.yandex.ru/api/me/',
+        me = RestClient.get("#{API_HOST}/api/me/",
                              Fotki.oauth_hash)
         @api_urls = Me.new(me)
         self
@@ -66,126 +72,6 @@ module Yandex
         Photos
       end
       #
-      # Class Me is wrapper for user service document
-      #
-      # @see https://tech.yandex.ru/fotki/doc/operations-ref/service-document-get-docpage/
-      #
-      class Me
-        attr_reader :album, :photo, :tag
-        #
-        # Parse response from Fotki.oauth
-        #
-        # @param [RestClient::Response] response
-        #
-        def initialize(response)
-          # Nokogiri::XML(me).xpath("/app:service/app:workspace/app:collection[@id='album-list']/@href").text
-          collention = Fotki.xml_to_hash(response)['service']['workspace']['collection'].map{ |i| { i['id'] => i['href'] }}.inject(:merge)
-          @album = collention['album-list']
-          @photo = collention['photo-list']
-          @tag = collention['tag-list']
-        end
-      end
-      #
-      # Class Albums is wrapper for albums listing
-      #
-      class Albums
-        #
-        # List user albums
-        #
-        # @param [Hash] options
-        # @option options [String] sort updated or rupdated or published or rpublished
-        # @option options [Integer] offset Not implemented
-        # @option options [Integer] limit 100 is max
-        #
-        # @return [Hash] Hash of Fotki::Album were keys is id of album
-        # @see https://tech.yandex.ru/fotki/doc/operations-ref/albums-collection-get-docpage/
-        #
-        def self.list(options = {})
-          options[:sort] ||= 'updated'
-          options[:offset] ||= 0
-          options[:limit] ||= 10
-
-          return @list_cache if !@list_cache.nil? && options === @list_options_cache
-
-          @list_options_cache = options
-
-          list = RestClient.get("#{Fotki.api_urls.album}#{options[:sort]}/?limit=#{options[:limit]}", Fotki.oauth_hash)
-
-          @list_cache = Fotki.xml_to_hash(list)['feed']['entry']
-          @list_cache = @list_cache.map { |i|
-            album = Album.new(i)
-            { album.id => album }
-          }.inject(:merge)
-        end
-      end
-      #
-      # Class Album is wrapper for single album
-      #
-      class Album
-        attr_reader :id, :title, :link
-        #
-        # <description>
-        #
-        # @param [Hash] hash Hash from {Fotki::Albums.list} response
-        #
-        def initialize(hash)
-          @id = parse_id(hash['id'])
-          @title = hash['title']
-          @link = hash['link'].map{ |i| { i['rel'] => i['href'] } }.inject(:merge)
-        end
-
-        private
-          def parse_id(string)
-            string.split(':').last.to_i
-          end
-      end
-
-      #
-      # Class Photos provides photos collections
-      #
-      class Photos
-        #
-        # Uploading photo
-        #
-        # @param [Hash] hash
-        #
-        # == Required
-        # @option hash [File] :image IO stream of file. For example +File.new('tmp/file.png')+ or +open('\h\ttp://site.com/image.png')+
-        # == Optional
-        # @option hash [String] :title Title of image
-        # @option hash [String] :summary Description of image
-        # @option hash [Integer] :album Id of album to upload
-        # @option hash [String] :access public, friends or private
-        # @see https://tech.yandex.ru/fotki/doc/concepts/add-photo-docpage/#multipart-format
-        #
-        # @return [Fotki::Photo] Instance of Photo class
-        #
-        def self.upload(hash)
-          raise Fotki::RuntimeError, ':image is required' unless hash[:image]
-          response = RestClient.post(Fotki.api_urls.photo, hash, Fotki.oauth_hash)
-          Photo.new(response)
-        end
-      end
-      #
-      # Class Photo is wrapper for single photo
-      #
-      # @see https://tech.yandex.ru/fotki/doc/operations-ref/photo-get-docpage/
-      #
-      class Photo
-        attr_reader :id, :links
-        #
-        # Photo initialize
-        #
-        # @param [RestClient::Response] response
-        #
-        def initialize(response)
-          entry = Fotki.xml_to_hash(response)['entry']
-          @id = entry['id'].split(':').last.to_i
-          @links = entry['img'].map{ |i| { i['size'] => i } }.inject(:merge)
-          # puts JSON.pretty_generate(entry)
-        end
-      end
-      #
       # XML parser wrapper. Because I'm not sure if it be persistent.
       #
       # @param [String] xml XML input

data/lib/yandex/api/fotki/album.rb

@@ -0,0 +1,24 @@
+module Yandex
+  module API
+    module Fotki
+      class Album
+        attr_reader :id, :title, :link
+        #
+        # <description>
+        #
+        # @param [Hash] options Hash from {Fotki::Albums.list} response
+        #
+        def initialize(options)
+          @id = parse_id(options['id'])
+          @title = options['title']
+          @link = options['link'].map{ |i| { i['rel'] => i['href'] } }.inject(:merge)
+        end
+
+        private
+          def parse_id(string)
+            string.split(':').last.to_i
+          end
+      end
+    end
+  end
+end

data/lib/yandex/api/fotki/albums.rb

@@ -0,0 +1,36 @@
+module Yandex
+  module API
+    module Fotki
+      class Albums
+        #
+        # List user albums
+        #
+        # @param [Hash] options
+        # @option options [String] sort updated or rupdated or published or rpublished
+        # @option options [Integer] offset Not implemented
+        # @option options [Integer] limit 100 is max
+        #
+        # @return [Hash] Hash of Fotki::Album were keys is id of album
+        # @see https://tech.yandex.ru/fotki/doc/operations-ref/albums-collection-get-docpage/
+        #
+        def self.list(options = {})
+          options[:sort] ||= 'updated'
+          options[:offset] ||= 0
+          options[:limit] ||= 10
+
+          return @list_cache if !@list_cache.nil? && options === @list_options_cache
+
+          @list_options_cache = options
+
+          list = RestClient.get("#{Fotki.api_urls.album}#{options[:sort]}/?limit=#{options[:limit]}", Fotki.oauth_hash)
+
+          @list_cache = Fotki.xml_to_hash(list)['feed']['entry']
+          @list_cache = @list_cache.map { |i|
+            album = Album.new(i)
+            { album.id => album }
+          }.inject(:merge)
+        end
+      end
+    end
+  end
+end

data/lib/yandex/api/fotki/me.rb

@@ -0,0 +1,26 @@
+module Yandex
+  module API
+    module Fotki
+      #
+      # Class Me is wrapper for user service document
+      #
+      # @see https://tech.yandex.ru/fotki/doc/operations-ref/service-document-get-docpage/
+      #
+      class Me
+        attr_reader :album, :photo, :tag
+        #
+        # Parse response from Fotki.oauth
+        #
+        # @param [RestClient::Response] response
+        #
+        def initialize(response)
+          # Nokogiri::XML(me).xpath("/app:service/app:workspace/app:collection[@id='album-list']/@href").text
+          collention = Fotki.xml_to_hash(response)['service']['workspace']['collection'].map{ |i| { i['id'] => i['href'] }}.inject(:merge)
+          @album = collention['album-list']
+          @photo = collention['photo-list']
+          @tag = collention['tag-list']
+        end
+      end
+    end
+  end
+end

data/lib/yandex/api/fotki/photo.rb

@@ -0,0 +1,25 @@
+module Yandex
+  module API
+    module Fotki
+      #
+      # Class Photo is wrapper for single photo
+      #
+      # @see https://tech.yandex.ru/fotki/doc/operations-ref/photo-get-docpage/
+      #
+      class Photo
+        attr_reader :id, :links
+        #
+        # Photo initialize
+        #
+        # @param [RestClient::Response] response
+        #
+        def initialize(response)
+          entry = Fotki.xml_to_hash(response)['entry']
+          @id = entry['id'].split(':').last.to_i
+          @links = entry['img'].map{ |i| { i['size'] => i } }.inject(:merge)
+          # puts JSON.pretty_generate(entry)
+        end
+      end
+    end
+  end
+end

data/lib/yandex/api/fotki/photos.rb

@@ -0,0 +1,48 @@
+module Yandex
+  module API
+    module Fotki
+      class Photos
+        #
+        # Uploading photo
+        #
+        # @param [Hash] options
+        #
+        # == Required
+        # @option options [File] :image IO stream of file. For example +File.new('tmp/file.png')+ or +open('\h\ttp://site.com/image.png')+
+        # == Optional
+        # @option options [String] :title Title of image
+        # @option options [String] :summary Description of image
+        # @option options [Integer] :album Id of album to upload
+        # @option options [String] :access public, friends or private
+        # @see https://tech.yandex.ru/fotki/doc/concepts/add-photo-docpage/#multipart-format
+        #
+        # @return [Fotki::Photo] Instance of Photo class
+        #
+        def self.upload(options)
+          raise Fotki::RuntimeError, ':image is required' unless options[:image]
+          response = RestClient.post(Fotki.api_urls.photo, options, Fotki.oauth_hash)
+          Photo.new(response)
+        end
+        #
+        # Get info about photo
+        #
+        # @param [Hash] options
+        #
+        # == Required
+        # @option options [String] :user Owner of photo
+        # @option options [String] :id Photo id
+        #
+        # @return [Fotki::Photo] Instance of Photo class
+        #
+        def self.get(options)
+          raise Fotki::RuntimeError, ':user is required' unless options[:user]
+          raise Fotki::RuntimeError, ':id is required' unless options[:id]
+          url = "#{API_HOST}/api/users/#{options[:user]}/photo/#{options[:id].to_s}/"
+          headers = options.except(:user, :id).merge(Fotki.oauth_hash)
+          response = RestClient.get(url, headers)
+          Photo.new(response)
+        end
+      end
+    end
+  end
+end

data/lib/yandex/api/fotki/version.rb

@@ -1,7 +1,7 @@
 module Yandex
   module API
     module Fotki
-      VERSION = '0.1.9'
+      VERSION = '0.2.0'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yandex-api-fotki
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.2.0
 platform: ruby
 authors:
 - github.com/1v
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-11-09 00:00:00.000000000 Z
+date: 2016-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -128,6 +128,11 @@ files:
 - bin/setup
 - lib/yandex-api-fotki.rb
 - lib/yandex/api/fotki.rb
+- lib/yandex/api/fotki/album.rb
+- lib/yandex/api/fotki/albums.rb
+- lib/yandex/api/fotki/me.rb
+- lib/yandex/api/fotki/photo.rb
+- lib/yandex/api/fotki/photos.rb
 - lib/yandex/api/fotki/version.rb
 - yandex-api-fotki.gemspec
 homepage: https://github.com/1v/yandex-api-fotki