umanni-picasa 0.0.0.1

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,13 @@
+   Copyright 2011 Umanni
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.rdoc

@@ -0,0 +1,11 @@
+= picasa
+
+A Ruby wrapper for the Picasa Web API.
+
+== Getting started
+
+  gem install umanni-picasa
+
+== Copyright
+
+Copyright (c) 2011 Umanni. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+require 'rspec/core/rake_task'
+
+task :default => [:spec]
+
+desc "Run specs"
+RSpec::Core::RakeTask.new(:spec)
+
+Bundler::GemHelper.install_tasks

data/lib/picasa.rb

@@ -0,0 +1,24 @@
+require 'picasa/client'
+require 'picasa/config'
+
+module Picasa
+  extend Config
+  class << self
+    # Alias for Picasa::Client.new
+    #
+    # @return [Picasa::Client]
+    def new(options={})
+      Picasa::Client.new(options)
+    end
+
+    # Delegate to Picasa::Client
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+
+    def respond_to?(method, include_private=false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+  end
+end

data/lib/picasa/api.rb

@@ -0,0 +1,23 @@
+require 'picasa/authenticatable'
+require 'picasa/config'
+require 'picasa/connection'
+require 'picasa/request'
+
+module Picasa
+  class API
+    include Authenticatable
+    include Connection
+    include Request
+
+    attr_accessor *Config::VALID_OPTIONS_KEYS
+
+    # Creates a new API
+    def initialize(options={})
+      options = Picasa.options.merge(options)
+      Config::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+  end
+end

data/lib/picasa/authenticatable.rb

@@ -0,0 +1,20 @@
+module Picasa
+  module Authenticatable
+
+    def credentials
+      {
+        :refresh_token => refresh_token,
+        :access_token => access_token,
+        :expires_in => expires_in,
+        :issued_at => issued_at
+      }
+    end
+
+    # Check whether user is authenticated
+    #
+    # @return [Boolean]
+    def authenticated?
+      credentials.values.all?
+    end
+  end
+end

data/lib/picasa/base.rb

@@ -0,0 +1,23 @@
+module Picasa
+  class Base
+
+    def self.lazy_attr_reader(*attributes)
+      attributes.each do |attribute|
+        class_eval <<-RUBY, __FILE__, __LINE__ + 1
+          def #{attribute}
+            @#{attribute} ||= @attributes[#{attribute.to_s.inspect}]
+          end
+        RUBY
+      end
+    end
+
+    def initialize(attributes = {})
+      @attributes = attributes.dup
+    end
+
+    def [](method)
+      self.__send__(method.to_sym)
+    end
+
+  end
+end

data/lib/picasa/client.rb

@@ -0,0 +1,16 @@
+require 'picasa/api'
+
+module Picasa
+  class Client < API
+    
+    require 'picasa/client/comments'
+    require 'picasa/client/gallery'
+    require 'picasa/client/media'
+    
+    alias :api_endpoint :endpoint
+    
+    include Picasa::Client::Comments
+    include Picasa::Client::Gallery
+    include Picasa::Client::Media
+  end
+end

data/lib/picasa/client/base.rb

@@ -0,0 +1,12 @@
+module Picasa
+  class Client
+    module Base
+
+      DEFAULT_LANGUAGE = 'pt_BR'
+      
+      def format_response response
+        return response.code, response.headers, response.body
+      end
+    end
+  end
+end

data/lib/picasa/client/comments.rb

@@ -0,0 +1,45 @@
+require 'picasa/error'
+require 'picasa/client/base'
+require 'picasa/constants/fields'
+require 'picasa/constants/group'
+require 'picasa/constants/internal_constants'
+require 'picasa/constants/method_names'
+require 'picasa/constants/params'
+require 'multi_json'
+
+module Picasa
+  class Client
+    module Comments 
+      include Base
+
+      def list_photo_comments album_id, photo_id
+        response = get("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}?kind=comment")
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+        end
+      end
+
+      def add_photo_comment album_id, photo_id, comment
+        body = "\r\n"
+        body += "<entry xmlns='http://www.w3.org/2005/Atom'>"
+        body += "<content>#{comment}</content>"
+        body += "<category scheme=\"http://schemas.google.com/g/2005#kind\" term=\"http://schemas.google.com/photos/2007#comment\"/>"
+        body += "</entry>\r\n"
+
+        response = post("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}", body)
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+          #raise(StandardError, "#{status.to_s} - #{body.to_s}")
+        end
+      end
+    end
+  end
+end

data/lib/picasa/client/gallery.rb

@@ -0,0 +1,66 @@
+require 'picasa/client/base'
+
+module Picasa
+  class Client
+    module Gallery
+      include Base
+
+      def get_galleries
+        response = get('https://picasaweb.google.com/data/feed/api/user/default?alt=json')
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            raise(StandardError, "#{status.to_s} - #{body.to_s}")
+        end
+      end
+
+      def create_gallery(options = {})
+        title       = options[:title].nil? ? "" : options[:title]
+        summary     = options[:summary].nil? ? "" : options[:summary]
+        location    = options[:location].nil? ? "" : options[:location]
+        access      = options[:access].nil? ? "public" : options[:access]
+        commentable = options[:commentable].nil? ? "true" : options[:commentable].to_s
+        keywords    = options[:keywords].nil? ? "" : options[:keywords]
+        time_i      = (Time.now).to_i
+
+        body = "<entry xmlns='http://www.w3.org/2005/Atom'
+        xmlns:media='http://search.yahoo.com/mrss/'
+        xmlns:gphoto='http://schemas.google.com/photos/2007'>
+          <title type='text'>#{title}</title>
+          <summary type='text'>#{summary}</summary>
+          <gphoto:location>#{location}</gphoto:location>
+          <gphoto:access>#{access}</gphoto:access>
+          <gphoto:commentingEnabled>#{commentable}</gphoto:commentingEnabled>
+          <gphoto:timestamp>#{time_i}</gphoto:timestamp>
+          <media:group>
+            <media:keywords>#{keywords}</media:keywords>
+          </media:group>
+          <category scheme='http://schemas.google.com/g/2005#kind'
+            term='http://schemas.google.com/photos/2007#album'></category>
+        </entry>"
+
+        response = post("https://picasaweb.google.com/data/feed/api/user/default", body)
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+        end
+      end
+
+      def get_gallery_tags gallery_id
+        response = get("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{gallery_id}?kind=tag")
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+        end
+      end
+    end
+  end
+end

data/lib/picasa/client/media.rb

@@ -0,0 +1,119 @@
+require 'picasa/client/base'
+
+module Picasa
+  class Client
+    module Media
+      include Base
+
+      def list_photo_tags album_id, photo_id
+        response = get("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}?kind=tag")
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+        end
+      end
+
+      def add_photo_tag album_id, photo_id, tag
+        body = "\r\n"
+        body += "<entry xmlns='http://www.w3.org/2005/Atom'>"
+        body += "<title>#{tag}</title>"
+        body += "<category scheme=\"http://schemas.google.com/g/2005#kind\" term=\"http://schemas.google.com/photos/2007#tag\"/>"
+        body += "</entry>\r\n"
+
+        response = post("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}", body)
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+          #raise(StandardError, "#{status.to_s} - #{body.to_s}")
+        end
+      end
+
+      def delete_photo album_id, photo_id
+        response = delete("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}")
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+        end
+      end
+
+      def delete_photo_comment album_id, photo_id, comment_id
+        response = delete("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}/commentid/#{comment_id}")
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+          #raise(StandardError, "#{status.to_s} - #{body.to_s}")
+        end
+      end
+
+      def delete_photo_tag album_id, photo_id, tag_id
+        response = delete("https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}/tag/#{tag_id}")
+        status, headers, body = response
+        case status
+          when 200
+            return body
+          else
+            return body
+          #raise(StandardError, "#{status.to_s} - #{body.to_s}")
+        end
+      end
+
+      ## Accepted image formats
+      # image/bmp
+      # image/gif
+      # image/jpeg
+      # image/png
+      def create_photo album_id, options = {}
+        title   = options[:title].nil? ? "" : options[:title]
+        summary = options[:summary].nil? ? "" : options[:summary]
+
+        string_body = "<entry xmlns='http://www.w3.org/2005/Atom'>
+  <title>#{title}</title>
+  <summary>#{summary}</summary>
+  <category scheme=\"http://schemas.google.com/g/2005#kind\"
+    term=\"http://schemas.google.com/photos/2007#photo\"/>
+</entry>
+"
+        uri         = "https://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}"
+
+        #@xml_io = FileUploadIO.new('/tmp/atom_body_0.atom', "application/atom+xml")
+        @xml_io     = FileUploadIO.new('/tmp/atom_body.atom', "application/atom+xml", string_body)
+
+        @photo_io = FileUploadIO.new('/home/trooper/Projetos/Aggregator-Tests/public/images/eu_s2b.jpg', "image/jpeg")
+
+        headers        = {
+            'Content-Type'  => 'multipart/related',
+            'GData-Version' => '2',
+            'Authorization' => "OAuth #{@client.access_token}",
+            'MIME-version'  => '1.0',
+        }
+        params         = {
+            :file_0 => @xml_io,
+            :file_1 => @photo_io,
+        }
+        multipart_post = MultiPart::Post.new(params, headers)
+
+        res                   = multipart_post.submit(uri, nil, 'multipart/related')
+        status, headers, body = format_response(res)
+        case status
+          when 201
+            return body
+          else
+            return body
+          #raise(StandardError, "#{status.to_s} - #{body.to_s}")
+        end
+      end
+    end
+  end
+end

data/lib/picasa/config.rb

@@ -0,0 +1,86 @@
+require 'picasa/version'
+
+module Picasa
+  # Defines constants and methods related to configuration
+  module Config
+    # An array of valid keys in the options hash when configuring a {Picasa::API}
+
+    VALID_OPTIONS_KEYS = [
+      :base_uri,
+      :authorization_uri,
+      :token_credential_uri,
+      :client_id,
+      :client_secret,
+      :scope,
+      :redirect_uri,
+      :refresh_token,
+      :access_token,
+      :expires_in,
+      :issued_at,
+      :user_agent
+    ].freeze
+
+    DEFAULT_BASE_URI = 'https://picasaweb.google.com/data/'.freeze
+
+    DEFAULT_AUTHORIZATION_URI = 'https://accounts.google.com/o/oauth2/auth'.freeze
+
+    DEFAULT_TOKEN_CREDENTIAL_URI = 'https://accounts.google.com/o/oauth2/token'.freeze
+
+    DEFAULT_CLIENT_ID = nil
+
+    DEFAULT_CLIENT_SECRET = nil
+
+    DEFAULT_SCOPE = 'https://picasaweb.google.com/data/'.freeze
+
+    DEFAULT_REDIRECT_URI = ''
+
+    DEFAULT_REFRESH_TOKEN = nil
+
+    DEFAULT_ACCESS_TOKEN = nil
+
+    DEFAULT_EXPIRES_IN = nil
+
+    DEFAULT_ISSUED_AT = nil
+
+    # The value sent in the 'User-Agent' header if none is set
+    DEFAULT_USER_AGENT = "Picasa Ruby Gem #{Picasa::Version}".freeze
+
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    # When this module is extended, set all configuration options to their default values
+    def self.extended(base)
+      base.reset
+    end
+
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+      self
+    end
+
+    # Create a hash of options and their values
+    def options
+      options = {}
+      VALID_OPTIONS_KEYS.each{|k| options[k] = send(k)}
+      options
+    end
+
+    # Reset all configuration options to defaults
+    def reset
+      self.base_uri             = DEFAULT_BASE_URI
+      self.authorization_uri    = DEFAULT_AUTHORIZATION_URI
+      self.token_credential_uri = DEFAULT_TOKEN_CREDENTIAL_URI
+      self.client_id            = DEFAULT_CLIENT_ID
+      self.client_secret        = DEFAULT_CLIENT_SECRET
+      self.scope                = DEFAULT_SCOPE
+      self.redirect_uri         = DEFAULT_REDIRECT_URI
+      self.refresh_token        = DEFAULT_REFRESH_TOKEN
+      self.access_token         = DEFAULT_ACCESS_TOKEN
+      self.expires_in           = DEFAULT_EXPIRES_IN
+      self.issued_at            = DEFAULT_ISSUED_AT
+      self.user_agent           = DEFAULT_USER_AGENT
+      self
+    end
+
+  end
+end

data/lib/picasa/connection.rb

@@ -0,0 +1,43 @@
+require 'signet/oauth_2/client'
+require 'picasa/error'
+
+module Picasa
+  module Connection
+
+    @client = nil
+
+    private
+      def connection(options={})
+        if client.nil?
+          client = Signet::OAuth2::Client.new(
+            :authorization_uri    => authorization_uri,
+            :token_credential_uri => token_credential_uri,
+            :client_id            => client_id,
+            :client_secret        => client_secret,
+            :scope                => scope,
+            :redirect_uri         => redirect_uri,
+            :refresh_token        => refresh_token,
+            :access_token         => access_token
+          )
+        end
+        client
+      end
+
+      def update_token_values(object)
+        ::Picasa.configure do |config|
+          config.refresh_token = object.refresh_token
+          config.access_token = object.access_token
+          config.expires_in = object.expires_in
+          config.issued_at = Time.at(object.issued_at)
+        end
+      end
+
+      def get_token_values(object)
+        return {:refresh_token => object.refresh_token,
+                :access_token  => object.access_token,
+                :expires_in    => object.expires_in,
+                :issued_at     => Time.at(object.issued_at)
+        }
+      end
+  end
+end

data/lib/picasa/error.rb

@@ -0,0 +1,5 @@
+module Picasa
+  class Error < StandardError
+
+  end
+end

data/lib/picasa/request.rb

@@ -0,0 +1,54 @@
+require 'picasa/error'
+module Picasa
+  # Defines HTTP request methods
+  module Request
+    
+    DEFAULT_HEADERS = {'Content-Type' => 'application/atom+xml', 'GData-Version' => '2'}
+    @refreshed = false
+
+    def get uri, headers = {}
+      response = request('GET', uri, nil, headers)
+      response
+    end
+
+    def post uri, body, headers = {}
+      response = request('POST', uri, body, DEFAULT_HEADERS.merge!(headers))
+      response
+    end
+
+    def put uri, body, headers = {}
+      response = request('PUT', uri, body, DEFAULT_HEADERS.merge!(headers))
+      response
+    end
+
+    def delete uri, headers = {}
+      response = request('DELETE', uri, nil, headers)
+      response
+    end
+
+    def multipart_post
+
+    end
+
+    private
+      def request method, uri, body = nil, headers = {}
+        begin
+          options = {:method => (method || 'GET'), :uri => uri}
+          options.merge!({:headers => headers}) unless headers.blank?
+          options.merge!({:body => body}) unless body.blank?
+
+          response = connection.fetch_protected_resource(options)
+          status, headers, body = response
+          case status
+            when 401, 403
+              connection.fetch_access_token!
+              response = request(method, uri, body, headers)
+          end
+        rescue Net::HTTPUnauthorized
+          connection.fetch_access_token!
+          response = request(method, uri, body, headers)
+        end
+        response
+      end
+  end
+end

data/lib/picasa/version.rb

@@ -0,0 +1,25 @@
+module Picasa
+  class Version
+
+    def self.major
+      0
+    end
+
+    def self.minor
+      0
+    end
+
+    def self.patch
+      0
+    end
+
+    def self.pre
+      1 #nil
+    end
+
+    def self.to_s
+      [major, minor, patch, pre].compact.join('.')
+    end
+
+  end
+end

data/picasa.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "picasa/version"
+
+Gem::Specification.new do |s|
+  s.name        = 'umanni-picasa'
+  s.version     = Picasa::Version.to_s
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Umanni']
+  s.email       = ['contato@umanni.com']
+  s.homepage    = 'https://github.com/umanni/picasa'
+  s.summary     = %q{Picasa Web API wrapper}
+  s.description = %q{A Ruby wrapper for the Picasa Web API.}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+
+  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"]
+
+  s.add_dependency 'signet', [">= 0.2.4"]
+  s.add_dependency 'umanni-multipart-post'
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: umanni-picasa
+version: !ruby/object:Gem::Version
+  version: 0.0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Umanni
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-15 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: signet
+  requirement: &10630600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: *10630600
+- !ruby/object:Gem::Dependency
+  name: umanni-multipart-post
+  requirement: &10629780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *10629780
+description: A Ruby wrapper for the Picasa Web API.
+email:
+- contato@umanni.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.rdoc
+files:
+- Gemfile
+- LICENSE
+- README.rdoc
+- Rakefile
+- lib/picasa.rb
+- lib/picasa/api.rb
+- lib/picasa/authenticatable.rb
+- lib/picasa/base.rb
+- lib/picasa/client.rb
+- lib/picasa/client/base.rb
+- lib/picasa/client/comments.rb
+- lib/picasa/client/gallery.rb
+- lib/picasa/client/media.rb
+- lib/picasa/config.rb
+- lib/picasa/connection.rb
+- lib/picasa/error.rb
+- lib/picasa/request.rb
+- lib/picasa/version.rb
+- picasa.gemspec
+homepage: https://github.com/umanni/picasa
+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: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Picasa Web API wrapper
+test_files: []