chunky_baconfile 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,22 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+doc
+
+## PROJECT::SPECIFIC

data/.yardoc/checksums

@@ -0,0 +1,5 @@
+LICENSE 4c641d16b6c1534c7a8e6b29a08a4d46a0b85be9
+README.rdoc d79d1a456cbecd5e5204905d0d6b5fde03dc9c87
+lib/chunky_baconfile/file_info.rb 088daa5b027287b8b2f1f1c417c4493eb651f3b2
+lib/chunky_baconfile/client.rb 054dbf60058272a45a29f4141298549da4aade0c
+lib/chunky_baconfile.rb 258402a8abb2b18dd7649213630c800a92ba50b3

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Wynn Netherland
+
+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/README.md

@@ -0,0 +1,47 @@
+# chunky-baconfile
+
+Tasty wrapper for the [Baconfile API](http://baconfile.com/api). [Baconfile](http://baconfile.com) is a handy way to share, comment, and tweet about files uploaded to your [Amazon S3](https://s3.amazonaws.com/) account.
+
+## Installation
+
+    sudo gem install chunky_baconfile
+    
+## Usage
+
+    # crank up a client object
+    >> client = ChunkyBaconfile::Client.new('username', 'password')
+    
+    # create a folder
+    >> client.folder('test_folder')
+    => <#ChunkyBaconfile::FileInfo content_type="image/png" description="" file_url="http://s3.amazonaws.com:80/pengwynn.baconfile.com/test_folder%2Fwynn-120x120.png" id="3c05b1e667fc3cf4fd6219d146324bdd" is_folder=false name="wynn-120x120.png" path="pengwynn/test_folder/wynn-120x120.png" permalink="http://baconfile.com/pengwynn/test_folder/wynn-120x120.png/" size=7271 time_modified=1262755171 tiny_url="http://tinyb.cn/1qm" type="image" url="/pengwynn/">>
+    
+    # get a list of files in a folder
+    >> client.folder('test_folder')
+    => [<#ChunkyBaconfile::FileInfo content_type="image/png" description="" file_url="http://s3.amazonaws.com:80/pengwynn.baconfile.com/test_folder%2Fwynn-120x120.png" id="3c05b1e667fc3cf4fd6219d146324bdd" is_folder=false name="wynn-120x120.png" path="pengwynn/test_folder/wynn-120x120.png" permalink="http://baconfile.com/pengwynn/test_folder/wynn-120x120.png/" size=7271 time_modified=1262755171 tiny_url="http://tinyb.cn/1qm" type="image" url="/pengwynn/test_folder/wynn-120x120.png/" user=<#Hashie::Mash id=947 timezone="America/Chicago" username="pengwynn">>]
+    
+    # get info about a single item
+    >> client.file('test_folder', 'wynn-120x120.png')
+    => <#ChunkyBaconfile::FileInfo content_type="image/png" description="" file_url="http://s3.amazonaws.com:80/pengwynn.baconfile.com/test_folder%2Fwynn-120x120.png" id="3c05b1e667fc3cf4fd6219d146324bdd" is_folder=false name="wynn-120x120.png" path="pengwynn/test_folder/wynn-120x120.png" permalink="http://baconfile.com/pengwynn/test_folder/wynn-120x120.png/" size=7271 time_modified=1262755171 tiny_url="http://tinyb.cn/1qm" type="image" url="/pengwynn/test_folder/wynn-120x120.png/" user=<#Hashie::Mash id=947 timezone="America/Chicago" username="pengwynn">>
+
+    # upload a file
+    >> client.upload_file('cat.jpg')
+    => <#ChunkyBaconfile::FileInfo content_type="image/jpg" description="" file_url="http://s3.amazonaws.com:80/pengwynn.baconfile.com/cat.jpg" id="763e5559987f22aa710fdbd3bac0fc40" is_folder=false name="cat.jpg" path="pengwynn/cat.jpg" permalink="http://baconfile.com/pengwynn/cat.jpg/" size=39368 time_modified=1262884937 tiny_url="http://tinyb.cn/1qz" type="image" url="/pengwynn/cat.jpg/" user=<#Hashie::Mash id=947 timezone="America/Chicago" username="pengwynn">>
+    
+    # Get the most recent public files
+    >> ChunkyBaconfile.public
+    
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2010 [Wynn Netherland](http://wynnnetherland.com). See LICENSE for details.

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "chunky_baconfile"
+    gem.summary = %Q{Tasty wrapper for the Baconfile API}
+    gem.description = %Q{Tasty wrapper for the Baconfile API}
+    gem.email = "wynn.netherland@gmail.com"
+    gem.homepage = "http://github.com/pengwynn/chunky-baconfile"
+    gem.authors = ["Wynn Netherland"]
+    
+    gem.add_dependency('hashie', '~> 0.1.3')
+    gem.add_dependency('httparty', '~> 0.4.5')
+
+    gem.add_development_dependency('shoulda', '>= 2.10.1')
+    gem.add_development_dependency('jnunemaker-matchy', '0.4.0')
+    gem.add_development_dependency('mocha', '0.9.4')
+    gem.add_development_dependency('fakeweb', '>= 1.2.5')
+    gem.add_development_dependency "yard", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/changelog.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0 - January 7, 2009
+
+  * Initial release

data/lib/chunky_baconfile.rb

@@ -0,0 +1,24 @@
+require 'rubygems'
+require 'cgi'
+
+gem 'hashie', '~> 0.1.3'
+require 'hashie'
+
+gem 'httparty', '~> 0.4.5'
+require 'httparty'
+
+module ChunkyBaconfile
+  
+  # Fetch the latest public files
+  #
+  # @return [Array<FileInfo>] returns last 20 most recent public files
+  def self.public
+    ChunkyBaconfile::Client.new.public
+  end
+end
+
+Hash.send :include, Hashie::HashExtensions
+
+directory = File.expand_path(File.dirname(__FILE__))
+require File.join(directory, 'chunky_baconfile', 'file_info')
+require File.join(directory, 'chunky_baconfile', 'client')

data/lib/chunky_baconfile/client.rb

@@ -0,0 +1,121 @@
+module ChunkyBaconfile
+  class Client
+    attr_accessor :username
+    include HTTParty
+    format :json
+    base_uri "http://baconfile.com"
+
+    # Intialize the client
+    #
+    # @param [optional, String] username your Baconfile username
+    # @param [optional, String] password your Baconfile password
+    # @return the client
+    def initialize(username=nil, password=nil)
+      @username = username
+      @auth = {:username => username, :password => password}
+    end
+
+    # Fetch the files in a folder
+    #
+    # @param [String] folder_name the name of the folder
+    # @return [Array<FileInfo>] the items in the folder
+    def folder(folder_name)
+      response = self.class.get("/#{@username}/#{folder_name}.json")
+      response['items'].map {|item| ChunkyBaconfile::FileInfo.new(item)}
+    end
+
+    # Fetch info about an item
+    #
+    # @param [String] folder_name the name of the folder
+    # @param [String] file_name the name of the file
+    # @return [FileInfo] the items in the folder
+    def file(folder_name, file_name)
+      ChunkyBaconfile::FileInfo.new(self.class.get("/#{@username}/#{folder_name}/#{file_name}.json"))
+    end
+    
+    # Fetch the latest public files
+    #
+    # @return [Array<FileInfo>] returns last 20 most recent public files
+    def public
+      response = self.class.get("/public.json")
+      response['items'].map {|item| ChunkyBaconfile::FileInfo.new(item)}
+    end
+    
+    # Create a new folder
+    #
+    # @param [String] folder_name the name of the folder to create
+    # @return [FileInfo] info about the new folder
+    def create_folder(folder_name)
+      ChunkyBaconfile::FileInfo.new(self.class.post("/#{@username}.json", :body => {:name => folder_name}, :basic_auth => @auth))
+    end
+    
+    # Upload a new file
+    #
+    # @param [String, File] path or file object to upload
+    # @return [FileInfo] info about the new folder
+    def upload_file(file)
+      file = File.new(file) if file.is_a?(String)
+      body_options = {:file => file}
+      opts = build_multipart_bodies(body_options).merge({:basic_auth => @auth})
+      ChunkyBaconfile::FileInfo.new(self.class.post("/#{@username}.json", opts))
+    end
+    
+    # Delete a folder or file
+    #
+    # @param [String] name the folder or file to delete
+    # @return [Hashie::Mash] :success or :error 
+    def delete(name)
+      response = Hashie::Mash.new(self.class.delete("/#{username}/#{name}.json", :basic_auth => @auth))
+    end
+    
+    # Verify credentials
+    #
+    # @return [true, false] whether or not the credentials are a match
+    def verify
+      response = Hashie::Mash.new(self.class.get("/verify.json", :basic_auth => @auth))
+      response.key?(:user)
+    end
+    
+    # Return the MIME type for a file
+    #
+    # @param [File] file
+    # @return [String] mime type for the file
+    def mime_type(file)
+      case 
+        when file =~ /\.jpg/ then 'image/jpg'
+        when file =~ /\.gif$/ then 'image/gif'
+        when file =~ /\.png$/ then 'image/png'
+        else 'application/octet-stream'
+      end
+    end
+    
+  
+    # Build multi-part POST form data from file
+    #
+    # @param [Hash] parts keys/values of items to convert for upload
+    # @return [Hash] encoded form data for POST
+    def build_multipart_bodies(parts)
+      boundary = Time.now.to_i.to_s(16)
+      body = ""
+      parts.each do |key, value|
+        esc_key = CGI.escape(key.to_s)
+        body << "--#{boundary}#{"\r\n"}"
+        if value.respond_to?(:read)
+          body << "Content-Disposition: form-data; name=\"#{esc_key}\"; filename=\"#{File.basename(value.path)}\"#{"\r\n"}"
+          body << "Content-Type: #{mime_type(value.path)}#{"\r\n"*2}"
+          body << value.read
+        else
+          body << "Content-Disposition: form-data; name=\"#{esc_key}\"#{"\r\n"*2}#{value}"
+        end
+        body << "\r\n"
+      end
+      body << "--#{boundary}--#{"\r\n"*2}"
+      {
+        :body => body,
+        :headers => {"Content-Type" => "multipart/form-data; boundary=#{boundary}"}
+      }
+    end
+
+
+  end
+end

data/lib/chunky_baconfile/file_info.rb

@@ -0,0 +1,19 @@
+module ChunkyBaconfile
+  class FileInfo < Hashie::Mash
+    def size
+      self[:size]
+    end
+    
+    def time_modified
+      Time.at(self[:time_modified])
+    end
+    
+    def type
+      self[:type]
+    end
+    
+    def image?
+      self.type == 'image'
+    end
+  end
+end

data/test/fixtures/bacon.json

@@ -0,0 +1,242 @@
+{
+    "items": [{
+        "size": 84295,
+        "permalink": "http://baconfile.com/leah/bacon/bacon-comic.gif/",
+        "name": "bacon-comic.gif",
+        "url": "/leah/bacon/bacon-comic.gif/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fbacon-comic.gif",
+        "time_modified": 1236039382,
+        "tiny_url": "http://tinyb.cn/3k",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/bacon-comic.gif",
+        "content_type": "image/gif",
+        "type": "image",
+        "id": "cd76f62baed8aa467a3f6d128c26a2b3",
+        "description": ""
+    },
+    {
+        "size": 13561,
+        "permalink": "http://baconfile.com/leah/bacon/bacon-success.gif/",
+        "name": "bacon-success.gif",
+        "url": "/leah/bacon/bacon-success.gif/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fbacon-success.gif",
+        "time_modified": 1236039530,
+        "tiny_url": "http://tinyb.cn/3l",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/bacon-success.gif",
+        "content_type": "image/gif",
+        "type": "image",
+        "id": "e44464592a11d810f74f98cc740f4962",
+        "description": ""
+    },
+    {
+        "size": 42736,
+        "permalink": "http://baconfile.com/leah/bacon/batteries-included.png/",
+        "name": "batteries-included.png",
+        "url": "/leah/bacon/batteries-included.png/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fbatteries-included.png",
+        "time_modified": 1236040250,
+        "tiny_url": "http://tinyb.cn/3m",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/batteries-included.png",
+        "content_type": "image/png",
+        "type": "image",
+        "id": "c325ae4e6319be2d386ea04e0a860cc5",
+        "description": ""
+    },
+    {
+        "size": 7048,
+        "permalink": "http://baconfile.com/leah/bacon/chunky-bacon-1.png/",
+        "name": "chunky-bacon-1.png",
+        "url": "/leah/bacon/chunky-bacon-1.png/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fchunky-bacon-1.png",
+        "time_modified": 1236040263,
+        "tiny_url": "http://tinyb.cn/3n",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/chunky-bacon-1.png",
+        "content_type": "image/png",
+        "type": "image",
+        "id": "9c1178f215c9a3fde07a3310989f126c",
+        "description": ""
+    },
+    {
+        "size": 7121,
+        "permalink": "http://baconfile.com/leah/bacon/chunky-bacon-2.png/",
+        "name": "chunky-bacon-2.png",
+        "url": "/leah/bacon/chunky-bacon-2.png/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fchunky-bacon-2.png",
+        "time_modified": 1236040273,
+        "tiny_url": "http://tinyb.cn/3o",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/chunky-bacon-2.png",
+        "content_type": "image/png",
+        "type": "image",
+        "id": "78934cb2815d94663167cc036ba56e5c",
+        "description": ""
+    },
+    {
+        "size": 11179,
+        "permalink": "http://baconfile.com/leah/bacon/chunky-bacon-3.png/",
+        "name": "chunky-bacon-3.png",
+        "url": "/leah/bacon/chunky-bacon-3.png/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fchunky-bacon-3.png",
+        "time_modified": 1236040283,
+        "tiny_url": "http://tinyb.cn/3p",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/chunky-bacon-3.png",
+        "content_type": "image/png",
+        "type": "image",
+        "id": "bc7077caa361f118ed0271c961b7ff59",
+        "description": ""
+    },
+    {
+        "size": 8928,
+        "permalink": "http://baconfile.com/leah/bacon/chunky-bacon-4.png/",
+        "name": "chunky-bacon-4.png",
+        "url": "/leah/bacon/chunky-bacon-4.png/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fchunky-bacon-4.png",
+        "time_modified": 1236040294,
+        "tiny_url": "http://tinyb.cn/3q",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/chunky-bacon-4.png",
+        "content_type": "image/png",
+        "type": "image",
+        "id": "be4a9ddcc1108996eca0fbd6318e0f8c",
+        "description": ""
+    },
+    {
+        "size": 8974,
+        "permalink": "http://baconfile.com/leah/bacon/chunky-bacon-5.png/",
+        "name": "chunky-bacon-5.png",
+        "url": "/leah/bacon/chunky-bacon-5.png/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fchunky-bacon-5.png",
+        "time_modified": 1236040302,
+        "tiny_url": "http://tinyb.cn/3r",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/chunky-bacon-5.png",
+        "content_type": "image/png",
+        "type": "image",
+        "id": "13235ca0849915fefb5ed8ef42a179f0",
+        "description": ""
+    },
+    {
+        "size": 46692,
+        "permalink": "http://baconfile.com/leah/bacon/diet-coke-bacon.jpg/",
+        "name": "diet-coke-bacon.jpg",
+        "url": "/leah/bacon/diet-coke-bacon.jpg/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fdiet-coke-bacon.jpg",
+        "time_modified": 1236040324,
+        "tiny_url": "http://tinyb.cn/3s",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/diet-coke-bacon.jpg",
+        "content_type": "image/jpeg",
+        "type": "image",
+        "id": "aac27db34704b9f94622b6d9edb78305",
+        "description": "Yum."
+    },
+    {
+        "size": 32925,
+        "permalink": "http://baconfile.com/leah/bacon/donuts-bacon-08.jpg/",
+        "name": "donuts-bacon-08.jpg",
+        "url": "/leah/bacon/donuts-bacon-08.jpg/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fdonuts-bacon-08.jpg",
+        "time_modified": 1236040334,
+        "tiny_url": "http://tinyb.cn/3t",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/donuts-bacon-08.jpg",
+        "content_type": "image/jpeg",
+        "type": "image",
+        "id": "8e33d98269e8f45a331f93d170317f4d",
+        "description": "A winning ticket."
+    },
+    {
+        "size": 25652,
+        "permalink": "http://baconfile.com/leah/bacon/press-button.jpg/",
+        "name": "press-button.jpg",
+        "url": "/leah/bacon/press-button.jpg/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fpress-button.jpg",
+        "time_modified": 1236040641,
+        "tiny_url": "http://tinyb.cn/3u",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/press-button.jpg",
+        "content_type": "image/jpeg",
+        "type": "image",
+        "id": "f4a24d2cb3b13e7dd66566a59967f2c5",
+        "description": ""
+    },
+    {
+        "size": 26067,
+        "permalink": "http://baconfile.com/leah/bacon/stove-ownership.png/",
+        "name": "stove-ownership.png",
+        "url": "/leah/bacon/stove-ownership.png/",
+        "file_url": "http://s3.amazonaws.com:80/leah.baconfile.com/bacon%2Fstove-ownership.png",
+        "time_modified": 1236040649,
+        "tiny_url": "http://tinyb.cn/3v",
+        "user": {
+            "username": "leah",
+            "timezone": "US/Pacific",
+            "id": 2
+        },
+        "is_folder": false,
+        "path": "leah/bacon/stove-ownership.png",
+        "content_type": "image/png",
+        "type": "image",
+        "id": "06b9948a55514eca25c364f90584e25b",
+        "description": "http://xkcd.com/418/"
+    }]
+}