picasawebalbums 1.0.1

data/.gitignore

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

data/Gemfile

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

data/PicasaWebAlbums.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "PicasaWebAlbums/version"
+
+Gem::Specification.new do |s|
+  s.name        = "picasawebalbums"
+  s.version     = PicasaWebAlbums::VERSION
+  s.authors     = ["Martin Kraft"]
+  s.email       = ["martinkraft@gmail.com"]
+  s.homepage    = "https://github.com/mkraft/PicasaWebAlbums"
+  s.summary     = %q{Provides programmatic access to Picasa Web Albums data.}
+  s.description = %q{A simple way to retrieve albums, photos, tags, etc. from Picasa Web Albums.}
+
+  s.rubyforge_project = "picasawebalbums"
+  s.required_ruby_version = '>= 1.9.3'
+  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"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/PicasaWebAlbums/version.rb

@@ -0,0 +1,3 @@
+module PicasaWebAlbums
+  VERSION = "1.0.1"
+end

data/lib/PicasaWebAlbums.rb

@@ -0,0 +1,15 @@
+#require "PicasaWebAlbums/version"
+require 'net/http'
+require 'rexml/document'
+require 'date'
+require_relative 'album'
+require_relative 'photo'
+require_relative 'tag'
+require_relative 'repository'
+
+module PicasaWebAlbums
+  def self.get_repository(email, password)
+    picasa_repo = Repository.new(email, password)
+    return picasa_repo
+  end
+end

data/lib/album.rb

@@ -0,0 +1,9 @@
+module PicasaWebAlbums
+  class Album
+    attr_accessor :id, :photos, :title, :slug, :date_created, :date_updated, :cover_photo_url, :description
+
+    def initialize
+      @photos = []
+    end
+  end
+end

data/lib/photo.rb

@@ -0,0 +1,5 @@
+module PicasaWebAlbums
+  class Photo
+    attr_accessor :id, :url, :caption, :width, :height, :file_name
+  end
+end

data/lib/repository.rb

@@ -0,0 +1,126 @@
+module PicasaWebAlbums
+  class Repository
+    def initialize(email, password)
+      @email = email
+      @authentication_token = get_authentication_token(email, password)
+    end
+
+    def get_all_albums
+      xml = get_xml("http://picasaweb.google.com/data/feed/api/user/#{@email}?kind=album&access=all")
+      albums = []
+      xml.root.elements.each("//entry") do |entry|
+        gallery = Album.new
+        gallery.id = entry.elements["gphoto:id"].text
+        gallery.title = entry.elements["title"].text
+        gallery.date_created = DateTime.parse(entry.elements["published"].text)
+        gallery.date_updated = DateTime.parse(entry.elements["updated"].text)
+        gallery.slug = entry.elements["gphoto:name"].text
+        gallery.cover_photo_url = entry.elements["media:group/media:content"].attributes["url"]
+        gallery.description = entry.elements["media:group/media:description"].text
+        albums << gallery
+      end
+      return albums
+    end
+
+    def get_album_by_id(id)
+      albums = get_all_albums
+      album_to_return = albums[albums.find_index{|album| album.id == id.to_s}]
+      return album_to_return
+    end
+
+    def get_album_by_title(title)
+      albums = get_all_albums
+      album_to_return = albums[albums.find_index{|album| album.title == title.to_s}]
+      return album_to_return
+    end
+
+    def get_album_by_slug(slug)
+      albums = get_all_albums
+      album_to_return = albums[albums.find_index{|album| album.slug == slug.to_s}]
+      return album_to_return
+    end
+
+    def get_photos_by_album_id(id)
+      xml = get_xml("http://picasaweb.google.com/data/feed/base/user/#{@email}/albumid/#{id}")
+      photos = []
+      xml.root.elements.each("//entry") do |entry|
+        photo = Photo.new
+        photo.id = get_photo_id_from_photo_id_url(entry.elements["id"].text)
+        photo.url = entry.elements["media:group/media:content"].attributes["url"]
+        photo.width = entry.elements["media:group/media:content"].attributes["width"].to_i
+        photo.height = entry.elements["media:group/media:content"].attributes["height"].to_i
+        photo.caption = entry.elements["media:group/media:description"].text
+        photo.file_name = entry.elements["media:group/media:title"].text
+        photos << photo
+      end
+      return photos
+    end
+
+    def get_photo_by_album_id_and_photo_id(album_id, photo_id)
+      photos = get_photos_by_album_id(album_id)
+      photo_to_return = Photo.new
+      photos.each do |photo|
+        if photo.id == photo_id
+          photo_to_return = photo
+        end
+      end
+      return photo_to_return
+    end
+    
+    def get_all_tags
+      xml = get_xml("http://picasaweb.google.com/data/feed/api/user/#{@email}?kind=tag")
+      tags = []
+      xml.root.elements.each("//entry") do |entry|
+        tag = Tag.new
+        tag.text = entry.elements["title"].text
+        tags << tag
+      end
+      return tags
+    end
+    
+    def get_tags_by_album_id(album_id)
+      xml = get_xml("http://picasaweb.google.com/data/feed/api/user/userID/albumid/#{album_id}?kind=tag")
+    end
+    
+    def get_tags_by_album_id_and_photo_id(album_id, photo_id)
+      xml = get_xml("http://picasaweb.google.com/data/feed/api/user/default/albumid/#{album_id}/photoid/#{photo_id}?kind=tag")
+    end
+
+    private
+    
+    def get_xml(url)
+      uri = URI(url)
+      request = Net::HTTP::Get.new(uri.request_uri)
+      request['Authorization'] = @authentication_token
+      response = Net::HTTP.start(uri.hostname, uri.port) { |http|
+        http.request(request)
+      }
+      xml = REXML::Document.new(response.body)
+      return xml
+    end
+
+    def get_photo_id_from_photo_id_url(photo_id_url)
+      start_index = photo_id_url.index('/photoid/') + 9
+      slice_of_id_url_to_end = photo_id_url[start_index..-1]
+      end_index = slice_of_id_url_to_end.index(/[?|\/]/)
+      id = slice_of_id_url_to_end[0...end_index]
+      return id
+    end
+
+    def get_authentication_token(email, password)
+      uri = URI("https://www.google.com/accounts/ClientLogin")
+      Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
+        request = Net::HTTP::Post.new uri.request_uri
+        data = "accountType=HOSTED_OR_GOOGLE&Email=#{email}&Passwd=#{password}&service=lh2&source=someapp1"
+        response = http.request(request, data)
+        @body = response.body
+      end
+      start_index = @body.index('Auth=')
+      slice_of_auth_to_end = @body[start_index..-1]
+      end_index = slice_of_auth_to_end.index("\n")
+      auth_string = slice_of_auth_to_end[0...end_index]
+      auth_token = "GoogleLogin #{auth_string}"
+      return auth_token
+    end
+  end
+end

data/lib/tag.rb

@@ -0,0 +1,5 @@
+module PicasaWebAlbums
+  class Tag
+    attr_accessor :text
+  end
+end

data/readme.md

@@ -0,0 +1,88 @@
+PicasaWebAlbums
+===============
+
+Gem for accessing photos and albums from Picasa Web Albums
+
+Installation
+------------
+
+	gem install PicasaWebAlbums
+	
+Rails/Application Integration
+-----------------------------
+
+Add one of the below lines to the Gemfile:
+
+- `gem 'PicasaWebAlbums'` (to install it from rubygems)
+- `gem 'PicasaWebAlbums', :git => 'git@github.com:mkraft/PicasaWebAlbums.git'` (to install directly from the git repo)
+
+Then run `bundle install`
+
+Code Examples
+-------------
+
+Print the title of all albums
+
+	repo = PicasaWebAlbums.get_repository('someperson@gmail.com', 'somepassword')
+	albums = repo.get_albums
+	albums.each { |album| puts album.title }
+
+Print the URL of each photo in the album titled "Big Boy"
+
+	repo = PicasaWebAlbums.get_repository('someperson@gmail.com', 'somepassword')
+	album = repo.get_album_by_title("Big Boy")
+	photos = repo.get_photos_by_album_id(album.id)
+	photos.each { |photo| puts photo.url }
+
+Repository Methods
+-------------------
+
+### Album(s)
+
+- `get_all_albums`
+- `get_album_by_id(id)`
+- `get_album_by_title(title)`
+- `get_album_by_slug(slug)`
+
+### Photo(s)
+
+- `get_photos_by_album_id(album_id)`
+- `get_photo_by_album_id_and_photo_id(album_id, photo_id)`
+
+### Tags
+
+- `get_all_tags`
+- `get_tags_by_album_id(album_id)`
+- `get_tags_by_album_id_and_photo_id(album_id, photo_id)`
+
+Domain Object Properties
+------------------------
+
+### Photo
+
+- `id`
+- `url`
+- `caption`
+- `width`
+- `height`
+- `file_name`
+
+### Album
+
+- `id`
+- `photos`
+- `title`
+- `slug`
+- `date_created`
+- `date_updated`
+- `cover_photo_url`
+- `description`
+
+### Tag
+
+- `text`
+
+Additional Documentation
+------------------------
+
+Additional documentation can be found on the [rubydoc pages](http://rubydoc.info/gems/PicasaWebAlbums).

data/test/test_albums.rb

@@ -0,0 +1,41 @@
+require 'test/unit'
+require 'shoulda'
+require_relative '../lib/picasawebalbums'
+
+module PicasaWebAlbums
+  class TestAlbums < Test::Unit::TestCase
+  
+    context "get all albums" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return albums" do
+        albums = repo.get_all_albums
+        assert_equal 4, albums.count
+      end
+    end
+  
+    context "get album by id" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return an album" do
+       album = repo.get_album_by_id("5461230096110151249")
+       assert_equal "Banner Images", album.title
+      end
+    end
+  
+    context "get album by title" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return an album" do
+       album = repo.get_album_by_title("Bio Profile Pics")
+       assert_equal "5455332611886090353", album.id
+      end
+    end
+  
+    context "get album by slug" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return an album" do
+       album = repo.get_album_by_slug("960x350")
+       assert_equal "5577380987485671713", album.id
+      end
+    end
+  
+  end
+end

data/test/test_photos.rb

@@ -0,0 +1,27 @@
+require 'test/unit'
+require 'shoulda'
+require_relative '../lib/picasawebalbums'
+
+module PicasaWebAlbums
+  class TestPhotos < Test::Unit::TestCase
+  
+    context "get photos from album" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return at least 1 photo" do
+       album = repo.get_album_by_id(5461230096110151249)
+       photos = repo.get_photos_by_album_id(album.id)
+       assert_equal true, photos.count > 0
+      end
+    end
+  
+    context "get photo by album and id" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return 1 photo" do
+       album = repo.get_album_by_slug("960x350")
+       photo = repo.get_photo_by_album_id_and_photo_id(album.id, "5577383323184640194")
+       assert_equal "Lake Joe Home.", photo.caption
+      end
+    end
+  
+  end
+end

data/test/test_tags.rb

@@ -0,0 +1,33 @@
+require 'test/unit'
+require 'shoulda'
+require_relative '../lib/picasawebalbums'
+
+module PicasaWebAlbums
+  class TestTags < Test::Unit::TestCase
+    
+    context "get all tags" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return at least 1 tag" do
+        tags = repo.get_all_tags
+        assert tags.count > 0
+      end
+    end
+  
+    context "get tags by album id" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return at least 1 tag" do
+        tags = repo.get_tags_by_album_id("5461230096110151249")
+        assert tags.count > 0
+      end
+    end
+  
+    context "get tags by album id and photo id" do
+      repo = PicasaWebAlbums.get_repository('apitest33@gmail.com', 'ruhak23A')
+      should "return at least 1 tag" do
+        tags = repo.get_tags_by_album_id_and_photo_id("5461230096110151249", "5577383323184640194")
+        assert tags.count > 0
+      end
+    end
+  
+  end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: picasawebalbums
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Martin Kraft
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-18 00:00:00.000000000 Z
+dependencies: []
+description: A simple way to retrieve albums, photos, tags, etc. from Picasa Web Albums.
+email:
+- martinkraft@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- PicasaWebAlbums.gemspec
+- Rakefile
+- lib/PicasaWebAlbums.rb
+- lib/PicasaWebAlbums/version.rb
+- lib/album.rb
+- lib/photo.rb
+- lib/repository.rb
+- lib/tag.rb
+- readme.md
+- test/test_albums.rb
+- test/test_photos.rb
+- test/test_tags.rb
+homepage: https://github.com/mkraft/PicasaWebAlbums
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: picasawebalbums
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: Provides programmatic access to Picasa Web Albums data.
+test_files:
+- test/test_albums.rb
+- test/test_photos.rb
+- test/test_tags.rb