fog-dragonfly 0.8.1

data/VERSION

@@ -0,0 +1 @@
+0.8.1

data/config.ru

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'rack/cache'
+require File.dirname(__FILE__) + '/lib/dragonfly'
+
+APP = Dragonfly[:images].configure_with(:imagemagick) do |c|
+end
+
+use Rack::Cache,
+  :verbose     => true,
+  :metastore   => 'file:/var/cache/rack/meta',
+  :entitystore => 'file:/var/cache/rack/body'
+
+run APP

data/docs.watchr

@@ -0,0 +1 @@
+watch('lib/.*\.rb|yard/.*|extra_docs/.*')  {|md| system("rake yard:changed") }

data/dragonfly.gemspec

@@ -0,0 +1,293 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{dragonfly}
+  s.version = "0.8.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Mark Evans"]
+  s.date = %q{2010-11-22}
+  s.email = %q{mark@new-bamboo.co.uk}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+  s.files = [
+    ".specopts",
+    ".yardopts",
+    "Gemfile",
+    "Gemfile.rails.2.3.5",
+    "History.md",
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "config.ru",
+    "docs.watchr",
+    "dragonfly.gemspec",
+    "extra_docs/Analysers.md",
+    "extra_docs/Caching.md",
+    "extra_docs/Configuration.md",
+    "extra_docs/DataStorage.md",
+    "extra_docs/Encoding.md",
+    "extra_docs/GeneralUsage.md",
+    "extra_docs/Generators.md",
+    "extra_docs/Heroku.md",
+    "extra_docs/Index.md",
+    "extra_docs/MimeTypes.md",
+    "extra_docs/Models.md",
+    "extra_docs/Mongo.md",
+    "extra_docs/Processing.md",
+    "extra_docs/Rack.md",
+    "extra_docs/Rails2.md",
+    "extra_docs/Rails3.md",
+    "extra_docs/Sinatra.md",
+    "extra_docs/URLs.md",
+    "features/3.0.3.feature",
+    "features/images.feature",
+    "features/no_processing.feature",
+    "features/rails_2.3.5.feature",
+    "features/steps/common_steps.rb",
+    "features/steps/dragonfly_steps.rb",
+    "features/steps/rails_steps.rb",
+    "features/support/env.rb",
+    "fixtures/files/app/models/album.rb",
+    "fixtures/files/app/views/albums/new.html.erb",
+    "fixtures/files/app/views/albums/show.html.erb",
+    "fixtures/files/config/initializers/dragonfly.rb",
+    "fixtures/files/features/manage_album_images.feature",
+    "fixtures/files/features/step_definitions/image_steps.rb",
+    "fixtures/files/features/support/paths.rb",
+    "fixtures/files/features/text_images.feature",
+    "fixtures/rails_2.3.5/template.rb",
+    "fixtures/rails_3.0.3/template.rb",
+    "irbrc.rb",
+    "lib/dragonfly.rb",
+    "lib/dragonfly/active_model_extensions.rb",
+    "lib/dragonfly/active_model_extensions/attachment.rb",
+    "lib/dragonfly/active_model_extensions/class_methods.rb",
+    "lib/dragonfly/active_model_extensions/instance_methods.rb",
+    "lib/dragonfly/active_model_extensions/validations.rb",
+    "lib/dragonfly/analyser.rb",
+    "lib/dragonfly/analysis/file_command_analyser.rb",
+    "lib/dragonfly/analysis/image_magick_analyser.rb",
+    "lib/dragonfly/analysis/r_magick_analyser.rb",
+    "lib/dragonfly/app.rb",
+    "lib/dragonfly/config/heroku.rb",
+    "lib/dragonfly/config/image_magick.rb",
+    "lib/dragonfly/config/r_magick.rb",
+    "lib/dragonfly/config/rails.rb",
+    "lib/dragonfly/configurable.rb",
+    "lib/dragonfly/core_ext/object.rb",
+    "lib/dragonfly/core_ext/string.rb",
+    "lib/dragonfly/core_ext/symbol.rb",
+    "lib/dragonfly/data_storage.rb",
+    "lib/dragonfly/data_storage/file_data_store.rb",
+    "lib/dragonfly/data_storage/mongo_data_store.rb",
+    "lib/dragonfly/data_storage/s3data_store.rb",
+    "lib/dragonfly/encoder.rb",
+    "lib/dragonfly/encoding/image_magick_encoder.rb",
+    "lib/dragonfly/encoding/r_magick_encoder.rb",
+    "lib/dragonfly/function_manager.rb",
+    "lib/dragonfly/generation/hash_with_css_style_keys.rb",
+    "lib/dragonfly/generation/image_magick_generator.rb",
+    "lib/dragonfly/generation/r_magick_generator.rb",
+    "lib/dragonfly/generator.rb",
+    "lib/dragonfly/image_magick_utils.rb",
+    "lib/dragonfly/job.rb",
+    "lib/dragonfly/job_builder.rb",
+    "lib/dragonfly/job_definitions.rb",
+    "lib/dragonfly/job_endpoint.rb",
+    "lib/dragonfly/loggable.rb",
+    "lib/dragonfly/middleware.rb",
+    "lib/dragonfly/processing/image_magick_processor.rb",
+    "lib/dragonfly/processing/r_magick_processor.rb",
+    "lib/dragonfly/processor.rb",
+    "lib/dragonfly/r_magick_utils.rb",
+    "lib/dragonfly/rails/images.rb",
+    "lib/dragonfly/response.rb",
+    "lib/dragonfly/routed_endpoint.rb",
+    "lib/dragonfly/serializer.rb",
+    "lib/dragonfly/simple_cache.rb",
+    "lib/dragonfly/simple_endpoint.rb",
+    "lib/dragonfly/temp_object.rb",
+    "samples/beach.png",
+    "samples/egg.png",
+    "samples/round.gif",
+    "samples/sample.docx",
+    "samples/taj.jpg",
+    "spec/argument_matchers.rb",
+    "spec/dragonfly/active_model_extensions/active_model_setup.rb",
+    "spec/dragonfly/active_model_extensions/active_record_setup.rb",
+    "spec/dragonfly/active_model_extensions/model_spec.rb",
+    "spec/dragonfly/active_model_extensions/spec_helper.rb",
+    "spec/dragonfly/analyser_spec.rb",
+    "spec/dragonfly/analysis/file_command_analyser_spec.rb",
+    "spec/dragonfly/analysis/image_magick_analyser_spec.rb",
+    "spec/dragonfly/analysis/r_magick_analyser_spec.rb",
+    "spec/dragonfly/analysis/shared_analyser_spec.rb",
+    "spec/dragonfly/app_spec.rb",
+    "spec/dragonfly/config/r_magick_spec.rb",
+    "spec/dragonfly/configurable_spec.rb",
+    "spec/dragonfly/core_ext/string_spec.rb",
+    "spec/dragonfly/core_ext/symbol_spec.rb",
+    "spec/dragonfly/data_storage/data_store_spec.rb",
+    "spec/dragonfly/data_storage/file_data_store_spec.rb",
+    "spec/dragonfly/data_storage/mongo_data_store_spec.rb",
+    "spec/dragonfly/data_storage/s3_data_store_spec.rb",
+    "spec/dragonfly/deprecation_spec.rb",
+    "spec/dragonfly/encoding/image_magick_encoder_spec.rb",
+    "spec/dragonfly/encoding/r_magick_encoder_spec.rb",
+    "spec/dragonfly/function_manager_spec.rb",
+    "spec/dragonfly/generation/hash_with_css_style_keys_spec.rb",
+    "spec/dragonfly/generation/image_magick_generator_spec.rb",
+    "spec/dragonfly/generation/r_magick_generator_spec.rb",
+    "spec/dragonfly/generation/shared_generator_spec.rb",
+    "spec/dragonfly/image_magick_utils_spec.rb",
+    "spec/dragonfly/job_builder_spec.rb",
+    "spec/dragonfly/job_definitions_spec.rb",
+    "spec/dragonfly/job_endpoint_spec.rb",
+    "spec/dragonfly/job_spec.rb",
+    "spec/dragonfly/loggable_spec.rb",
+    "spec/dragonfly/middleware_spec.rb",
+    "spec/dragonfly/processing/image_magick_processor_spec.rb",
+    "spec/dragonfly/processing/r_magick_processor_spec.rb",
+    "spec/dragonfly/processing/shared_processing_spec.rb",
+    "spec/dragonfly/routed_endpoint_spec.rb",
+    "spec/dragonfly/serializer_spec.rb",
+    "spec/dragonfly/simple_cache_spec.rb",
+    "spec/dragonfly/simple_endpoint_spec.rb",
+    "spec/dragonfly/temp_object_spec.rb",
+    "spec/image_matchers.rb",
+    "spec/simple_matchers.rb",
+    "spec/spec_helper.rb",
+    "yard/handlers/configurable_attr_handler.rb",
+    "yard/setup.rb",
+    "yard/templates/default/fulldoc/html/css/common.css",
+    "yard/templates/default/layout/html/layout.erb",
+    "yard/templates/default/module/html/configuration_summary.erb",
+    "yard/templates/default/module/setup.rb"
+  ]
+  s.homepage = %q{http://github.com/markevans/dragonfly}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Dragonfly is an on-the-fly Rack-based image handling framework. It is suitable for use with Rails, Sinatra and other web frameworks. Although it's mainly used for images, it can handle any content type.}
+  s.test_files = [
+    "spec/argument_matchers.rb",
+    "spec/dragonfly/active_model_extensions/active_model_setup.rb",
+    "spec/dragonfly/active_model_extensions/active_record_setup.rb",
+    "spec/dragonfly/active_model_extensions/model_spec.rb",
+    "spec/dragonfly/active_model_extensions/spec_helper.rb",
+    "spec/dragonfly/analyser_spec.rb",
+    "spec/dragonfly/analysis/file_command_analyser_spec.rb",
+    "spec/dragonfly/analysis/image_magick_analyser_spec.rb",
+    "spec/dragonfly/analysis/r_magick_analyser_spec.rb",
+    "spec/dragonfly/analysis/shared_analyser_spec.rb",
+    "spec/dragonfly/app_spec.rb",
+    "spec/dragonfly/config/r_magick_spec.rb",
+    "spec/dragonfly/configurable_spec.rb",
+    "spec/dragonfly/core_ext/string_spec.rb",
+    "spec/dragonfly/core_ext/symbol_spec.rb",
+    "spec/dragonfly/data_storage/data_store_spec.rb",
+    "spec/dragonfly/data_storage/file_data_store_spec.rb",
+    "spec/dragonfly/data_storage/mongo_data_store_spec.rb",
+    "spec/dragonfly/data_storage/s3_data_store_spec.rb",
+    "spec/dragonfly/deprecation_spec.rb",
+    "spec/dragonfly/encoding/image_magick_encoder_spec.rb",
+    "spec/dragonfly/encoding/r_magick_encoder_spec.rb",
+    "spec/dragonfly/function_manager_spec.rb",
+    "spec/dragonfly/generation/hash_with_css_style_keys_spec.rb",
+    "spec/dragonfly/generation/image_magick_generator_spec.rb",
+    "spec/dragonfly/generation/r_magick_generator_spec.rb",
+    "spec/dragonfly/generation/shared_generator_spec.rb",
+    "spec/dragonfly/image_magick_utils_spec.rb",
+    "spec/dragonfly/job_builder_spec.rb",
+    "spec/dragonfly/job_definitions_spec.rb",
+    "spec/dragonfly/job_endpoint_spec.rb",
+    "spec/dragonfly/job_spec.rb",
+    "spec/dragonfly/loggable_spec.rb",
+    "spec/dragonfly/middleware_spec.rb",
+    "spec/dragonfly/processing/image_magick_processor_spec.rb",
+    "spec/dragonfly/processing/r_magick_processor_spec.rb",
+    "spec/dragonfly/processing/shared_processing_spec.rb",
+    "spec/dragonfly/routed_endpoint_spec.rb",
+    "spec/dragonfly/serializer_spec.rb",
+    "spec/dragonfly/simple_cache_spec.rb",
+    "spec/dragonfly/simple_endpoint_spec.rb",
+    "spec/dragonfly/temp_object_spec.rb",
+    "spec/image_matchers.rb",
+    "spec/simple_matchers.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::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<aws-s3>, [">= 0"])
+      s.add_development_dependency(%q<bson_ext>, [">= 0"])
+      s.add_development_dependency(%q<capybara>, [">= 0"])
+      s.add_development_dependency(%q<cucumber>, ["= 0.8.5"])
+      s.add_development_dependency(%q<cucumber-rails>, [">= 0"])
+      s.add_development_dependency(%q<database_cleaner>, [">= 0.5.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.4"])
+      s.add_development_dependency(%q<gherkin>, ["= 2.1.4"])
+      s.add_development_dependency(%q<mongo>, [">= 0"])
+      s.add_development_dependency(%q<nokogiri>, ["= 1.5.0.beta.2"])
+      s.add_development_dependency(%q<rack>, ["~> 1.1"])
+      s.add_development_dependency(%q<rack-cache>, [">= 0"])
+      s.add_development_dependency(%q<rails>, ["= 3.0.3"])
+      s.add_development_dependency(%q<rake>, [">= 0"])
+      s.add_development_dependency(%q<rmagick>, ["= 2.12.2"])
+      s.add_development_dependency(%q<rspec>, ["~> 1.3"])
+      s.add_development_dependency(%q<sqlite3-ruby>, ["= 1.3.0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+      s.add_runtime_dependency(%q<rack>, [">= 0"])
+    else
+      s.add_dependency(%q<aws-s3>, [">= 0"])
+      s.add_dependency(%q<bson_ext>, [">= 0"])
+      s.add_dependency(%q<capybara>, [">= 0"])
+      s.add_dependency(%q<cucumber>, ["= 0.8.5"])
+      s.add_dependency(%q<cucumber-rails>, [">= 0"])
+      s.add_dependency(%q<database_cleaner>, [">= 0.5.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.4"])
+      s.add_dependency(%q<gherkin>, ["= 2.1.4"])
+      s.add_dependency(%q<mongo>, [">= 0"])
+      s.add_dependency(%q<nokogiri>, ["= 1.5.0.beta.2"])
+      s.add_dependency(%q<rack>, ["~> 1.1"])
+      s.add_dependency(%q<rack-cache>, [">= 0"])
+      s.add_dependency(%q<rails>, ["= 3.0.3"])
+      s.add_dependency(%q<rake>, [">= 0"])
+      s.add_dependency(%q<rmagick>, ["= 2.12.2"])
+      s.add_dependency(%q<rspec>, ["~> 1.3"])
+      s.add_dependency(%q<sqlite3-ruby>, ["= 1.3.0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+      s.add_dependency(%q<rack>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<aws-s3>, [">= 0"])
+    s.add_dependency(%q<bson_ext>, [">= 0"])
+    s.add_dependency(%q<capybara>, [">= 0"])
+    s.add_dependency(%q<cucumber>, ["= 0.8.5"])
+    s.add_dependency(%q<cucumber-rails>, [">= 0"])
+    s.add_dependency(%q<database_cleaner>, [">= 0.5.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.4"])
+    s.add_dependency(%q<gherkin>, ["= 2.1.4"])
+    s.add_dependency(%q<mongo>, [">= 0"])
+    s.add_dependency(%q<nokogiri>, ["= 1.5.0.beta.2"])
+    s.add_dependency(%q<rack>, ["~> 1.1"])
+    s.add_dependency(%q<rack-cache>, [">= 0"])
+    s.add_dependency(%q<rails>, ["= 3.0.3"])
+    s.add_dependency(%q<rake>, [">= 0"])
+    s.add_dependency(%q<rmagick>, ["= 2.12.2"])
+    s.add_dependency(%q<rspec>, ["~> 1.3"])
+    s.add_dependency(%q<sqlite3-ruby>, ["= 1.3.0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+    s.add_dependency(%q<rack>, [">= 0"])
+  end
+end
+

data/extra_docs/Analysers.md

@@ -0,0 +1,108 @@
+Analysers
+=========
+
+Analysing data for things like width, mime_type, etc. come under the banner of Analysis.
+
+You can register as many analysers as you like.
+
+Let's say we have a Dragonfly app
+
+    app = Dragonfly[:images]
+
+and an image object (actually a {Dragonfly::Job Job} object)...
+
+    image = app.fetch('some/uid')
+
+...OR a Dragonfly model accessor...
+
+    image = @album.cover_image
+
+We can analyse it using any analysis methods that have been registered with the analyser.
+
+ImageMagickAnalyser
+-------------------
+The {Dragonfly::Analysis::ImageMagickAnalyser ImageMagickAnalyser} is registered by default by the
+{Dragonfly::Config::ImageMagick ImageMagick configuration} used by 'dragonfly/rails/images'.
+
+If not already registered:
+
+    app.analyser.register(Dragonfly::Analysis::ImageMagickAnalyser)
+
+gives us these methods:
+
+    image.width               # => 280
+    image.height              # => 355
+    image.aspect_ratio        # => 0.788732394366197
+    image.portrait?           # => true
+    image.landscape?          # => false
+    image.depth               # => 8
+    image.number_of_colours   # => 34703
+    image.format              # => :png
+
+RMagickAnalyser
+-------------------
+The {Dragonfly::Analysis::RMagickAnalyser RMagickAnalyser} uses the {http://rmagick.rubyforge.org RMagick} library and provides methods `width`, `height`, `aspect_ratio`,
+`portrait?`, `landscape?`, `depth`, `number_of_colours` and `format` like the ImageMagickAnalyser.
+
+You can tell it not to use the file system when registering it
+
+    app.analyser.register(Dragonfly::Analysis::RMagickAnalyser){|a| a.use_filesystem = false }
+
+FileCommandAnalyser
+-------------------
+The {Dragonfly::Analysis::FileCommandAnalyser FileCommandAnalyser} is registered by default by the
+{Dragonfly::Config::Rails Rails configuration} used by 'dragonfly/rails/images'.
+
+As the name suggests, it uses the UNIX 'file' command.
+
+If not already registered:
+
+    app.analyser.register(Dragonfly::Analysis::FileCommandAnalyser)
+
+gives us:
+
+    image.mime_type    # => 'image/png'
+
+It doesn't use the filesystem by default (it operates on in-memory strings), but we can make it do so by using
+
+    app.analyser.register(Dragonfly::Analysis::FileCommandAnalyser) do |a|
+      a.use_filesystem = true
+    end
+
+Custom Analysers
+----------------
+
+To register a single custom analyser:
+
+    app.analyser.add :wobbliness do |temp_object|
+      # can use temp_object.data, temp_object.path, temp_object.file, etc.
+      SomeLibrary.assess_wobbliness(temp_object.data)
+    end
+
+    image.wobbliness    # => 71
+
+You can create a class like the ImageMagick one above, in which case all public methods will be counted as analysis methods.
+Each method takes the temp_object as its argument.
+
+    class MyAnalyser
+
+      def coolness(temp_object)
+        temp_object.size / 30
+      end
+
+      def uglyness(temp_object)
+        `ugly -i #{temp_object.path}`
+      end
+
+      private
+
+      def my_helper_method
+        # do stuff
+      end
+
+    end
+
+    app.analyser.register(MyAnalyser)
+
+    image.coolness    # => -4.1
+    image.uglyness    # => "VERY"

data/extra_docs/Caching.md

@@ -0,0 +1,23 @@
+Caching
+=======
+
+Processing and encoding can be an expensive operation. The first time we visit the url,
+the image is processed, and there might be a short delay and getting the response.
+
+However, dragonfly apps send `Cache-Control` and `ETag` headers in the response, so we can easily put a caching
+proxy like {http://varnish.projects.linpro.no Varnish}, {http://www.squid-cache.org Squid},
+{http://tomayko.com/src/rack-cache/ Rack::Cache}, etc. in front of the app, so that subsequent requests are served
+super-quickly straight out of the cache.
+
+The file 'dragonfly/rails/images' puts Rack::Cache in front of Dragonfly by default, but for better performance
+you may wish to look into something like Varnish.
+
+Given a dragonfly app
+
+    app = Dragonfly[:images]
+
+You can configure the 'Cache-Control' header with
+
+    app.cache_duration = 3600*24*365*3  # time in seconds
+
+For a well-written discussion of Cache-Control and ETag headers, see {http://tomayko.com/writings/things-caches-do}.

data/extra_docs/Configuration.md

@@ -0,0 +1,138 @@
+Configuration
+=============
+
+Given a Dragonfly app
+
+    app = Dragonfly[:app_name]
+
+Configuration can either be done like so...
+
+    app.configure do |c|
+      c.url_path_prefix = '/media'
+      # ...
+    end
+
+...or directly like so...
+
+    app.url_path_prefix = '/media'
+
+The defaults should be fairly sensible, but you can tweak a number of things if you wish.
+Here is an example of an app with all attributes configured:
+
+    app.configure do |c|
+      c.datastore = SomeCustomDataStore.new :egg => 'head'  # defaults to FileDataStore
+
+      c.cache_duration = 3600*24*365*2                      # defaults to 1 year # (1 year)
+      c.fallback_mime_type = 'something/mental'             # defaults to application/octet-stream
+      c.log = Logger.new($stdout)                           # defaults to Logger.new('/var/tmp/dragonfly.log')
+      c.infer_mime_type_from_file_ext = false               # defaults to true
+
+      c.url_path_prefix = '/images'                         # defaults to nil
+      c.url_host = 'http://some.domain.com:4000'            # defaults to nil
+      c.url_suffix = '.jpg'                                 # defaults to nil - has no effect other than change the url
+
+      c.content_filename = proc{|job, request|              # defaults to the original name, with modified ext if encoded
+        "file.#{job.ext}"
+      }
+      c.content_disposition = :attachment                   # defaults to nil (use the browser default)
+
+      c.protect_from_dos_attacks = true                     # defaults to false - adds a SHA parameter on the end of urls
+      c.secret = 'This is my secret yeh!!'                  # should set this if concerned about DOS attacks
+
+      c.analyser.register(MyAnalyser)                       # See 'Analysers' for more details
+      c.processor.register(MyProcessor, :type => :fig)      # See 'Processing' for more details
+      c.encoder.register(MyEncoder) do |e|                  # See 'Encoding' for more details
+        e.some_value = 'geg'
+      end
+      c.generator.register(MyGenerator)                     # See 'Generators' for more details
+
+      c.register_mime_type(:egg, 'fried/egg')               # See 'MimeTypes' for more details
+
+      c.job :black_and_white do |size|                      # Job shortcut - lets you do image.black_and_white('30x30')
+        process :greyscale
+        process :thumb, size
+        encode  :gif
+      end
+    end
+
+Where is configuration done?
+----------------------------
+In Rails, it should be done in an initializer, e.g. 'config/initializers/dragonfly.rb'.
+Otherwise it should be done anywhere where general setup is done, early on.
+
+Saved configurations
+====================
+Saved configurations are useful if you often configure the app the same way.
+There are a number that are provided with Dragonfly:
+
+ImageMagick
+-----------
+
+    app.configure_with(:imagemagick)
+
+The {Dragonfly::Config::ImageMagick ImageMagick configuration} registers the app with the {Dragonfly::Analysis::ImageMagickAnalyser ImageMagickAnalyser}, {Dragonfly::Processing::ImageMagickProcessor ImageMagickProcessor},
+{Dragonfly::Encoding::ImageMagickEncoder ImageMagickEncoder} and {Dragonfly::Generation::ImageMagickGenerator ImageMagickGenerator}, and adds the 'job shortcuts'
+`thumb`, `jpg`, `png`, `gif` and `convert`.
+
+The file 'dragonfly/rails/images' does this for you.
+
+The processor, analyser, encoder and generator pass data around using tempfiles.
+
+RMagick
+-------
+
+    app.configure_with(:rmagick)
+
+The {Dragonfly::Config::RMagick RMagick configuration} registers the app with the {Dragonfly::Analysis::RMagickAnalyser RMagickAnalyser}, {Dragonfly::Processing::RMagickProcessor RMagickProcessor},
+{Dragonfly::Encoding::RMagickEncoder RMagickEncoder} and {Dragonfly::Generation::RMagickGenerator RMagickGenerator}, and adds the 'job shortcuts'
+`thumb`, `jpg`, `png` and `gif`.
+
+By default the processor, analyser, encoder and generator pass data around using tempfiles.
+You can make it pass data around using in-memory strings using
+
+    app.configure_with(:rmagick, :use_filesystem => false)
+
+Rails
+-----
+
+    app.configure_with(:rails)
+
+The {Dragonfly::Config::Rails Rails configuration} points the log to the Rails logger, configures the file data store root path, sets the url_path_prefix to /media, and
+registers the {Dragonfly::Analysis::FileCommandAnalyser FileCommandAnalyser} for helping with mime_type validations.
+
+The file 'dragonfly/rails/images' does this for you.
+
+Heroku
+------
+
+    app.configure_with(:heroku, 's3_bucket_name')
+
+The {Dragonfly::Config::Heroku Heroku configuration} configures it to use the {Dragonfly::DataStorage::S3DataStore}, using Heroku's config attributes.
+See {file:Heroku} for more info.
+
+Custom Saved Configuration
+--------------------------
+You can create your own saved configuration with any object that responds to 'apply_configuration':
+
+    module MyConfiguration
+
+      def self.apply_configuration(app, *args)
+        app.configure do |c|
+          c.url_path_prefix = '/hello/beans'
+          c.processor.register(MyProcessor)
+          # ...
+        end
+      end
+
+    end
+
+Then to configure:
+
+    app.configure_with(MyConfiguration, :any_other => :args)     # other args get passed through to apply_configuration
+
+You can also carry on configuring by passing a block
+
+    app.configure_with(MyConfiguration) do |c|
+      c.any_extra = :config_here
+      # ...
+    end