s3_swf_upload 0.3.2

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+*.swp
+flex_src/bin-debug
+flex_src/bin-release/s3_upload.swf
+flex_src/html-template
+Gemfile.lock

data/CHANGELOG

@@ -0,0 +1,26 @@
+v0.3.1
+
+* 2010-11-15
+* Fixed by yixster: If the startUploading call is made after calling stopUploading, only the first file in the queue is successfully uploaded.
+
+v0.3.0
+
+* 2010-08-27
+* Flash Player 10.1 did not allow ExternalInterface to pass a FileReference object to Javascript
+  So I added a toJavascript function that converts FileReference into simple Objects with only three attributes:
+		- name
+		- size
+		- type
+* Also, S3Queue now has it's own toJavascript function.  The queue that gets passed through to the Javascript now 
+  has a much more meaningful attribute of 'files' instead of 'source'
+
+v0.2.0
+
+* 2010-05-27
+* The flex application in this fork was completely re-written so that there are no flash or flex UI components. 
+	The one exception to that is the browse button, which, for security purposes MUST be flash. 
+	But even then, you get to pass the URLs for images to use for that button!
+
+v0.1.0
+
+* Created by people way smarter than I

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in fluent-plugin-redis.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 [name of plugin creator]
+
+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/Manifest

@@ -0,0 +1,34 @@
+CHANGELOG
+MIT-LICENSE
+Manifest
+README.textile
+Rakefile
+flex_src/bin-release/flex-config.xml
+flex_src/compile
+flex_src/src/Globals.as
+flex_src/src/S3Uploader.as
+flex_src/src/com/adobe/net/MimeTypeMap.as
+flex_src/src/com/elctech/S3UploadOptions.as
+flex_src/src/com/elctech/S3UploadRequest.as
+flex_src/src/com/nathancolgate/s3_swf_upload/BrowseButton.as
+flex_src/src/com/nathancolgate/s3_swf_upload/S3Queue.as
+flex_src/src/com/nathancolgate/s3_swf_upload/S3Signature.as
+flex_src/src/com/nathancolgate/s3_swf_upload/S3Upload.as
+lib/patch/integer.rb
+lib/s3_swf_upload.rb
+lib/s3_swf_upload/railtie.rb
+lib/s3_swf_upload/railties/generators/s3_swf_upload.rb
+lib/s3_swf_upload/railties/generators/uploader/USAGE
+lib/s3_swf_upload/railties/generators/uploader/templates/amazon_s3.yml
+lib/s3_swf_upload/railties/generators/uploader/templates/s3_down_button.gif
+lib/s3_swf_upload/railties/generators/uploader/templates/s3_over_button.gif
+lib/s3_swf_upload/railties/generators/uploader/templates/s3_up_button.gif
+lib/s3_swf_upload/railties/generators/uploader/templates/s3_upload.js
+lib/s3_swf_upload/railties/generators/uploader/templates/s3_upload.swf
+lib/s3_swf_upload/railties/generators/uploader/templates/s3_uploads_controller.rb
+lib/s3_swf_upload/railties/generators/uploader/uploader_generator.rb
+lib/s3_swf_upload/railties/tasks/crossdomain.xml
+lib/s3_swf_upload/s3_config.rb
+lib/s3_swf_upload/signature.rb
+lib/s3_swf_upload/view_helpers.rb
+s3_swf_upload.gemspec

data/README.textile

@@ -0,0 +1,223 @@
+h1. S3SwfUpload Gem For Rails 3
+
+S3SwfUpload allows user to upload a file to S3 directly, so you can save the cost of uploading process in your app server.
+
+The flex application in this fork was completely re-written so that there are no flash or flex UI components.  The one exception to that is the browse button, which, for security purposes MUST be flash. But even then, you get to pass the URLs for images to use for that button!
+
+The goal of this re-write is to put the power to customize this powerful took back in the hands of non-flex-savvy developers.  The look and feel is controlled by CSS, and any behavior is controlled by JavaScript.  Flex only handles the file management portion.  A nice result of this is that the flash file is only 46 kb, down from 288 kb.  If you see any way that this can be done better, please don't hesitate to let me know!
+
+h2. Example
+
+!http://static.nathancolgate.com/images/s3_swf_uploader_screenshot.png!
+
+Watch a video of an example app being built using the gem on "Vimeo":http://vimeo.com/11363680
+
+There is also a demo app running on heroku at "http://s3swfuploader.heroku.com/":http://s3swfuploader.heroku.com/
+
+h2. Usage
+
+1. Edit <code>Gemfile</code> and add this as a gem
+
+<pre><code>gem 's3_swf_upload', :git => 'git://github.com/nathancolgate/s3-swf-upload-plugin'
+</code></pre>
+	
+2. Bundle it!
+
+<pre><code>$ bundle install
+</code></pre>
+
+3. Run the generator
+
+<pre><code>$ rails generate s3_swf_upload:uploader
+</code></pre>
+
+If you are using Rails 3.1, you will need to move the generated s3_upload.js from the public/javascripts directory to the app/assets/javascripts directory.
+	
+4. Configure your amazon parameters via the generated <code>config/amazon_s3.yml</code> file.
+(key and secret can optionally be removed from that file and configured via <code>ENV['AWS_ACCESS_KEY_ID']</code> and <code>ENV['AWS_SECRET_ACCESS_KEY']</code>)
+
+5. Make the bucket
+
+There used to be a rake task for this, but it was removed so that there would be no dependency of aws/s3.
+	
+6. Upload the "crossdomain.xml file":https://github.com/nathancolgate/s3-swf-upload-plugin/blob/master/lib/s3_swf_upload/railties/tasks/crossdomain.xml
+
+There used to be a rake task for this, but it was removed so that there would be no dependency of aws/s3.
+
+Make sure the file is in the root and is publicly readable.
+
+7. Note: you no longer need to edit <code>app/controller/s3_uploads_controller.rb</code>
+
+In my tests in Rails 3, the application was able to correctly handle the requests from the flash object.
+
+This means that your authentication systems can still be used to protect the signature generation.
+
+8. Initialize the SWF object in your view using this handy helper:
+
+<pre><code><%=raw s3_swf_upload_tag %>
+</code></pre>
+
+9. To achieve basic functionality, the only other thing you need is something to call the <code>startUploading</code> function.  For example:
+
+<pre><code><input type="submit" value="Start Uploading" onclick="s3_swf_1_object.startUploading();" />
+</code></pre>
+
+However, you will have no feedback or interface to let you know that anything is actually happening.
+
+10. If you want to customise its behavior, "here's a more complex example":http://gist.github.com/382979 
+
+And the "CSS":http://gist.github.com/383118 to go along.
+
+h2. File Renaming
+
+In my applications I upload all files to _tmp_ folder and then have rails manipulate the file (renaming, resizing, etc). Here's a starting point to give you an idea of what that looks like using Paperclip: 
+
+"How to integrate with Paperclip":http://gist.github.com/575842
+
+I prefer this solution because it allows the application to keep tabs on the files. However, if you are looking for a pure javascript solution, check out some of the forks of this project.
+
+h2. General Parameters
+
+h3. :buttonWidth _(integer = 100)_
+
+h3. :buttonHeight _(integer = 30)_
+
+h3. :flashVersion _(string = '9.0.0')_
+
+h3. :queueSizeLimit _(integer = 100)_
+
+Maximum number of files that can be added to the queue.
+
+h3. :fileSizeLimit _(integer = 524288000)_
+
+Individual file size limit in bytes (default is 512 MB)
+
+h3. :fileTypes _(string = '*.*')_
+
+Something like this also works: <code>'*.jpg;*.gif;*.png;'</code>
+
+h3. :fileTypeDescs _(string = 'All Files')_
+
+Something like this also works: <code>'Image files.'</code>
+
+h3. :selectMultipleFiles _(boolean = true)_
+
+Set this to false if you only want to allow users to pick one file at a time.
+
+h3. :keyPrefix _(string = '')_
+
+String to be prepended to the uploaded file name to make the Amazon S3 key (location in bucket).
+
+h3. :signaturePath _(string = '/s3_uploads.xml')_
+
+Fully qualified path to the controller and action that will serve up the Amazon S3 signature
+
+h3. :swfFilePath _(string = '/flash/s3_upload.swf')_
+
+Fully qualified path to the SWF file (this is the one that does all the work).
+
+h3. :buttonUpPath _(string = '/flash/s3_up_button.gif')_
+
+Fully qualified path to an image to be used as the Browse Button (in the up state).  Image should have same dimensions as the buttonWidth and buttonHeight parameters.
+
+h3. :buttonOverPath _(string = '/flash/s3_over_button.gif')_
+
+Fully qualified path to an image to be used as the Browse Button (in the over state).  Image should have same dimensions as the buttonWidth and buttonHeight parameters.
+
+h3. :buttonDownPath _(string = '/flash/s3_down_button.gif')_
+
+Fully qualified path to an image to be used as the Browse Button (in the down state).  Image should have same dimensions as the buttonWidth and buttonHeight parameters.
+
+h2. Callback Parameters
+
+The real power of this refactoring is that the flex application makes all of the following calls to JavaScript.  What you do with the calls is totally up to you:
+
+* :onFileAdd _(file)_
+* :onFileRemove _(file)_
+* :onFileSizeLimitReached _(file)_
+* :onFileNotInQueue _(file)_
+* :onQueueChange _(queue)_
+* :onQueueSizeLimitReached _(queue)_
+* :onQueueEmpty _(queue)_
+* :onQueueClear _(queue)_
+* :onUploadingStart _()_
+* :onUploadingStop _()_
+* :onUploadingFinish _()_
+* :onSignatureOpen _(file,event)_
+* :onSignatureProgress _(file,progress_event)_
+* :onSignatureSecurityError _(file,security_error_event)_
+* :onSignatureComplete _(file,event)_
+* :onSignatureIOError _(file,io_error_event)_
+* :onSignatureHttpStatus _(file,http_status_event)_
+* :onSignatureXMLError _(file,error_message)_
+* :onUploadError _(upload_options,error)_
+* :onUploadOpen _(upload_options,event)_
+* :onUploadProgress _(upload_options,progress_event)_
+* :onUploadIOError _(upload_options,io_error_event)_
+* :onUploadHttpStatus _(upload_options,http_status_event)_
+* :onUploadSecurityError _(upload_options,security_error_event)_
+* :onUploadComplete _(upload_options,event)_
+
+h2. JavaScript Functions
+
+The following functions can be called on the generated object.  Normally the call looks something like this:
+
+<pre><code>s3_swf_1_object.startUploading();
+</code></pre>
+
+h3. startUploading
+
+Starts the uploading process
+
+h3. stopUploading
+
+Stops the uploading process.  Note: Stopping and restarting the uploading process is buggy.  I'd avoid it.
+
+h3. clearQueue
+
+Clears all files out of the queue.
+
+h3. removeFileFromQueue(integer)
+
+Removes a specific file from the queue.
+
+h2. Will it work with < Rails 3?
+
+You bet.  The Rails 3 specific gem only makes installation and setup easier. Here are some tips for getting this to work with < Rails 3:
+
+* install it as a plugin <code>script/plugin install git://github.com/nathancolgate/s3-swf-upload-plugin.git</code>
+* copy the "template files":http://github.com/nathancolgate/s3-swf-upload-plugin/tree/master/lib/s3_swf_upload/railties/generators/uploader/templates/ into your application (use the "generator":http://github.com/nathancolgate/s3-swf-upload-plugin/blob/master/lib/s3_swf_upload/railties/generators/uploader/uploader_generator.rb as a road map)
+* copy the "view helpers":http://github.com/nathancolgate/s3-swf-upload-plugin/blob/master/lib/s3_swf_upload/view_helpers.rb into your applications <code>/lib</code> directory.
+* add the view helper and integer monkey patch to an initialization file:
+<code>
+  require 'view_helpers'
+  require 'patch/integer'
+</code>
+* load the config file by adding this to the bottom of your environment.rb file: <code>S3SwfUpload::S3Config.load_config</code>
+* replace references to Rails.root or Rails.env in the <code>/vendor/plugins/s3-swf-upload-plugin/lib/s3_swf_upload/s3_config.rb</code> file.
+* comment out the require railties inside <code>/vendor/plugins/s3-swf-upload-plugin/lib/s3_swf_upload.rb</code>
+* you may need to require 's3_swf_upload' and 'aws/s3' in your environment.rb file
+* your route will be map.resources instead of resources.
+
+h2. Known Issues
+
+1. As much as I would like the interface to be 100% HTML, a (legitimate) security feature in Flash does not allow it:
+
+bq. "With Adobe Flash Player 10, the <code>FileReference.browse</code> and <code>FileReference.download</code>  operations may be initiated only through ActionScript that originates from user interaction." - "Adobe TechNote":http://kb2.adobe.com/cps/405/kb405546.html
+
+The next best thing I could come up with was to pass images in as buttons.
+
+-If the <code>startUploading</code> call is made after calling <code>stopUploading</code>, only the first file in the queue is successfully uploaded.-
+
+h2. Kudos
+
+Original plugin is Copyright (c) 2008 elctech, released under the MIT license
+
+Updates to plugin for multiple file uploader are Copyright (c) 2010 PRX, released under the MIT license
+
+Conversion of plugin to gem for rails 3 is Copyright (c) 2010 Nathan Colgate Clark, released under the MIT license
+
+Stripping the flex application of UI and adding callbacks Copyright (c) 2010 Nathan Colgate Clark, released under the MIT license
+
+Thanks to yickster (Nick Merwin) for fixing the stopUploading issue
+

data/Rakefile

@@ -0,0 +1,14 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+require 'echoe'
+
+Echoe.new("s3_swf_upload") do |p|
+  p.author         = "Nathan Colgate"
+  p.email          = "nathan@brandnewbox.com"
+  p.description    = "Rails 3 gem that allows you to upload files directly to S3 from your application using flex for file management, css for presentation, and javascript for behavior."
+  p.url            = "http://github.com/nathancolgate/s3-swf-upload-plugin"
+  p.version       = '0.3.2'
+  p.development_dependencies = []
+  p.ignore_pattern = [".gitignore"]
+end
+