morning_glory 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 [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/README.textile

@@ -0,0 +1,106 @@
+h1. Morning Glory
+
+Morning Glory is comprised of a rake task and helper methods that manages the deployment of static assets into an Amazon CloudFront CDN's S3 Bucket, improving the performance of static assets on your Rails web applications.
+
+_NOTE: You will require an Amazon Web Services (AWS) account in order to use this gem. Specially: S3 for storing the files you wish to distribute, and CloudFront for CDN distribution of those files._     
+
+This version of Morning Glory works with Rails 3.x and Ruby 1.9.x
+
+h2. What does it do?
+
+Morning Glory provides an easy way to deploy Ruby on Rails application assets to the Amazon CloudFront CDN. 
+
+It solves a number of common issues with S3/CloudFront. For instance, CloudFront won't automatically expire old assets stored on edge nodes when you redeploy new assets (the Cloudfront expiry time is 24 hours minimum). 
+To fix this Morning Glory will automatically namespace asset releases for you, then update all references to those renamed assets within your stylesheets ensuring there are no broken asset links.
+
+It also provides a helper method to rewrite all standard Rails asset helper generated URLs to your CloudFront CDN distributions, as well as handling switching between HTTP and HTTPS.
+
+Morning Glory was also built with SASS (Syntactically Awesome Stylesheets) in mind. If you use Sass for your stylesheets they will automatically be built before deployment to the CDN. See http://sass-lang.com/ for more information on Sass.s
+
+h2. What it doesn't do
+
+Morning Glory cannot configure your CloudFront distributions for you automatically. You will manually have to login to your AWS Management Console account, "https://console.aws.amazon.com/cloudfront/home":https://console.aws.amazon.com/cloudfront/home, and set up a distribution pointing to an S3 Bucket.
+
+h2. Installation
+
+<pre>
+gem 'morning_glory'
+</pre>
+
+h2. Usage
+
+Morning Glory provides it's functionality via rake tasks. You'll need to specify the target rails environment configuration you want to deploy for by using the @RAILS_ENV={env}@ parameter (for example, @RAILS_ENV=production@).
+
+<pre>
+rake morning_glory:cloudfront:deploy RAILS_ENV={YOUR_TARGET_ENVIRONMENT}
+</pre>
+
+h2. Configuration
+
+h3. The Morning Glory configuration file, @config/morning_glory.yml@
+
+You can specify a configuration section for every rails environment (production, staging, testing, development). This section can have the following properties defined:
+
+<pre>
+--- 
+production: 
+  enabled: true                     # Is MorningGlory enabled for this environment?
+  bucket: cdn.production.foo.com    # The bucket to deploy your assets into
+  s3_logging_enabled: true          # Log the deployment to S3
+  revision: "20100317134627"        # The revision prefix. This timestamp automatically generateed on deployment
+  delete_prev_rev: true             # Delete the previous asset release (save on S3 storage space)
+</pre>
+
+h3. The Amazon S3 authentication keys configuration file, @config/s3.yml@
+
+This file provides the access credentials for your Amazon AWS S3 account.
+You can configure keys for all your environments (production, staging, testing, development).
+
+<pre>
+---
+production:
+  access_key_id: YOUR_ACCESS_KEY
+  secret_access_key: YOUR_SECRET_ACCESS_KEY
+</pre>
+
+Note: If you are deploying your system to Heroku, you can configure your Amazon AWS S3 information with the environment variables S3_KEY and S3_SECRET instead of using a configuration file. 
+
+h3. Set up an asset_host
+
+For each environment that you'd like to utilise the CloudFront CDN for you'll need to define the asset_host within the @config/environments/{ENVIRONMENT}.rb@ configuration file.
+
+As of June 2010 AWS supports HTTPS requests on the CloudFront CDN, so you no longer have to worry about switching servers. (Yay!)
+
+h4. Example config/environments/production.rb @asset_host@ snippet:
+
+Here we're targeting a CNAME domain with HTTP support.
+
+<pre>
+ActionController::Base.asset_host = Proc.new { |source, request|
+  if request.ssl?
+    "#{request.protocol}#{request.host_with_port}"
+  else
+    "#{request.protocol}assets.example.com"
+  end
+}
+</pre>
+
+
+h3. Why do we have to use a revision-number/namespace/timestamp?
+
+Once an asset has been deployed to the Amazon Cloudfront edge servers it cannot be modified - the version exists until it expires (minimum of 24 hours).
+
+To get around this we need to prefix the asset path with a revision of some sort - in MorningGlory's case we use a timestamp. That way you can deploy many times during a 24 hour period and always have your latest revision available on your web site.
+
+h2. Dependencies
+
+h3. AWS S3
+
+Required for uploading the assets to the Amazon Web Services S3 buckets.
+See "http://amazon.rubyforge.org/":http://amazon.rubyforge.org/ for more documentation on installation.
+
+h2. About the name
+
+Perhaps not what you'd expect; a "Morning Glory":http://en.wikipedia.org/wiki/Morning_Glory_cloud is a rare cloud formation observed by glider pilots in Australia (see my side project, "YourFlightLog.com for flight-logging software for paraglider and hang-glider pilots":http://www.yourflightlog.com, from which the Morning Glory plugin was originally extracted).
+
+Copyright (c) 2010 "@AdamBurmister":http://twitter.com/adamburmister/, released under the MIT license

data/Rakefile

@@ -0,0 +1,25 @@
+require 'rubygems'  
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the morning_glory plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the morning_glory plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Morning Glory'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/init.rb

@@ -0,0 +1,4 @@
+require 'morning_glory'
+
+# Setup the prefix
+require 'asset_tag_helper' if MORNING_GLORY_CONFIG[Rails.env]['enabled'] == true

data/install.rb

@@ -0,0 +1,48 @@
+# Installation instructions
+puts '=' * 80
+puts <<EOF
+
+MORNING GLORY CONFIG
+
+See the github wiki for more detailed configuration information at:
+http://wiki.github.com/adamburmister/morning_glory/
+
+= Morning Glory =
+You will need to manually create & configure your config/morning_glory.yml file.
+Sample config/morning_glory.yml:
+
+  --- 
+  production: 
+    delete_prev_rev: true
+    bucket: cdn.production.yoursite.com
+    s3_logging_enabled: true
+    enabled: true
+    asset_directories: 
+    - images
+    - javascripts
+    - stylesheets
+    revision: "20100316165112"
+  staging: 
+    bucket: cdn.staging.yoursite.com
+    enabled: true
+  testing: 
+    enabled: false
+  development: 
+    enabled: false
+
+
+= Amazon AWS =
+You will need to manually create & configure your config/s3.yml file.
+This file contains your access credentials for accessing the Amazon S3 service.
+Sample config/s3.yml:
+
+  ---
+  production:
+    access_key_id: YOUR_ACCESS_KEY
+    secret_access_key: YOUR_SECRET_ACCESS_KEY
+  staging:
+    access_key_id: YOUR_ACCESS_KEY
+    secret_access_key: YOUR_SECRET_ACCESS_KEY
+
+EOF
+puts '=' * 80

data/lib/asset_tag_helper.rb

@@ -0,0 +1,27 @@
+require 'action_view/helpers/asset_tag_helper'
+
+module ActionView::Helpers::AssetTagHelper
+
+  def rewrite_asset_path(source, path = nil)
+    if path && path.respond_to?(:call)
+      return path.call(source)
+    elsif path && path.is_a?(String)
+      return path % [source]
+    end
+
+    asset_id = rails_asset_id(source)
+    if asset_id.blank?
+      source
+    else
+     # AB: As of June AWS Cloudfront supports HTTPS requests. This alternative code path should now be redundant.
+      # # If the request isn't SSL, or if the request is SSL and the SSL host is set
+      # if !request.ssl? || (request.ssl? && !AssetHostingWithMinimumSsl::asset_ssl_host.empty?)
+      #   File.join('/', ENV['RAILS_ASSET_ID'], source)
+      # else
+      #   source + "?#{asset_id}"
+      # end
+      File.join('/', ENV['RAILS_ASSET_ID'], source)
+    end
+  end
+
+end

data/lib/morning_glory.rb

@@ -0,0 +1,27 @@
+# Prefix files with a revision to bust the cloudfront non-expiring cache. For instance, /REV_1234/myfile.png
+CLOUDFRONT_REVISION_PREFIX = 'REV_'
+
+module MorningGlory
+  # Nothing
+end
+
+begin
+  MORNING_GLORY_CONFIG = YAML.load_file("#{RAILS_ROOT}/config/morning_glory.yml") if !defined? MORNING_GLORY_CONFIG
+rescue
+  raise "Error loading MorningGlory configuration files. Please check config/morning_glory.yml is configured correctly."
+end
+
+begin
+  if (!ENV['S3_KEY'] && !ENV['S3_SECRET'])   
+    S3_CONFIG = YAML.load_file("#{RAILS_ROOT}/config/s3.yml")[Rails.env] if !defined? S3_CONFIG
+  end
+  
+rescue
+  raise "Error loading MorningGlory configuration files. Please check config/s3.yml is configured correctly."
+end
+
+if defined? MORNING_GLORY_CONFIG
+  if MORNING_GLORY_CONFIG[Rails.env]['enabled'] == true
+    ENV['RAILS_ASSET_ID'] = CLOUDFRONT_REVISION_PREFIX + MORNING_GLORY_CONFIG[Rails.env]['revision'].to_s
+  end
+end

data/lib/tasks/morning_glory.rake

@@ -0,0 +1,188 @@
+require File.dirname(__FILE__) + "/../morning_glory"
+
+namespace :morning_glory do
+  namespace :cloudfront do
+
+    @@prev_cdn_revision = nil
+    @@scm_commit_required = false
+    
+    begin
+      MORNING_GLORY_CONFIG = YAML.load_file("#{RAILS_ROOT}/config/morning_glory.yml") if !defined? MORNING_GLORY_CONFIG
+    rescue
+    end
+  
+    def check_config
+      if !defined? MORNING_GLORY_CONFIG[Rails.env] || MORNING_GLORY_CONFIG[Rails.env]['enabled'] != true
+          raise "Deployment appears to be disabled for this environment (#{Rails.env}) within config/morning_glory.yml. Specify an alternative environment with RAILS_ENV={environment name}."
+      end
+      if (!ENV['S3_KEY'] && !ENV['S3_SECRET'])   
+        if !defined? S3_CONFIG[Rails.env]
+          raise "You seem to be lacking your Amazon S3 configuration file, config/s3.yml"
+        end
+      end
+    end
+    
+    def get_revision
+      rev = nil
+
+      # SVN
+      begin
+        svn_rev = `svnversion .`.chomp.gsub(':','_')
+        puts svn_rev
+        if svn_rev != 'exported' && svn_rev != '' && svn_rev != nil
+          rev = Digest::MD5.hexdigest( svn_rev ).to_s
+          puts '* Using SVN revision'
+        end
+      rescue
+        # Ignore
+      end
+      # GIT
+      begin
+        git_rev = `git show --pretty=format:"%H|%ci" --quiet`.split('|')[0]
+        if !git_rev.nil?
+          rev = git_rev.to_s
+          puts '* Using Git revision'
+        end
+      rescue
+        # Ignore
+      end
+            
+      if rev.nil?
+        rev = Time.new.strftime("%Y%m%d%H%M%S") 
+        puts '* Using timestamp revision'
+        @@scm_commit_required = true
+      end
+      
+      return rev
+    end
+
+    def update_revision
+      prev = MORNING_GLORY_CONFIG[Rails.env]['revision'].to_s
+
+      rev = get_revision
+      
+      MORNING_GLORY_CONFIG[Rails.env]['revision'] = rev
+      ENV['RAILS_ASSET_ID'] = CLOUDFRONT_REVISION_PREFIX + rev
+    
+      # Store the previous revision so we can delete the bucket from S3 later after deploy
+      @@prev_cdn_revision = CLOUDFRONT_REVISION_PREFIX + prev
+    
+      File.open("#{RAILS_ROOT}/config/morning_glory.yml", 'w') { |f| YAML.dump(MORNING_GLORY_CONFIG, f) }
+    
+      puts "* CDN revision updated for '#{Rails.env}' environment to #{ENV['RAILS_ASSET_ID']}" 
+    end
+
+    def compile_sass_if_available
+      if defined? Sass
+        puts "* Compiling Sass stylesheets"
+        Sass::Plugin.update_stylesheets
+      end
+    end
+
+    desc "Bump the revision, compile any Sass stylesheets, and deploy assets to S3 and Cloudfront"
+    task :deploy => [:environment] do |t, args|
+      require 'aws/s3'
+      require 'fileutils'
+      
+      puts 'MorningGlory: Starting deployment to the Cloudfront CDN...'
+      
+      check_config
+      
+      update_revision
+
+      compile_sass_if_available
+
+      # Constants
+      SYNC_DIRECTORY  = File.join(Rails.root, 'public')
+      TEMP_DIRECTORY  = File.join(Rails.root, 'tmp', 'morning_glory', 'cloudfront', Rails.env, ENV['RAILS_ASSET_ID']);
+      # Configuration constants
+      BUCKET          = MORNING_GLORY_CONFIG[Rails.env]['bucket'] || Rails.env    
+      DIRECTORIES     = MORNING_GLORY_CONFIG[Rails.env]['asset_directories'] || %w(images javascripts stylesheets)
+      CONTENT_TYPES   = MORNING_GLORY_CONFIG[Rails.env]['content_types'] || {
+                          :jpg => 'image/jpeg',
+                          :png => 'image/png',
+                          :gif => 'image/gif',
+                          :css => 'text/css',
+                          :js  => 'text/javascript'
+                        }
+      S3_LOGGING_ENABLED = MORNING_GLORY_CONFIG[Rails.env]['s3_logging_enabled'] || false
+      DELETE_PREV_REVISION = MORNING_GLORY_CONFIG[Rails.env]['delete_prev_rev'] || false
+      REGEX_ROOT_RELATIVE_CSS_URL = /url\((\'|\")?(\/+.*(#{CONTENT_TYPES.keys.map { |k| '\.' + k.to_s }.join('|')}))\1?\)/
+    
+      # Copy all the assets into the temp directory for processing
+      FileUtils.makedirs TEMP_DIRECTORY if !FileTest::directory?(TEMP_DIRECTORY)
+      puts "* Copying files to working directory for cache-busting-renaming"
+      DIRECTORIES.each do |directory|
+        Dir[File.join(SYNC_DIRECTORY, directory, '**', "*.{#{CONTENT_TYPES.keys.join(',')}}")].each do |file|
+          file_path = file.gsub(/.*public\//, "")
+          temp_file_path = File.join(TEMP_DIRECTORY, file_path)
+
+          FileUtils.makedirs(File.dirname(temp_file_path)) if !FileTest::directory?(File.dirname(temp_file_path))
+        
+          puts " ** Copied to #{temp_file_path}"
+          FileUtils.copy file, temp_file_path
+        end
+      end
+
+      puts "* Replacing image references within CSS files"
+      DIRECTORIES.each do |directory|
+        Dir[File.join(TEMP_DIRECTORY, directory, '**', "*.{css}")].each do |file|
+          puts " ** Renaming image references within #{file}"
+          buffer = File.new(file,'r').read.gsub(REGEX_ROOT_RELATIVE_CSS_URL) { |m| m.insert m.index('(') + ($1 ? 2 : 1), '/'+ENV['RAILS_ASSET_ID'] }
+          File.open(file,'w') {|fw| fw.write(buffer)}
+        end
+      end
+
+      # TODO: Update references within JS files
+    
+      AWS::S3::Base.establish_connection!(
+        :access_key_id     => S3_CONFIG['access_key_id'] || ENV['S3_KEY'],
+        :secret_access_key => S3_CONFIG['secret_access_key'] || ENV['S3_SECRET']
+      )
+
+      begin
+        puts "* Attempting to create S3 Bucket '#{BUCKET}'"
+        AWS::S3::Bucket.create(BUCKET)
+      
+        AWS::S3::Bucket.enable_logging_for(BUCKET) if S3_LOGGING_ENABLED
+
+        puts "* Uploading files to S3 Bucket '#{BUCKET}'"
+        DIRECTORIES.each do |directory|
+          Dir[File.join(TEMP_DIRECTORY, directory, '**', "*.{#{CONTENT_TYPES.keys.join(',')}}")].each do |file|
+            file_path = file.gsub(/.*#{TEMP_DIRECTORY}\//, "")
+            file_path = File.join(ENV['RAILS_ASSET_ID'], file_path)
+            file_ext = file.split(/\./)[-1].to_sym
+          
+            puts " ** Uploading #{BUCKET}/#{file_path}"
+            AWS::S3::S3Object.store(file_path, open(file), BUCKET,
+              :access => :public_read,
+              :content_type => CONTENT_TYPES[file_ext])
+          end
+        end
+
+        # If the configured to delete the prev revision, and the prev revision value was in the YAML (not the blank concat of CLOUDFRONT_REVISION_PREFIX + revision number)
+        if DELETE_PREV_REVISION && @@prev_cdn_revision != CLOUDFRONT_REVISION_PREFIX
+          # TODO: Figure out how to delete from the S3 bucket properly
+          puts "* Deleting previous CDN revision #{BUCKET}/#{@@prev_cdn_revision}"
+          AWS::S3::Bucket.find(BUCKET).objects(:prefix => @@prev_cdn_revision).each do |object|
+            puts " ** Deleting #{BUCKET}/#{object.key}"
+            object.delete
+          end
+        end
+      rescue
+        raise
+      ensure
+        puts "* Deleting temp cache files in #{TEMP_DIRECTORY}"
+        FileUtils.rm_r TEMP_DIRECTORY
+      end
+      
+      puts "MorningGlory: DONE! Your assets have been deployed to the Cloudfront CDN."
+      
+      if @@scm_commit_required == true
+        puts '='*80
+        puts "NB: You will need to commit the /config/morning_glory.yml file and update it on your servers."
+        puts '='*80
+      end
+    end
+  end
+end

data/morning_glory.gemspec

@@ -0,0 +1,20 @@
+Gem::Specification.new do |s|
+  s.name        = 'morning_glory'
+  s.version     = '0.0.1'
+  s.date        = '2011-07-21'
+  s.summary     = "Morning Glory is comprised of a rake task and helper methods that manages the deployment of static assets into an Amazon CloudFront CDN’s S3 Bucket, improving the performance of static assets on your Rails web applications."
+  s.description = File.read(File.join(File.dirname(__FILE__), 'README.textile'))
+  s.platform    = Gem::Platform::RUBY
+  s.required_ruby_version = '>=1.9'
+  s.authors     = ["Adam Burmister", "Todd Sedano"]
+  s.email       = 'professor@gmail.com'
+  s.files	      = Dir['**/**']  
+  s.homepage    = 'https://github.com/professor/morning_glory'
+  s.license = 'MIT'
+  s.add_development_dependency 'aws-s3'
+  s.add_runtime_dependency 'aws-s3'
+#  s.has_rdoc	  = false  
+# s.test_files = Dir["test/test*.rb"]
+# s.executables = [ 'anagram' ]
+
+end

data/rails/init.rb

@@ -0,0 +1,4 @@
+require 'morning_glory'
+
+# Setup the prefix
+require 'asset_tag_helper' if MORNING_GLORY_CONFIG[Rails.env]['enabled'] == true

data/test/morning_glory_test.rb

@@ -0,0 +1,20 @@
+require 'test_helper'
+
+RAILS_ASSET_ID = 'REV_TEST'
+CONTENT_TYPES   = {
+                    :jpg => 'image/jpeg',
+                    :png => 'image/png',
+                    :gif => 'image/gif',
+                    :css => 'text/css',
+                    :js  => 'text/javascript'
+                  }
+REGEX_ROOT_RELATIVE_CSS_URL = /url\((\'|\")?(\/+.*(#{CONTENT_TYPES.keys.map { |k| '\.' + k.to_s }.join('|')}))\1?\).*/
+REPLACEMENT = "url(\1#{RAILS_ASSET_ID}\2\1)"
+
+class MorningGloryTest < ActiveSupport::TestCase
+
+  test "CSS URL replacement" do
+    assert_equals "background: url(/images/test.png)".gsub(REGEX_ROOT_RELATIVE_CSS_URL, REPLACEMENT), ""
+  end 
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'rubygems'
+require 'active_support'
+require 'active_support/test_case'

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,214 @@
+--- !ruby/object:Gem::Specification 
+name: morning_glory
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Adam Burmister
+- Todd Sedano
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-21 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: aws-s3
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: aws-s3
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: |-
+  h1. Morning Glory
+  
+  Morning Glory is comprised of a rake task and helper methods that manages the deployment of static assets into an Amazon CloudFront CDN's S3 Bucket, improving the performance of static assets on your Rails web applications.
+  
+  _NOTE: You will require an Amazon Web Services (AWS) account in order to use this gem. Specially: S3 for storing the files you wish to distribute, and CloudFront for CDN distribution of those files._     
+  
+  This version of Morning Glory works with Rails 3.x and Ruby 1.9.x
+  
+  h2. What does it do?
+  
+  Morning Glory provides an easy way to deploy Ruby on Rails application assets to the Amazon CloudFront CDN. 
+  
+  It solves a number of common issues with S3/CloudFront. For instance, CloudFront won't automatically expire old assets stored on edge nodes when you redeploy new assets (the Cloudfront expiry time is 24 hours minimum). 
+  To fix this Morning Glory will automatically namespace asset releases for you, then update all references to those renamed assets within your stylesheets ensuring there are no broken asset links.
+  
+  It also provides a helper method to rewrite all standard Rails asset helper generated URLs to your CloudFront CDN distributions, as well as handling switching between HTTP and HTTPS.
+  
+  Morning Glory was also built with SASS (Syntactically Awesome Stylesheets) in mind. If you use Sass for your stylesheets they will automatically be built before deployment to the CDN. See http://sass-lang.com/ for more information on Sass.s
+  
+  h2. What it doesn't do
+  
+  Morning Glory cannot configure your CloudFront distributions for you automatically. You will manually have to login to your AWS Management Console account, "https://console.aws.amazon.com/cloudfront/home":https://console.aws.amazon.com/cloudfront/home, and set up a distribution pointing to an S3 Bucket.
+  
+  h2. Installation
+  
+  <pre>
+  gem 'morning_glory'
+  </pre>
+  
+  h2. Usage
+  
+  Morning Glory provides it's functionality via rake tasks. You'll need to specify the target rails environment configuration you want to deploy for by using the @RAILS_ENV={env}@ parameter (for example, @RAILS_ENV=production@).
+  
+  <pre>
+  rake morning_glory:cloudfront:deploy RAILS_ENV={YOUR_TARGET_ENVIRONMENT}
+  </pre>
+  
+  h2. Configuration
+  
+  h3. The Morning Glory configuration file, @config/morning_glory.yml@
+  
+  You can specify a configuration section for every rails environment (production, staging, testing, development). This section can have the following properties defined:
+  
+  <pre>
+  --- 
+  production: 
+    enabled: true                     # Is MorningGlory enabled for this environment?
+    bucket: cdn.production.foo.com    # The bucket to deploy your assets into
+    s3_logging_enabled: true          # Log the deployment to S3
+    revision: "20100317134627"        # The revision prefix. This timestamp automatically generateed on deployment
+    delete_prev_rev: true             # Delete the previous asset release (save on S3 storage space)
+  </pre>
+  
+  h3. The Amazon S3 authentication keys configuration file, @config/s3.yml@
+  
+  This file provides the access credentials for your Amazon AWS S3 account.
+  You can configure keys for all your environments (production, staging, testing, development).
+  
+  <pre>
+  ---
+  production:
+    access_key_id: YOUR_ACCESS_KEY
+    secret_access_key: YOUR_SECRET_ACCESS_KEY
+  </pre>
+  
+  Note: If you are deploying your system to Heroku, you can configure your Amazon AWS S3 information with the environment variables S3_KEY and S3_SECRET instead of using a configuration file. 
+  
+  h3. Set up an asset_host
+  
+  For each environment that you'd like to utilise the CloudFront CDN for you'll need to define the asset_host within the @config/environments/{ENVIRONMENT}.rb@ configuration file.
+  
+  As of June 2010 AWS supports HTTPS requests on the CloudFront CDN, so you no longer have to worry about switching servers. (Yay!)
+  
+  h4. Example config/environments/production.rb @asset_host@ snippet:
+  
+  Here we're targeting a CNAME domain with HTTP support.
+  
+  <pre>
+  ActionController::Base.asset_host = Proc.new { |source, request|
+    if request.ssl?
+      "#{request.protocol}#{request.host_with_port}"
+    else
+      "#{request.protocol}assets.example.com"
+    end
+  }
+  </pre>
+  
+  
+  h3. Why do we have to use a revision-number/namespace/timestamp?
+  
+  Once an asset has been deployed to the Amazon Cloudfront edge servers it cannot be modified - the version exists until it expires (minimum of 24 hours).
+  
+  To get around this we need to prefix the asset path with a revision of some sort - in MorningGlory's case we use a timestamp. That way you can deploy many times during a 24 hour period and always have your latest revision available on your web site.
+  
+  h2. Dependencies
+  
+  h3. AWS S3
+  
+  Required for uploading the assets to the Amazon Web Services S3 buckets.
+  See "http://amazon.rubyforge.org/":http://amazon.rubyforge.org/ for more documentation on installation.
+  
+  h2. About the name
+  
+  Perhaps not what you'd expect; a "Morning Glory":http://en.wikipedia.org/wiki/Morning_Glory_cloud is a rare cloud formation observed by glider pilots in Australia (see my side project, "YourFlightLog.com for flight-logging software for paraglider and hang-glider pilots":http://www.yourflightlog.com, from which the Morning Glory plugin was originally extracted).
+  
+  Copyright (c) 2010 "@AdamBurmister":http://twitter.com/adamburmister/, released under the MIT license
+email: professor@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- init.rb
+- install.rb
+- lib/asset_tag_helper.rb
+- lib/morning_glory.rb
+- lib/tasks/morning_glory.rake
+- MIT-LICENSE
+- morning_glory.gemspec
+- rails/init.rb
+- Rakefile
+- README.textile
+- test/morning_glory_test.rb
+- test/test_helper.rb
+- uninstall.rb
+has_rdoc: true
+homepage: https://github.com/professor/morning_glory
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 29
+      segments: 
+      - 1
+      - 9
+      version: "1.9"
+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: "Morning Glory is comprised of a rake task and helper methods that manages the deployment of static assets into an Amazon CloudFront CDN\xE2\x80\x99s S3 Bucket, improving the performance of static assets on your Rails web applications."
+test_files: []
+