picasaweb 1.0.0

data/History.txt

@@ -0,0 +1,5 @@
+== 1.0.0 / 2007-11-29
+
+* 1 major enhancement
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/picasaweb
+lib/picasaweb.rb
+test/test_picasaweb.rb

data/README.txt

@@ -0,0 +1,59 @@
+picasaweb
+    by Logan Koester
+    http://logankoester.com/tools/picasaweb
+
+== DESCRIPTION:
+  
+Ruby interface to Google's Picasa Web Albums (photo sharing site). Includes a command-line tool for downloading photos from Picasa albums.
+
+== FEATURES/PROBLEMS:
+  
+* Users have many Albums, Albums have many Photos.
+* Users have a name, url, and albums
+* Albums have a title, description, link (url), date and photos
+* Photos have a title, description, image (url), link (url), and date
+* Not implemented at this time (feel free!): Search, posting/updating/deleting photos, adding albums, and editing tags and comments
+* Untested on Windows/Mac
+
+== SYNOPSIS:
+
+  # Displaying a list of photos in an album
+  my_album = PicasaAlbum.new( "http://picasaweb.google.com/BeatForgeProductions/Euphoria_Nov" )
+  my_album.photos.each do |photo|
+    puts photo.title + " at " + photo.image + "\n\n"
+  end
+
+== REQUIREMENTS:
+
+* Ruby
+* Wget
+* Ruby gems: rubygems, rss/1.0, rss/2.0, open-uri, hpricot, optiflag
+
+== INSTALL:
+
+* sudo gem install picasaweb
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007 FIX
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,17 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/picasaweb.rb'
+
+Hoe.new('picasaweb', Picasaweb::VERSION) do |p|
+  p.rubyforge_name = 'picasaweb'
+  # p.author = 'Logan Koester'
+  # p.email = 'logan@logankoester.com'
+  # p.summary = "Ruby interface to Google's Picasa Web Albums (photo sharing site). Includes a command-line tool for downloading photos from Picasa albums."
+  # p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  # p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+end
+
+# vim: syntax=Ruby

data/bin/picasaweb

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby
+###############################################################################
+# Command-line tool for downloading photos from Picasa albums. May be expanded
+# to other picasaweb-related tasks in the future as the picasaweb gem's
+# functionality grows.
+#
+# See README.txt for more documentation
+#
+# Created by Logan Koester of Icecraft Media <logan@logankoester.com>
+#
+###############################################################################
+
+require 'picasaweb'
+require 'optiflag'
+
+def download_album_images (url)
+	my_album = PicasaAlbum.new( url )
+	`mkdir #{my_album.title}`
+	my_album.photos.each do |photo|
+		`wget --directory-prefix=#{my_album.title} #{photo.image}`
+	end
+end
+
+def download_user_images (username)
+	`mkdir #{username}`
+	my_user = PicasaUser.new("http://picasaweb.google.com/" + username)
+	my_user.albums.each do |album|
+		`mkdir #{username}/#{album.title}`
+		album.photos.each do |photo|
+			`wget --directory-prefix=#{username}/#{album.title} #{photo.image}`
+		end
+	end
+end
+
+module ParseFlags extend OptiFlagSet
+	# Set command-line arguments and such here
+	# See http://optiflag.rubyforge.org/ for help
+	optional_flag 'user'
+	optional_flag 'album'
+	and_process!
+end
+
+if (ARGV.flags.user)
+	download_user_images( ARGV.flags.user )
+elsif (ARGV.flags.album)
+	download_album_images( ARGV.flags.album )
+else
+	puts "picasaweb "
+	puts "A Ruby interface to Picasa Web Albums"
+	puts "If you run into trouble, mailto:logan@logankoester.com\n\n"
+	puts "To download an album:"
+	puts "	picasaweb -album http://picasaweb.google.com/USERNAME/ALBUM\n\n"
+	puts "To download every album from a user:"
+	puts "	picasaweb -user USERNAME\n\n"
+	puts "Enjoy!"
+end

data/lib/picasaweb.rb

@@ -0,0 +1,112 @@
+###############################################################################
+# Picasaweb: Ruby interface to Google's Picasa Web Albums (photo sharing site).
+# See README.txt for more documentation
+#
+# Created by Logan Koester of Icecraft Media <logan@logankoester.com>
+#
+# Want to extend this library?
+# Start here: http://code.google.com/apis/picasaweb/overview.html
+#
+# For usage examples see the included command-line utility (bin/picasaweb)
+#
+###############################################################################
+
+%w{rubygems rss/1.0 rss/2.0 open-uri hpricot}.each { |requirement| require requirement }
+
+class Picasaweb
+	VERSION = '1.0.0'
+	def parse_rss (source)
+		# Parse an RSS feed
+		# See http://www.rubyrss.com/
+		content = ""
+		open(source) { |s| content = s.read }
+		return RSS::Parser.parse(content, false)
+	end
+
+	def find_rss (url, title)
+		# Find a specific RSS feed by the title attribute of it's <link> element
+		#		The feed for a user's albums is titled "RSS Gallery Feed."
+		#		The feed for an album's photos is titled "RSS Album Feed."
+		# You may need to modify this method if Google changes their HTML
+		content = ""
+		open(url) { |s| content = s.read }
+		document = Hpricot( content )
+		(document/"link").each do |link|
+			if (link.attributes['title'] == title)
+				return link.attributes['href']
+			end
+		end
+	end
+
+end
+
+class PicasaUser < Picasaweb
+	attr_reader :name, :link, :albums
+	def initialize (url)
+		@link = url
+
+		# Find the user's RSS feed and parse it
+		rss = parse_rss( find_user_rss( @link ) )
+
+		@name = rss.channel.title
+		@albums = get_albums_from_rss( rss )
+	end
+
+	def find_user_rss (url)
+		find_rss( url, "RSS Gallery Feed." )
+	end
+
+	def get_albums_from_rss(rss)
+		# Map albums from RSS to objects.
+		# Expects a parsed RSS object, not a string!
+		albums = Array.new
+		rss.items.each do |item|
+			album = PicasaAlbum.new( item.link )
+			albums.push( album )
+		end
+		return albums
+	end
+
+end
+
+class PicasaPhoto < Picasaweb
+	attr_accessor :title, :description, :image, :link, :date
+end
+
+class PicasaAlbum < Picasaweb
+	attr_reader :title, :description, :link, :date, :photos
+
+	def initialize (url)
+		@link = url
+
+		# Find the album's RSS feed and parse it
+		rss = parse_rss( find_album_rss( @link ) )
+
+		@title = rss.channel.title
+		@description = rss.channel.description
+		@date = rss.channel.date # Accurate?
+
+		@photos = get_photos_from_rss( rss )
+	end
+
+	def get_photos_from_rss(rss)
+		# Map photos from RSS to objects.
+		# Expects a parsed RSS object, not a string!
+		photos = Array.new
+		rss.items.each do |item|
+			photo = PicasaPhoto.new
+			photo.title = item.title
+			photo.description = item.description # raw html - could be parsed?
+			photo.link = item.link
+			photo.date = item.date # accurate?
+			photo.image = item.enclosure.url
+			photos.push( photo )
+		end
+		return photos
+	end
+
+	def find_album_rss (url)
+		find_rss( url, "RSS Album Feed." )
+	end
+
+end

data/test/test_picasaweb.rb

@@ -0,0 +1,2 @@
+# Sorry, I didn't write any tests. Shame on me!
+

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: picasaweb
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2007-11-29 00:00:00 -05:00
+summary: The author was too lazy to write a summary
+require_paths: 
+- lib
+email: ryand-ruby@zenspider.com
+homepage: http://www.zenspider.com/ZSS/Products/picasaweb/
+rubyforge_project: picasaweb
+description: The author was too lazy to write a description
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Ryan Davis
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/picasaweb
+- lib/picasaweb.rb
+- test/test_picasaweb.rb
+test_files: 
+- test/test_picasaweb.rb
+rdoc_options: 
+- --main
+- README.txt
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+executables: 
+- picasaweb
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.0
+    version: