go-picasa-go 0.0.1

data/lib/picasa/http/photo.rb

@@ -0,0 +1,117 @@
+# Module that offers methods to do the basic HTTP requests to services provided
+# by Picasa to manipulate photos.
+module Picasa
+  module HTTP
+    module Photo
+      
+      # Do a get request to retrieve all the photos from an album
+      
+      def self.get_photos user_id, album_id, auth_token
+        uri = photos_uri user_id, album_id
+        http = Net::HTTP.new(uri.host)
+        http.get uri.path, auth_header(auth_token)
+      end
+      
+      # Do a get request to retrieve one photo from an album
+      
+      def self.get_photo user_id, album_id, photo_id, auth_token
+        uri = photo_uri user_id, album_id, photo_id
+        http = Net::HTTP.new(uri.host)
+        http.get uri.path, auth_header(auth_token)
+      end
+      
+      # Do a post request to save a new photo.
+      
+      def self.post_photo user_id, album_id, auth_token, summary, file
+        uri = photos_uri user_id, album_id
+
+        template_path = File.dirname(__FILE__) + '/../template/'
+  
+        template = ERB.new File.open(template_path+"photo.erb").read
+        body = template.result(binding)
+        
+        http = Net::HTTP.new(uri.host, uri.port)
+        request = Net::HTTP::Post.new(uri.request_uri)
+        request.body = body
+        request["Content-Type"] = "multipart/related; boundary=\"END_OF_PART\""
+        request["Authorization"] = "GoogleLogin auth=#{auth_token}"
+
+        http.request(request)
+      end
+      
+      # Do a delete request to delete a photo from an album
+      
+      def self.delete_photo user_id, album_id, photo_id, auth_token
+        uri = photo_uri user_id, album_id, photo_id
+        headers = photos_headers auth_token, "If-Match" => "*"
+        
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.send_request('DELETE',uri.path, nil, headers)
+      end
+      
+      # Do a put request to update a photo from an album
+      
+      def self.update_photo user_id, album_id, photo_id, auth_token, summary, file
+        uri = photo_media_uri user_id, album_id, photo_id
+        
+        template_path = File.dirname(__FILE__) + '/../template/'
+  
+        template = ERB.new File.open(template_path+"photo.erb").read
+        body = template.result(binding)
+        
+        http = Net::HTTP.new(uri.host, uri.port)
+        request = Net::HTTP::Put.new(uri.request_uri)
+        request.body = body
+        request["Content-Type"] = "multipart/related; boundary=\"END_OF_PART\""
+        request["Authorization"] = "GoogleLogin auth=#{auth_token}"
+        request["If-Match"] = "*"
+
+        http.request(request)
+      end 
+      
+      def self.download_image link
+        uri = URI.parse link
+        
+        file_name = link.split("/").last
+        
+        http = Net::HTTP.new(uri.host)
+        resp = http.get uri.path
+        
+        tempfilename = File.join(Dir.tmpdir, file_name)
+        tempfile = File.new(tempfilename, "w")
+        tempfile.write resp.body
+        tempfile.close
+        tempfile
+      end
+      
+      private 
+      
+      def self.photos_uri user_id, album_id
+        URI.parse "http://picasaweb.google.com/data/feed/api/user/#{user_id}/albumid/#{album_id}"
+      end
+      
+      def self.photo_uri user_id, album_id, photo_id
+        URI.parse "http://picasaweb.google.com/data/entry/api/user/#{user_id}/albumid/#{album_id}/photoid/#{photo_id}"
+      end
+      
+      def self.photo_media_uri user_id, album_id, photo_id
+        URI.parse "http://picasaweb.google.com/data/media/api/user/#{user_id}/albumid/#{album_id}/photoid/#{photo_id}"
+      end
+      
+      def self.auth_header auth_token
+        headers = {
+          "Authorization" => "GoogleLogin auth=#{auth_token}"
+        }
+      end
+      
+      def self.photos_headers auth_token, opts = {}
+        headers = {
+          "Authorization" => "GoogleLogin auth=#{auth_token}",
+          "Content-Type" => "application/atom+xml"
+        }
+        
+        headers.merge opts
+      end
+    end
+  end
+end

data/lib/picasa/missing.rb

@@ -0,0 +1,22 @@
+module Picasa::Missing
+  def method_missing(method, *args, &block)
+    case method
+      when :save
+        self.send(:picasa_save)
+      when :save!
+        self.send(:picasa_save!)
+      when :update
+        self.send(:picasa_update)
+      when :update!
+        self.send(:picasa_update!)
+      when :update_attributes
+        self.send(:picasa_update_attributes, args)
+      when :update_attributes!
+        self.send(:picasa_update_attributes!, args)
+      when :destroy
+        self.send(:picasa_destroy)
+      when :destroy!
+        self.send(:picasa_destroy!)
+    end
+  end
+end

data/lib/picasa/photo.rb

@@ -0,0 +1,190 @@
+# Module that offers methods to do high level operations concerning
+# a album within Picasa.
+
+module Picasa::Photo
+  
+  include Picasa::Missing
+  
+  # Class methods to be added to the class that will include this module.
+    
+  module ClassMethods
+  
+    # Sets the user class configured so it can be used later.
+  
+    def belongs_to_picasa_album params
+      unless params[:class_name] and params[:class_name].class == String
+        raise Exception, 'You should pass the string of the class name that includes Picasa::Album.'
+      end
+      
+      define_dependent_class_methods :album_class, params[:class_name]
+    end
+    
+    # Find a photo by user_id, album_id and photo_id
+    # If no album is found, then an exception is raised.
+    
+    def picasa_find user_id, album_id, photo_id, auth_token
+      resp, data = Picasa::HTTP::Photo.get_photo user_id, album_id, photo_id, auth_token
+      
+      if resp.code != "200" or resp.message != "OK"
+        raise Exception, "Photo not found"
+      end
+      
+      photo = new
+      photo.send(:populate_attributes_from_xml, data)
+      photo.album = album_class.picasa_find user_id, album_id, auth_token
+      photo.file = Picasa::HTTP::Photo.download_image photo.media_content_url
+      photo
+    end
+    
+    # Find all photos from an album using user_id, album_id
+    # If no album is found, then an exception is raised.
+    
+    def picasa_find_all user_id, album_id, auth_token
+      resp, data = Picasa::HTTP::Photo.get_photos user_id, album_id, auth_token
+      
+      if resp.code != "200" or resp.message != "OK"
+        raise Exception, "Error while retrieving photos. Code: #{resp.code}, Message: #{resp.message}\n"+
+          "#{user_id}, #{album_id}, #{auth_token}"
+      end
+      
+      photos = []
+      album = album_class.picasa_find user_id, album_id, auth_token
+      doc = Nokogiri::XML(data)
+      
+      doc.xpath('//xmlns:entry').each do |entry|
+        photo = new
+        photo.send(:populate_attributes, entry)
+        photo.album = album
+        photos << photo
+      end
+      photos
+    end
+  end
+  
+  def self.included(base)
+    base.extend(ClassMethods)
+  end
+  
+  attr_reader :picasa_id, :albumid, :width, :height, :size, :timestamp, :comment_count,
+              :media_title, :media_content_url,
+              :media_thumbnail_url1, :media_thumbnail_url2, 
+              :media_thumbnail_url3, :album
+  
+  attr_accessor :album, :description, :file
+  
+  # Post a photo into a picasa album.
+  # If cannot post, an exception is raised.
+  
+  def picasa_save!
+    if self.picasa_id and self.picasa_id.length > 0
+      return picasa_update!
+    end
+    
+    resp, data = Picasa::HTTP::Photo.post_photo user_id, album_id, auth_token, description, file
+    
+    if resp.code != "201" or resp.message != "Created"
+      raise Exception, "Error posting photo: #{resp.message}."
+    end
+    
+    populate_attributes_from_xml data
+  end
+  
+  # Post a photo into a picasa album.
+  # If cannot post, returns false.
+  
+  def picasa_save
+    raise_exception? do
+      self.picasa_save!
+    end
+  end
+  
+  # Update photo's file and metadata.
+  # If cannot update, an exception is raised.
+  
+  def picasa_update!
+    resp, data = Picasa::HTTP::Photo.update_photo(
+      'bandmanagertest', album_id, picasa_id, auth_token, description, file
+    )
+    
+    if resp.code != "200" or resp.message != "OK"
+      raise Exception, "Error updating photo: #{resp.message}."
+    end
+    
+    populate_attributes_from_xml data
+  end
+  
+  # Update photo's file and metadata.
+  # If cannot update, returns false.
+  
+  def picasa_update
+    raise_exception? do
+      self.picasa_update!
+    end
+  end
+  
+  # Delete the current photo from album.
+  # If cannot delete, an exception is raised.
+  
+  def destroy!
+    resp, data = Picasa::HTTP::Photo.delete_photo user_id, album_id, picasa_id, auth_token
+    
+    if resp.code != "200" or resp.message != "OK"
+      raise Exception, "Error destroying photo: #{resp.message}."
+    end
+  end
+  
+  # Delete the current photo from album.
+  # If cannot delete, an exception is raised.
+  
+  def destroy
+    raise_exception? do
+      self.destroy
+    end
+  end
+  
+  private 
+  
+  def populate_attributes_from_xml xml
+    doc = Nokogiri::XML xml
+    entry = doc.css('entry')
+    populate_attributes entry
+  end
+
+  def populate_attributes doc
+    hash = doc_to_hash doc
+    
+    hash.keys.each do |k|
+      self.instance_variable_set("@#{k}", hash[k])
+    end    
+  end
+
+  def doc_to_hash doc
+    hash = {
+      :picasa_id => doc.at_xpath('.//gphoto:id').content,
+      :albumid => doc.at_xpath('.//gphoto:albumid').content,
+      :width => doc.at_xpath('.//gphoto:width').content.to_i,
+      :height => doc.at_xpath('.//gphoto:height').content.to_i,  
+      :size => doc.at_xpath('./gphoto:size').content.to_i,
+      :timestamp => Time.at(doc.at_xpath('.//gphoto:timestamp').content.slice(0..9).to_i),
+      :comment_count => doc.at_xpath('.//gphoto:commentCount').content.to_i,
+      :media_title => doc.at_xpath('.//media:title').content,
+      :description => doc.at_xpath('.//media:description').content,
+      :media_content_url => doc.at_xpath('.//media:content').attr('url'),
+      :media_thumbnail_url1 => doc.xpath('.//media:thumbnail')[0].attr('url'),
+      :media_thumbnail_url2 => doc.xpath('.//media:thumbnail')[1].attr('url'),
+      :media_thumbnail_url3 => doc.xpath('.//media:thumbnail')[2].attr('url')
+    }
+  end
+
+  def user_id
+    @album.user.picasa_id
+  end
+  
+  def album_id
+    @album.picasa_id
+  end
+  
+  def auth_token
+    @album.user.auth_token
+  end
+end

data/lib/picasa/template/album.xml.erb

@@ -0,0 +1,20 @@
+<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'><%= params[:title] %></title>
+  <summary type='text'><%= params[:summary] %></summary>
+  
+  <gphoto:location><%= params[:location] %></gphoto:location>
+  <gphoto:access><%= params[:access] %></gphoto:access>
+  <gphoto:timestamp><%= "#{Time.now.to_i}000" %></gphoto:timestamp>
+  
+  <media:group>
+    <media:keywords><%= params[:keywords] %></media:keywords>
+  </media:group>
+  
+  <category 
+    scheme='http://schemas.google.com/g/2005#kind' 
+    term='http://schemas.google.com/photos/2007#album'>
+  </category>
+</entry>

data/lib/picasa/template/photo.erb

@@ -0,0 +1,15 @@
+--END_OF_PART
+Content-Type: application/atom+xml
+
+<entry xmlns='http://www.w3.org/2005/Atom'>
+  <title><%= File.basename file.path %></title>
+  <summary><%= summary %></summary>
+  <category scheme="http://schemas.google.com/g/2005#kind"
+    term="http://schemas.google.com/photos/2007#photo"/>
+</entry>
+--END_OF_PART
+Content-Type: image/jpeg
+
+<%= IO.read file.path %>
+--END_OF_PART--
+

data/lib/picasa/user.rb

@@ -0,0 +1,57 @@
+# Module that offers methods to do high level operations concerning
+# a google user within Picasa.
+
+module Picasa::User
+
+  # Class methods that will be included in the class that include this module.
+
+  module ClassMethods
+    
+    # Method used to tell the gem what is the class that implements the
+    # Picasa::Album module.
+    
+    def has_many_picasa_albums params
+      unless params[:class_name] and params[:class_name].class == String
+        raise Exception, 'You should pass the string of the class name that includes Picasa::Album.'
+      end
+
+      define_dependent_class_methods :album_class, params[:class_name]      
+    end
+  end
+
+  def self.included(base)
+    ClassMethods.extend Picasa::Util
+    base.extend(ClassMethods)
+  end
+  
+  attr_accessor :picasa_id, :auth_token
+  attr_writer :password
+  
+  # Authenticates user using the attributes of the instance.
+  # Returns the authentication token if the authentication succedes, otherwise
+  # an exception is raised.
+  
+  def authenticate
+    @auth_token ||= Picasa::Authentication.authenticate picasa_id, @password
+  end
+  
+  # Find an album from the current user using the album_id
+  
+  def find_album album_id
+    album = album_class.picasa_find picasa_id, album_id, auth_token
+    album
+  end
+  
+  # Find all albums from the current user. The operation is done only one time
+  # for an instance, if it it's needed to do it to refresh the data you can 
+  # pass the parameter true so it can be reloaded.
+  
+  def albums(reload = false)
+    @albums = album_class.picasa_find_all(picasa_id, auth_token) if reload
+    @albums ||= album_class.picasa_find_all(picasa_id, auth_token)
+  end 
+end
+
+
+
+

data/lib/picasa/util.rb

@@ -0,0 +1,33 @@
+module Picasa::Util
+  
+  def extract_auth_token body
+    body[/Auth=(.*)/, 1]
+  end
+  
+  def raise_exception?
+    begin
+      yield
+    rescue
+      return false
+    end
+    true
+  end
+  
+  def define_dependent_class_method method_name, class_name
+    define_method method_name do
+      eval(class_name)
+    end
+  end
+  
+  def define_static_dependent_class_method method_name, class_name
+    (class << self; self; end).instance_eval { 
+      define_dependent_class_method method_name, class_name
+    }
+  end
+  
+  def define_dependent_class_methods method_name, class_name
+    define_dependent_class_method method_name, class_name
+    define_static_dependent_class_method method_name, class_name
+  end
+  
+end