s3share 0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Federico Builes
+
+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.markdown

@@ -0,0 +1,68 @@
+S3Share
+=======
+
+S3Share is a simple script to upload your files to S3 and share them with your friends.
+
+Requirements
+------------
+* Ruby
+* aws-s3 gem
+
+Installation
+------------
+
+You can install from Rubygems
+
+    $ gem install s3share
+
+Or you can download the source and build it manually:
+
+    $ git clone https://febuiles@github.com/febuiles/s3share.git
+    $ rake install
+
+
+Setting ENV variables
+----------------
+You'll need to set the three following ENV variables:
+
+* `AMAZON_ACCESS_KEY_ID`: AWS access key.
+* `AMAZON_SECRET_ACCESS_KEY`: AWS secret access key.
+* `AMAZON_S3_DEFAULT_BUCKET`: Name of the bucket where the uploads will be held.
+
+The last variable is visible in the URL returned to the user: `http://s3.amazonaws.com/{AMAZON_S3_DEFAULT_BUCKET}/some_photo.png`, so make sure you choose something pretty. This value is global for all the S3 namespace, meaning you need to find something unique between all the S3 users ("some-user-name_uploads" should do the trick).
+
+You can set these variables in a `~/.amazon_keys` file:
+
+     export AMAZON_ACCESS_KEY_ID='someaccesskey'
+     export AMAZON_SECRET_ACCESS_KEY='fortyweirdcharacters'
+     export AMAZON_S3_DEFAULT_BUCKET='joesuploads'
+
+And then include it in your `~/.bash_profile`:
+
+     # place at the bottom of your .bash_profile
+     if [[ -f "$HOME/.amazon_keys" ]]; then
+         source "$HOME/.amazon_keys";
+     fi
+
+Usage
+------
+
+    $ s3.rb [file]
+
+An example:
+
+    $ s3.rb kezia.png
+
+      kezia.png uploaded to: http://s3.amazonaws.com/heroin-uploads/kezia.png
+
+By default all the uploaded files will be publicly readable. Once the upload is complete the URL will be copied to your clipboard for easy access.
+
+Bugs/Contact
+------------
+
+Got a problem? Create an issue in the [Github Tracker](https://github.com/febuiles/s3share/issues).
+
+Author
+------
+
+Federico Builes - federico@mheroin.com - @febuiles

data/Rakefile

@@ -0,0 +1 @@
+# Empty Rakefile...

data/bin/s3.rb

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby -rubygems
+
+require "s3share"
+S3Share::Runner.new(*ARGV)

data/lib/s3share/args.rb

@@ -0,0 +1,8 @@
+# Stolen from the Hub gem: https://github.com/defunkt/hub/
+module S3Share
+  class Args < Array
+    def initialize(*args)
+      super
+    end
+  end
+end

data/lib/s3share/runner.rb

@@ -0,0 +1,102 @@
+module S3Share
+  class Runner
+    def initialize(*args)
+      @args = Args.new(args)
+      @filename = args.first
+
+      # Print usage instructions if the filename is empty.
+      if @filename.nil?
+        puts "usage: s3.rb [filename]"
+        exit(-1)
+      end
+
+      @path = get_directory
+      @filename = clean_filename
+
+      # Upload the file and save the URL in the clipboard
+      exit_code = set_clipboard_url(upload_file)
+      exit(exit_code)
+    end
+
+    # The user can specify absolute paths, relative paths and individual
+    # filenames so we need to make sure we return the proper path to the
+    # directory.
+    def get_directory
+      if !@filename.include?("/") # single file name
+        "#{Dir.pwd}"
+      elsif @filename[0,1] == "/" # absolute path
+        "#{@filename.split("/")[0..-2].join("/")}"
+      else                        # relative path
+        "#{Dir.pwd}/#{@filename.split("/")[0..-2].join("/")}"
+      end
+    end
+
+    # Returns only the filename, discarding any directory info.
+    def clean_filename
+      @filename.split("/").last
+    end
+
+
+    # Uploads the file to Amazon S3 and returns the URL for the
+    # object. Uploaded files are publicly readable.
+    def upload_file
+      bucket_name = ENV["AMAZON_S3_DEFAULT_BUCKET"] || ""
+      access_key = ENV["AMAZON_ACCESS_KEY_ID"] || ""
+      secret_key = ENV["AMAZON_SECRET_ACCESS_KEY"] || ""
+
+      if bucket_name.empty?
+        print_error(:no_default_bucket)
+        exit(-2)
+      end
+
+      if access_key.empty? || secret_key.empty?
+        print_error(:wrong_aws_credentials)
+        exit(-3)
+      end
+
+      AWS::S3::Base.establish_connection!(
+        :access_key_id     => access_key,
+        :secret_access_key => secret_key
+      )
+
+      AWS::S3::S3Object.store(@filename, open("#{@path}/#{@filename}"),
+                              bucket_name,
+                              :access => :public_read)
+
+      url = "http://s3.amazonaws.com/#{bucket_name}/#{@filename}"
+      puts "\n #{@filename} uploaded to: #{url}\n\n"
+      url
+    end
+
+    # Saves `url` in the clipboard for easy access. `#clipboard_cmd`
+    # should be extended for other platforms (right now only OS X is
+    # supported).
+    def set_clipboard_url(url)
+      system "echo #{url} | #{clipboard_cmd}"
+    end
+
+    # Returns the name of the command that allows you to pipe stuff
+    # into the clipboard. `pbcopy` for OS X, no idea what it is in
+    # other systems.
+    def clipboard_cmd
+      "pbcopy"
+    end
+
+    # Finds an error by name and prints the associated error string.
+    def print_error(err)
+      errors = {
+        :no_default_bucket =>
+        ["\nENV variable AMAZON_S3_DEFAULT_BUCKET has not been set.",
+         "Please run:",
+         "     export AMAZON_S3_DEFAULT_BUCKET=\"bucket-name\"",
+         "\nRead the documentation for more information.\n\n"],
+        :wrong_aws_credentials =>
+        ["\nAWS credentials are invalid. Make sure that you have set the ENV:",
+         "\n     export AMAZON_ACCESS_KEY_ID=\"your-access-key\"",
+         "     export AMAZON_SECRET_ACCESS_KEY=\"your-secret-key\"",
+         "\nRead the documentation for more information.\n\n"]
+      }
+      errors[err].each { |msg| puts msg }
+    end
+  end
+end

data/lib/s3share/version.rb

@@ -0,0 +1,3 @@
+module S3Share
+  Version = VERSION = '0.1'
+end

data/lib/s3share.rb

@@ -0,0 +1,3 @@
+require "aws/s3"
+require "s3share/args"
+require "s3share/runner"

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: s3share
+version: !ruby/object:Gem::Version 
+  hash: 9
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Federico Builes
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-14 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: |+
+  S3Share allows simple uploads to Amazon S3 from your command line. Set
+  your access ENV variables (see website) and upload the file:
+  
+      $ s3.rb kezia.png
+  
+        kezia.png uploaded to: http://s3.amazonaws.com/heroin-uploads/kezia.png
+  
+email: federico.builes@gmail.com
+executables: 
+- s3.rb
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.markdown
+- Rakefile
+- LICENSE
+- lib/s3share/args.rb
+- lib/s3share/runner.rb
+- lib/s3share/version.rb
+- lib/s3share.rb
+- bin/s3.rb
+has_rdoc: false
+homepage: http://github.com/febuiles/s3share
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Upload your files to S3 and share them with your friends.
+test_files: []
+