star 0.0.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b343e6748e02e06a6a9d4d0b1af3039c7c4c9923
-  data.tar.gz: bf0bb6f1f49fe70454b3033e2d98dc518a8d1391
+  metadata.gz: d65b0fde4ed074e01ff2192432f6af5e6058be1b
+  data.tar.gz: 488bad2de6d544176508a8ffe88d2821ac96b8df
 SHA512:
-  metadata.gz: 29f623f1999e02bfd72ac846616708b6c980e06c983e048f2c781c949bb5778e2742c1f94c7791d5d894467390e3f15f3ae3f2b1256e0859896a30e495ce810d
-  data.tar.gz: e29295abf3fe060cf227780ed3a327baa53c6e20232708bd0a1e98177a9183de8764e389076fc95be239d58b7720b856839e286af257d79242e80392d0cfa040
+  metadata.gz: 3efd5c969edb847e4d07a6be67e6cb50b96957f8b1d1b9433545fa8ff30d4afe0f5bac345b683b05301c0b351c914aedece904be91869b65c27762c64026bd3c
+  data.tar.gz: 96edc054dd043f85e3c32d8285cc173cef2a6b7e6aaf4007dce5fa07e7cb90157ce3efb6b1a7fa3b8447fa4702192821160c9d61bce2dd9695eb1341f7669916

data/.gitignore

@@ -7,4 +7,4 @@
 /pkg/
 /spec/reports/
 /tmp/
-*.gem
+.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -1,4 +1,7 @@
 language: ruby
 rvm:
-  - 2.2.3
+- 2.2.3
 before_install: gem install bundler -v 1.10.6
+env:
+  matrix:
+  - secure: ZqWedYLyWoAdrXIOfQfP7XXk1iwhM4BOql1tufimM/K8KELAhQHILKLiCodnBeFptUoBQgkIaGKLRxSD+g7epzeCzLZoUV1H9DbGf0wR6dJI0ZJKFJMMKu2GVl13+CLkO2zvGciEXmvL1Vj/kvHtyBRddeeCVZgq5f65YU5rpS+pzl5v1rWia24ikK+uUKxvYxyN+owIN+GpvHAFrJ5vMpppmrlSU5OGO1S2KtaX09OxgTxM7Jo0s1Zls0eAtZMdKqdg8hW8u3I8M4Jyu7DRYdalwgZX5BEnjIpr2xBMwHOskVfuUMOnaH5FMCxUSDKHW5j7priRFayN0m+MlBRvb8u3Z3ZIVQx0Jboy1JbnDlqZCHhqGQvCfUJpJiLVi/V7qqXIUjOzB/abI1bQ3pFROF3SNEK0lEGZgzCiilrRBs5RNA/aOokcKof5DGzY68pbXZ0hAWYJmZzU5zrvmGWna77JRnPS3ueXQF5cq5xUYtOhY36HB5gyKReld9/UORZSPmtInADvtBcFjF7AQzGoReRnJNlhQbPTufJpA9iBVc5vm3h6ZeLhThKhLmZIzm0RcWwf8AHXYhnjZansVdMocjtZd5RLKHJANIEKJe28hZqnJa/uamlKjZqqgc/4hYky7XI38fMY3Bbh2lmWPgikjL75QvhXTVk+z5r4QYNwNsQ=

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+For more information about changelogs, check
+[Keep a Changelog](http://keepachangelog.com) and
+[Vandamme](http://tech-angels.github.io/vandamme).
+
+## 1.0.0 - 2015.10.26
+
+* [FEATURE] Add `Star::File` to write/read files on S3

data/{LICENSE.txt → MIT-LICENSE}

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 claudiob
+Copyright (c) 2015 Fullscreen, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the 'Software'), to deal

data/README.md

@@ -1,41 +1,221 @@
-# Star
+:star2: :star2: Store archives privately on S3 :star2: :star2:
+==============================================================
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/star`. To experiment with that code, run `bin/console` for an interactive prompt.
+Star helps you write Ruby apps that need to store files on S3 and retrieve them with expiring URLs.
 
-TODO: Delete this and the text above, and describe your gem
+The **source code** is available on [GitHub](https://github.com/Fullscreen/star) and the **documentation** on [RubyDoc](http://www.rubydoc.info/github/Fullscreen/star/master/Star/Interface).
 
-## Installation
+[![Build Status](http://img.shields.io/travis/Fullscreen/star/master.svg)](https://travis-ci.org/Fullscreen/star)
+[![Coverage Status](http://img.shields.io/coveralls/Fullscreen/star/master.svg)](https://coveralls.io/r/Fullscreen/star)
+[![Dependency Status](http://img.shields.io/gemnasium/Fullscreen/star.svg)](https://gemnasium.com/Fullscreen/star)
+[![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/star.svg)](https://codeclimate.com/github/Fullscreen/star)
+[![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://www.rubydoc.info/github/Fullscreen/star/master/Star/File)
+[![Gem Version](http://img.shields.io/gem/v/star.svg)](http://rubygems.org/gems/star)
 
-Add this line to your application's Gemfile:
+
+After [configuring your app](#how-to-configure), you can write a file to S3 by running:
+
+```ruby
+  file = Star::File.new
+  file.open{|f| f << "some text to store in a remote file"}
+```
+
+You can successively retrieve the same file from S3 by calling:
 
 ```ruby
-gem 'star'
+  url = file.url
 ```
 
-And then execute:
+This will provide a URL that everyone can access *for the next 30 seconds*.
+
+After 30 seconds, access to the file using that URL [will be denied](http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-signed-urls.html#private-content-overview-choosing-duration).
+
+Why use Star
+============
+
+Star is not the only Ruby library to help developers store archives on S3.
+However, most other libraries are [huge](https://rubygems.org/gems/aws-sdk-core) and [heavy on dependencies](https://github.com/fog/fog/blob/master/fog.gemspec#L50-L100).
+
+Star does one thing, and does it well.
+The codebase is small and there are no runtime dependencies.
+This means less footprint on your app, and code that is easier to read, maintain and upgrade.
 
-    $ bundle
+How to install
+==============
 
-Or install it yourself as:
+To install on your system, run
 
-    $ gem install star
+    gem install star
+
+To use inside a bundled Ruby project, add this line to the Gemfile:
+
+    gem 'star', '~> 1.0'
+
+
+How to use
+==========
+
+To write a file to S3, [configure your app](#how-to-configure), then create a new remote file
+instance:
+
+```ruby
+file = Star::File.new
+```
 
-## Usage
+You can now call any method you would normally use to add content to a
+`File`, for instance:
+
+```ruby
+file.open do |f|
+  f << "append some text"
+  f.write "write some other text"
+  f.writeln "write a line of text"
+end
+```
+
+Once the file is closed, Star will automatically upload it to S3.
+
+To read the same file from S3, get its URL by calling
+
+```ruby
+file.url
+```
+
+By default, this URL will only be publicly available for 30 seconds.
+This is useful to let your users download the file, while preventing them
+from sharing the URL and having other (unauthenticated) users download it.
+
+Options
+-------
+
+When you create a new remote file instance, you can set these options:
+
+* `name`: the file name (defaults to `'attachment'`)
+* `content_type`: the content type for the file (defaults to `'application/octet-stream'`)
+* `folder`: the remote folder where to store the file (defaults to `'attachments'`)
+
+For instance, you can call `File.new` with these options:
+
+```ruby
+Star::File.new name: 'test.csv', content_type: 'text/csv', folder: 'spreadsheets'
+```
 
-TODO: Write usage instructions here
+How to configure
+================
 
-## Development
+In order to use Star you must have an [S3 account](https://aws.amazon.com/s3).
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake false` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+Log into your account to retrieve your access key ID, secret access key and
+bucket name, then add the following code to your app:
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+```ruby
+Star.configure do |config|
+  config.access_key_id = '<YOUR S3 ACCESS KEY ID>'
+  config.secret_access_key = '<YOUR S3 SECRET ACCESS KEY>'
+  config.bucket = '<YOUR S3 BUCKET NAME>'
+end
+```
+
+Make sure that this code is run *before* you use Star.
+For instance, in a Rails app, you can store this code in `config/initializers/star.rb`.
+
+Star also provide two options that you can set in your configuration:
+
+* `duration` specifies how many seconds the expiring URLs should be valid for (default: `30`)
+* `location` specifies the subfolder of your bucket where files should be stored (default: `'/'`)
+* `remote` specifies that files will be stored remotely on S3 (default: `true`)
+
+For instance, your configuration could look like this:
+
+```ruby
+Star.configure do |config|
+  config.access_key_id = '<YOUR S3 ACCESS KEY ID>'
+  config.secret_access_key = '<YOUR S3 SECRET ACCESS KEY>'
+  config.bucket = '<YOUR S3 BUCKET NAME>'
+  config.duration = 60
+  config.location = 'production/uploads'
+end
+```
+
+Configuring with environment variables
+--------------------------------------
+
+As an alternative to the approach above, you can configure your app with
+environment variables. For instance, setting the following variables:
+
+```bash
+export AWS_ACCESS_KEY_ID="<YOUR S3 ACCESS KEY ID>"
+export AWS_SECRET_ACCESS_KEY="<YOUR S3 SECRET ACCESS KEY>"
+export AWS_BUCKET="<YOUR S3 BUCKET NAME>"
+export STAR_DURATION="60"
+export STAR_LOCATION="production/uploads"
+```
+
+is equivalent to configuring your app with the initializer above.
+
+How to store files locally
+==========================
+
+If you set `Star.configuration.remote` to `false`, then your files will be
+stored locally, rather than remotely on S3.
+
+This is very convenient if you use Star in a Rails application.
+By adding the following lines to `config/environments/development.rb`:
+
+```ruby
+Star.configure do |config|
+  config.remote = false
+  config.location = Rails.public_path
+end
+```
+
+all your files will be stored in your `public/` folder while developing.
+In production, your files will still be stored on S3.
+
+Your Rails controller/action that redirects to a file might look like this:
+
+
+```ruby
+if Star.remote?
+  redirect_to file.url
+else
+  send_file file.path, type: file.content_type
+end
+```
+
+How to contribute
+=================
+
+If you find that a method is missing, fork the project, add the missing code,
+write the appropriate tests, then submit a pull request, and it will gladly
+be merged!
+
+In order to test, you need to have access to a S3 account that will be used
+to upload and download test files.
+
+Set the following environment variables to match your S3 account, then run
+`rspec` to run the tests:
+
+```bash
+export STAR_TEST_AWS_ACCESS_KEY_ID="<YOUR TEST S3 ACCESS KEY ID>"
+export STAR_TEST_SECRET_ACCESS_KEY="<YOUR TEST S3 SECRET ACCESS KEY>"
+export STAR_TEST_BUCKET="<YOUR TEST S3 BUCKET NAME>"
+export STAR_TEST_LOCATION="<YOUR TEST S3 FOLDER>"
+```
 
-## Contributing
+How to release new versions
+===========================
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/star. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+If you are a manager of this project, remember to upgrade the [Star gem](http://rubygems.org/gems/star)
+whenever a new feature is added or a bug gets fixed.
 
+Make sure all the tests are passing on [Travis CI](https://travis-ci.org/Fullscreen/star),
+document the changes in CHANGELOG.md and README.md, bump the version, then run
 
-## License
+    rake release
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+Remember that the star gem follows [Semantic Versioning](http://semver.org).
+Any new release that fixes bugs and does not add features should bump the *patch* version (1.0.x).
+Any new release that is fully backward-compatible should bump the *minor* version (1.x.0).
+Any new version that breaks compatibility should bump the *major* version (2.0.0).
 

data/Rakefile

@@ -1 +1,7 @@
 require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+desc 'Run all examples'
+RSpec::Core::RakeTask.new :spec
+
+task default: [:spec]

data/bin/console

@@ -1,14 +1,14 @@
 #!/usr/bin/env ruby
 
-require 'bundler/setup'
-require 'star'
+require "bundler/setup"
+require "star"
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
 
 # (If you use this, don't forget to add pry to your Gemfile!)
-# require 'pry'
+# require "pry"
 # Pry.start
 
-require 'irb'
+require "irb"
 IRB.start

data/lib/star.rb

@@ -1,5 +1,5 @@
-require 'star/version'
+require 'star/config'
+require 'star/file'
 
 module Star
-  # Your code goes here...
 end

data/lib/star/config.rb

@@ -0,0 +1,50 @@
+require 'star/configuration'
+
+module Star
+  # Provides methods to read and write global configuration settings.
+  #
+  # @example Set the API key for a server-only YouTube app:
+  #   Star.configure do |config|
+  #     config.access_key_id = 'ABCDEFGHIJ1234567890'
+  #   end
+  #
+  # Note that Star.configure has precedence over values through with
+  # environment variables (see {Star::Configuration}).
+  #
+  module Config
+    # Yields the global configuration to the given block.
+    #
+    # @example
+    #   Star.configure do |config|
+    #     config.access_key_id = 'ABCDEFGHIJ1234567890'
+    #   end
+    #
+    # @yield [Star::Configuration] The global configuration.
+    def configure
+      yield configuration if block_given?
+    end
+
+    # @return [Boolean] whether files are stored remotely (on S3).
+    def remote?
+      !!configuration.remote
+    end
+
+    # Returns the global {Star::Models::Configuration} object.
+    #
+    # While this method _can_ be used to read and write configuration settings,
+    # it is easier to use {Star::Config#configure} Star.configure}.
+    #
+    # @example
+    #     Star.configuration.access_key_id = 'ABCDEFGHIJ1234567890'
+    #
+    # @return [Star::Configuration] The global configuration.
+    def configuration
+      @configuration ||= Star::Configuration.new
+    end
+  end
+
+  # @note Config is the only module auto-loaded in the Star module,
+  #       in order to have a syntax as easy as Star.configure
+
+  extend Config
+end

data/lib/star/configuration.rb

@@ -0,0 +1,63 @@
+module Star
+  # Provides an object to store global configuration settings.
+  #
+  # This class is typically not used directly, but by calling
+  # {Star::Config#configure Star.configure}, which creates and updates a single
+  # instance of {Star::Configuration}.
+  #
+  # @example Set the API access key id/secret access key for AWS S3:
+  #   Star.configure do |config|
+  #     config.access_key_id = 'ABCDEFGHIJ1234567890'
+  #     config.secret_access_key = 'ABCDEFGHIJ1234567890'
+  #   end
+  #
+  # @see Star::Config for more examples.
+  #
+  # An alternative way to set global configuration settings is by storing
+  # them in the following environment variables:
+  #
+  # * +AWS_ACCESS_KEY_ID+ to store the ACCESS KEY ID
+  # * +AWS_SECRET_ACCESS_KEY+ to store the Client Secret for web/device apps
+  # * +AWS_BUCKET+ to set the name of the S3 bucket
+  # * +STAR_LOCATION+ to set the path for where to upload the file to
+  # * +STAR_DURATION+ to set the time (in seconds) for the URL to exist for
+  # * +STAR_REMOTE+ to store file in the local filesystem and not remotely
+  # In case both methods are used together,
+  # {Star::Config#configure Star.configure} takes precedence.
+  #
+  # @example Set the S3 access key id and secret access key:
+  #   ENV['AWS_ACCESS_KEY_ID'] = 'ABCDEFGHIJ1234567890'
+  #   ENV['AWS_SECRET_ACCESS_KEY'] = 'ABCDEFGHIJ1234567890'
+  #
+  class Configuration
+    # @return [String] the S3 access key ID.
+    attr_accessor :access_key_id
+
+    # @return [String] the S3 secret access key.
+    attr_accessor :secret_access_key
+
+    # @return [String] the name of the S3 bucket.
+    attr_accessor :bucket
+
+    # @return [String] the path where remote files are uploaded to.
+    attr_accessor :location
+
+    # @return [Integer] the number of seconds during which the URL returned by
+    #   calling #url on a remote file is publicly available.
+    attr_accessor :duration
+
+    # @return [Booelan] whether to store files remotely or locally.
+    attr_accessor :remote
+
+    # Initialize the global configuration settings, using the values of
+    # the specified following environment variables by default.
+    def initialize
+      @access_key_id = ENV['AWS_ACCESS_KEY_ID']
+      @secret_access_key = ENV['AWS_SECRET_ACCESS_KEY']
+      @bucket = ENV['AWS_BUCKET']
+      @location = ENV.fetch('STAR_LOCATION', '/')
+      @duration = ENV.fetch('STAR_DURATION', '30').to_i
+      @remote = %w(1 t T true TRUE).include? ENV.fetch('STAR_REMOTE', 't')
+    end
+  end
+end

data/lib/star/file.rb

@@ -0,0 +1,111 @@
+require 'tempfile'
+require 'net/http'
+require 'openssl'
+require 'base64'
+require 'uri'
+
+module Star
+  class File
+    attr_reader :content_type
+
+    def initialize(options = {})
+      @name = options.fetch :name, 'attachment'
+      @content_type = options.fetch :content_type, 'application/octet-stream'
+      @folder = options.fetch :folder, 'attachments'
+    end
+
+    def open
+      Tempfile.open 'tmp_file' do |tmp_file|
+        yield tmp_file
+        tmp_file.flush
+        store tmp_file
+      end
+    end
+
+    def url
+      "https://#{host}/#{bucket}#{remote_path}?#{url_params}"
+    end
+
+    def path
+      [Star.configuration.location, @folder, @name].compact.join('/')
+    end
+
+    def store(tmp_file)
+      Star.remote? ? store_remote(tmp_file) : store_local(tmp_file)
+    end
+
+  private
+
+    def store_remote(tmp_file)
+      timestamp = Time.now.utc.strftime "%a, %d %b %Y %H:%M:%S UTC"
+      signature = sign "PUT\n\n#{@content_type}\n#{timestamp}"
+      ::File.open(tmp_file) do |body|
+        request = put_file body, signature, timestamp
+        response = Net::HTTP.start(host, 443, use_ssl: true) do |http|
+          http.request request
+        end
+        response.error! unless response.is_a? Net::HTTPSuccess
+      end
+      sleep 3 # See https://forums.aws.amazon.com/message.jspa?messageID=370480
+    end
+
+    def store_local(tmp_file)
+      FileUtils.mkdir_p ::File.dirname(path)
+      FileUtils.mv tmp_file.path, path
+    end
+
+    def url_params
+      expires_at = Time.now.to_i + Star.configuration.duration
+      digest = OpenSSL::Digest.new 'sha1'
+      params = "response-content-disposition=attachment"
+      string = "GET\n\n\n#{expires_at}\n/#{bucket}#{remote_path}?#{params}"
+      hmac = OpenSSL::HMAC.digest digest, secret, string
+      code = escape Base64.encode64(hmac)
+
+      "#{params}&AWSAccessKeyId=#{key}&Expires=#{expires_at}&Signature=#{code}"
+    end
+
+    def put_file(body, signature, timestamp)
+      Net::HTTP::Put.new("/#{bucket}#{remote_path}").tap do |request|
+        request.body_stream = body
+        request.initialize_http_header 'Content-Length' => body.size.to_s
+        request.add_field 'Host', host
+        request.add_field 'Date', timestamp
+        request.add_field 'Content-Type', @content_type
+        request.add_field 'Authorization', "AWS #{key}:#{signature}"
+      end
+    end
+
+    def sign(action)
+      digest = OpenSSL::Digest.new 'sha1'
+      string = "#{action}\n/#{bucket}#{remote_path}"
+      Base64.strict_encode64 OpenSSL::HMAC.digest(digest, secret, string)
+    end
+
+    def escape(string)
+      s = {'+' => "%2B", '=' => "%3D", '?' => '%3F', '@' => '%40', '$' => '%24',
+           '&' => '%26', ',' => '%2C', '/' => '%2F', ':' => '%3A', ';' => '%3B'}
+      URI.escape(string.strip).gsub(/./) {|c| s.fetch(c, c)}
+    end
+
+    def host
+      "s3.amazonaws.com"
+    end
+
+    def remote_path
+      URI.escape path
+    end
+
+    def key
+      Star.configuration.access_key_id
+    end
+
+    def secret
+      Star.configuration.secret_access_key
+    end
+
+    def bucket
+      Star.configuration.bucket
+    end
+  end
+end

data/lib/star/version.rb

@@ -1,3 +1,3 @@
 module Star
-  VERSION = '0.0.0'
+  VERSION = '1.0.0'
 end

data/star.gemspec

@@ -6,11 +6,12 @@ require 'star/version'
 Gem::Specification.new do |spec|
   spec.name          = 'star'
   spec.version       = Star::VERSION
-  spec.authors       = ['claudiob']
-  spec.email         = ['claudiob@gmail.com']
-
-  spec.summary       = %q{:star:}
-  spec.description   = %q{:star: :star: :star:}
+  spec.authors       = ['claudiob', 'Jeremy Cohen Hoffing']
+  spec.email         = ['claudiob@gmail.com', 'jcohenhoffing@gmail.com']
+  spec.summary       = %q{Write files to S3, read them with expiring URLs}
+  spec.description   = %q{Star provides a File class to write files to S3
+    as though they were local files, and to retrieve them from S3 with a URL
+    that expires after 30 seconds, so it cannot be shared publicly.}
   spec.homepage      = 'https://github.com/fullscreen/star'
   spec.license       = 'MIT'
 
@@ -21,4 +22,7 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency 'bundler', '~> 1.10'
   spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.3'
+  spec.add_development_dependency 'coveralls', '~> 0.8.2'
+  spec.add_development_dependency 'pry-nav', '~> 0.2.4'
 end

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: star
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 1.0.0
 platform: ruby
 authors:
 - claudiob
+- Jeremy Cohen Hoffing
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-09-11 00:00:00.000000000 Z
+date: 2015-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,23 +39,73 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.0'
-description: ":star: :star: :star:"
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+- !ruby/object:Gem::Dependency
+  name: pry-nav
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.4
+description: |-
+  Star provides a File class to write files to S3
+      as though they were local files, and to retrieve them from S3 with a URL
+      that expires after 30 seconds, so it cannot be shared publicly.
 email:
 - claudiob@gmail.com
+- jcohenhoffing@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
 - ".travis.yml"
-- CODE_OF_CONDUCT.md
+- CHANGELOG.md
 - Gemfile
-- LICENSE.txt
+- MIT-LICENSE
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
 - lib/star.rb
+- lib/star/config.rb
+- lib/star/configuration.rb
+- lib/star/file.rb
 - lib/star/version.rb
 - star.gemspec
 homepage: https://github.com/fullscreen/star
@@ -80,6 +131,5 @@ rubyforge_project:
 rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
-summary: ":star:"
+summary: Write files to S3, read them with expiring URLs
 test_files: []
-has_rdoc: 

data/CODE_OF_CONDUCT.md

@@ -1,13 +0,0 @@
-# Contributor Code of Conduct
-
-As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
-
-We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
-
-Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
-
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
-
-This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)