rdropbox 1.0.0

data/.document

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

data/.gitignore

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

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Tim Morgan
+
+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.rdoc

@@ -0,0 +1,84 @@
+= Ruby Dropbox Gem
+
+An easy-to-use third-party interface to the RESTful Dropbox API.
+
+== Tutorial by Example
+
+First things first: Be sure you've gotten a consumer key and secret from
+http://developers.dropbox.com
+
+ # STEP 1: Authorize the user
+ session = Dropbox::Session.new('your_consumer_key', 'your_consumer_secret')
+ puts "Visit #{session.authorize_url} to log in to Dropbox. Hit enter when you have done this."
+ gets
+ session.authorize
+ session.sandbox = true
+
+ # STEP 2: Play!
+ session.upload('testfile.txt')
+ uploaded_file = session.file('testfile.txt')
+ puts uploaded_file.metadata.size
+
+ uploaded_file.move 'new_name.txt'
+ uploaded_file.delete
+
+== Tutorial by Example, Rails Edition
+
+A simple Rails controller that allows a user to first authorize their Dropbox
+account, and then upload a file to their Dropbox.
+
+ class DropboxController < ApplicationController
+   def authorize
+     if params[:oauth_token] then
+       dropbox_session = Dropbox::Session.deserialize(session[:dropbox_session])
+       dropbox_session.authorize(params)
+       session[:dropbox_session] = dropbox_session.serialize # re-serialize the authenticated session
+
+       redirect_to :action => 'upload'
+     else
+       dropbox_session = Dropbox::Session.new('your_consumer_key', 'your_consumer_secret')
+       session[:dropbox_session] = dropbox_session.serialize
+       redirect_to dropbox_session.authorize_url(:oauth_callback => url_for(:action => 'authorize'))
+     end
+   end
+
+   def upload
+     return redirect_to(:action => 'authorize') unless session[:dropbox_session]
+     dropbox_session = Dropbox::Session.deserialize(session[:dropbox_session])
+     return redirect_to(:action => 'authorize') unless dropbox_session.authorized?
+
+     if request.method == :post then
+       dropbox_session.upload params[:file], 'My Uploads', :sandbox => true
+       render :text => 'Uploaded OK'
+     else
+       # display a multipart file field form
+     end
+   end
+ end
+
+== Features and Where to Find Them
+
+* Start with the Dropbox::Session class. The first thing you should do is
+  authenticate your users and that class is how to do it.
+* The Dropbox::API module (attached to the Dropbox::Session class) is the meat
+  and potatoes. Use it to modify a user's Dropbox.
+* The Dropbox::Entry class is a more object-oriented way of manipulating files.
+  It's totally optional; check it out if you like OOP.
+* The Dropbox::Memoization module has some handy utility methods for memoizing
+  server responses to reduce network calls. It's plug-in compatible with any
+  caching strategy you might already have (memcache, etc.).
+
+== 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) 2009 Tim Morgan. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "rdropbox"
+    gem.version = File.read("VERSION").chomp.strip
+    gem.summary = %Q{Ruby client library for the official Dropbox API}
+    gem.description = %Q{An easy-to-use client library for the official Dropbox API.}
+    gem.email = "dropbox@timothymorgan.info"
+    gem.homepage = "http://github.com/RISCfuture/dropbox"
+    gem.authors = ["Tim Morgan"]
+
+    gem.files += FileList["lib/dropbox/*.rb"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.add_runtime_dependency "oauth", ">= 0.3.6"
+    gem.add_runtime_dependency "json", ">= 1.2.0"
+    gem.add_runtime_dependency "multipart-post", ">= 1.0"
+
+    gem.rubyforge_project = "dropbox"
+  end
+  Jeweler::GemcutterTasks.new
+  Jeweler::RubyforgeTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION').chomp.strip : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "Dropbox API Client #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('LICENSE')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/dropbox.gemspec

@@ -0,0 +1,87 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{dropbox}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tim Morgan"]
+  s.date = %q{2010-05-05}
+  s.description = %q{An easy-to-use interface to the RESTful Dropbox API.}
+  s.email = %q{dropbox@timothymorgan.info}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "dropbox.gemspec",
+     "lib/dropbox.rb",
+     "lib/dropbox/api.rb",
+     "lib/dropbox/entry.rb",
+     "lib/dropbox/event.rb",
+     "lib/dropbox/memoization.rb",
+     "lib/dropbox/revision.rb",
+     "lib/dropbox/session.rb",
+     "lib/extensions/array.rb",
+     "lib/extensions/hash.rb",
+     "lib/extensions/module.rb",
+     "lib/extensions/object.rb",
+     "lib/extensions/string.rb",
+     "lib/extensions/to_bool.rb",
+     "spec/dropbox/api_spec.rb",
+     "spec/dropbox/entry_spec.rb",
+     "spec/dropbox/event_spec.rb",
+     "spec/dropbox/revision_spec.rb",
+     "spec/dropbox/session_spec.rb",
+     "spec/dropbox_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/RISCfuture/dropbox}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{dropbox}
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Ruby Dropbox interface}
+  s.test_files = [
+    "spec/dropbox/api_spec.rb",
+     "spec/dropbox/entry_spec.rb",
+     "spec/dropbox/event_spec.rb",
+     "spec/dropbox/revision_spec.rb",
+     "spec/dropbox/session_spec.rb",
+     "spec/dropbox_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_runtime_dependency(%q<oauth>, [">= 0.3.6"])
+      s.add_runtime_dependency(%q<json>, [">= 1.2.0"])
+      s.add_runtime_dependency(%q<multipart-post>, [">= 1.0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+      s.add_dependency(%q<oauth>, [">= 0.3.6"])
+      s.add_dependency(%q<json>, [">= 1.2.0"])
+      s.add_dependency(%q<multipart-post>, [">= 1.0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    s.add_dependency(%q<oauth>, [">= 0.3.6"])
+    s.add_dependency(%q<json>, [">= 1.2.0"])
+    s.add_dependency(%q<multipart-post>, [">= 1.0"])
+  end
+end
+