fog-dragonfly 0.8.1

data/spec/image_matchers.rb

@@ -0,0 +1,47 @@
+def image_properties(image)
+  if image.is_a?(Tempfile)
+    tempfile = image
+  else
+    tempfile = Tempfile.new('image')
+    tempfile.write(image.is_a?(Dragonfly::TempObject) ? image.data : image)
+    tempfile.close
+  end
+  details = `identify #{tempfile.path}`
+  # example of details string:
+  # myimage.png PNG 200x100 200x100+0+0 8-bit DirectClass 31.2kb
+  filename, format, geometry, geometry_2, depth, image_class, size = details.split(' ')
+  width, height = geometry.split('x')
+  {
+    :filename => filename,
+    :format => format.downcase,
+    :width => width,
+    :height => height,
+    :depth => depth,
+    :image_class => image_class,
+    :size => size
+  }
+end
+
+Spec::Matchers.define :have_width do |width|
+  match do |given|
+    width.should === image_properties(given)[:width].to_i
+  end
+end
+
+Spec::Matchers.define :have_height do |height|
+  match do |given|
+    height.should === image_properties(given)[:height].to_i
+  end
+end
+
+Spec::Matchers.define :have_format do |format|
+  match do |given|
+    image_properties(given)[:format].should == format
+  end
+end
+
+Spec::Matchers.define :have_size do |size|
+  match do |given|
+    image_properties(given)[:size].should == size
+  end
+end

data/spec/simple_matchers.rb

@@ -0,0 +1,44 @@
+Spec::Matchers.define :match_url do |url|
+  match do |given|
+    given_path, given_query_string = given.split('?')
+    path, query_string = url.split('?')
+
+    path == given_path && given_query_string.split('&').sort == query_string.split('&').sort
+  end
+end
+
+Spec::Matchers.define :be_an_empty_directory do
+  match do |given|
+    Dir.entries(given) == ['.','..']
+  end
+end
+
+# The reason we need this is that ActiveRecord 2.x returns just a string/nil, whereas AR 3 always returns an array
+Spec::Matchers.define :match_ar_error do |string|
+  match do |given|
+    error = given.is_a?(Array) ? given.first : given
+    error == string
+  end
+end
+
+Spec::Matchers.define :include_hash do |hash|
+  match do |given|
+    given.merge(hash) == given
+  end
+end
+
+def memory_usage
+  GC.start # Garbage collect
+  `ps -o rss= -p #{$$}`.strip.to_i
+end
+
+Spec::Matchers.define :leak_memory do
+  match do |given|
+    memory_before = memory_usage
+    given.call
+    memory_after = memory_usage
+    result = memory_after > memory_before
+    puts "#{memory_after} > #{memory_before}" if result
+    result
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'spec'
+require 'rack'
+require 'fileutils'
+
+require File.dirname(__FILE__) + '/../lib/dragonfly'
+$:.unshift(File.dirname(__FILE__))
+require 'argument_matchers'
+require 'simple_matchers'
+require 'image_matchers'
+
+ROOT_PATH = File.expand_path(File.dirname(__FILE__) + "/..") unless defined?(ROOT_PATH)
+
+# A hack as system calls weren't using my path
+extra_paths = %w(/opt/local/bin)
+ENV['PATH'] ||= ''
+ENV['PATH'] += ':' + extra_paths.join(':')
+
+SAMPLES_DIR = File.expand_path(File.dirname(__FILE__) + '/../samples') unless defined?(SAMPLES_DIR)
+
+Spec::Runner.configure do |c|
+  c.after(:all){ Dir["#{ROOT_PATH}/Gemfile*.lock"].each{|f| FileUtils.rm_f(f) } }
+end
+
+def todo
+  raise "TODO"
+end
+
+require 'logger'
+LOG_FILE = File.dirname(__FILE__) + '/spec.log' unless defined?(LOG_FILE)
+FileUtils.rm_rf(LOG_FILE)
+def mock_app(extra_stubs={})
+  mock('app', {
+    :datastore => mock('datastore', :store => 'some_uid', :retrieve => ["SOME_DATA", {}], :destroy => nil),
+    :processor => mock('processor', :process => "SOME_PROCESSED_DATA"),
+    :encoder => mock('encoder', :encode => "SOME_ENCODED_DATA"),
+    :analyser => mock('analyser', :analyse => "some_result", :analysis_methods => Module.new),
+    :generator => mock('generator', :generate => "SOME_GENERATED_DATA"),
+    :log => Logger.new(LOG_FILE),
+    :cache_duration => 10000,
+    :job_definitions => Module.new
+  }.merge(extra_stubs)
+  )
+end
+
+def test_app
+  Dragonfly::App.send(:new)
+end
+
+def suppressing_stderr
+  original_stderr = $stderr.dup
+  tempfile = Tempfile.new('stderr')
+  $stderr.reopen(tempfile)
+  yield
+ensure
+  tempfile.close
+  $stderr.reopen(original_stderr)
+end

data/yard/handlers/configurable_attr_handler.rb

@@ -0,0 +1,38 @@
+class ConfigurableAttrHandler < YARD::Handlers::Ruby::Legacy::Base
+  handles(/^\s*configurable_attr/)
+
+  def process
+    owner[:configurable_attributes] ||= []
+    
+    attribute = token_to_object(statement.tokens[2])
+    comments = statement.comments.join(' ') if statement.comments
+    
+    if statement.block
+    # e.g. configurable_attr :datastore do FileDataStore.new end
+      lazy_default_value = statement.block.to_s
+    else
+    # e.g. configurable_attr :fallback_mime_type, 'application/octet-stream'    
+      default_value = token_to_object(statement.tokens[5..-1])
+    end
+    owner[:configurable_attributes] << {
+      :attribute => attribute,
+      :default_value => default_value,
+      :lazy_default_value => lazy_default_value,
+      :comments => comments
+    }
+  end
+
+  private
+
+  def token_to_object(token)
+    if token
+      if token.is_a?(YARD::Parser::Ruby::Legacy::TokenList)
+        eval(token.to_s)
+      else # is a single token
+        eval(token.text)
+      end
+    end
+  end
+
+end
+

data/yard/setup.rb

@@ -0,0 +1,15 @@
+this_dir = File.dirname(__FILE__)
+
+YARD::Templates::Engine.register_template_path(this_dir + '/templates')
+Dir[this_dir + '/handlers/*.rb'].each do |file|
+  require File.expand_path(file)
+end
+YARD::Parser::SourceParser.parser_type = :ruby18
+
+version = ENV['DRAGONFLY_VERSION']
+DRAGONFLY_VERSION = if version
+  puts "Setting the version in the docs to #{version}"
+  version
+else
+  File.read(this_dir + '/../VERSION').strip
+end

data/yard/templates/default/fulldoc/html/css/common.css

@@ -0,0 +1,107 @@
+/* Overrides for yard documentation */
+
+/* Clearfix */
+.clearfix:after {
+	content: ".";
+	display: block;
+	clear: both;
+	visibility: hidden;
+	line-height: 0;
+	height: 0;
+}
+ 
+.clearfix {
+	display: inline-block;
+}
+ 
+html[xmlns] .clearfix {
+	display: block;
+}
+ 
+* html .clearfix {
+	height: 1%;
+}
+ /************/
+
+pre, code, .code,
+#filecontents pre.code,
+.docstring pre.code,
+.source_code pre {
+  font-family: monaco, 'Trebuchet MS', monospace;
+}
+
+pre.code, code {
+  background:#F5F5FF;
+  overflow-x: auto;
+}
+#filecontents pre.code {
+  margin:10px 0;
+  padding:5px 12px;
+  border-radius:5px;
+  -webkit-border-radius:5px;
+  -moz-border-radius:5px;
+  border: 1px dotted #CCC;
+}
+
+code .val {
+  color:#036A07;
+}
+code .kw {
+  color:#0000FF;
+}
+code .symbol {
+  color:#C5060B;
+}
+
+ul.main_files {
+  list-style-type:none;
+  margin:0;
+  padding:0;
+  font-size:14px;
+}
+ul.main_files li {
+  margin:0;
+  padding:0;
+}
+ul.main_files li:nth-child(odd) {
+  background-color:#fff;
+}
+ul.main_files li:nth-child(even) {
+  background-color:#eee;
+}
+
+ul.main_files li a {
+  margin: 0;
+  padding:7px 12px;
+  display:block;
+}
+
+/* Layout */
+#header,
+#content,
+#footer {
+  margin:0 auto;
+  width:1000px;
+}
+#header #logo {
+  float:left;
+  width:50%;
+  font-size: 32px;
+  letter-spacing: -1px;
+  margin-top: 20px;
+}
+#header #search {
+  position:static;
+  float:right;
+}
+#content .col1 {
+  float:left;
+  width: 750px;
+}
+#content .col2 {
+  float:left;
+  margin: 20px 0 0 20px;
+  padding: 0 0 0 20px;
+  width: 200px;
+  border-left: 1px dotted #D5D5D5;
+}

data/yard/templates/default/layout/html/layout.erb

@@ -0,0 +1,87 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <%= erb(:headers) %>
+    <script type="text/javascript" charset="utf-8">
+      (function($){
+        // YARD automatically creates a table of contents
+        // Let's place it inside .col1, instead of #content
+        $(document).ready(function(){
+          $('#toc').prependTo($('.col1'));
+          <% if options[:file] == 'extra_docs/Index.md' %>
+            $('#toc').hide();
+          <% end %>
+        });
+      })(jQuery);
+    </script>
+  </head>
+  <body>
+    <!-- GOOGLE ANALYTICS -->
+    <script type="text/javascript">
+
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-16382932-1']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+    <!-- *************** -->
+
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+
+    <div id="header" class="clearfix">
+      <%#= erb(:breadcrumb) %>
+      <div id="logo">DRAGONFLY (v <%= DRAGONFLY_VERSION %>)</div>
+      <%= erb(:search) %>
+    </div>
+
+    <div>
+      <iframe id="search_frame"></iframe>
+    </div>
+
+    <div id="content" class="clearfix">
+      <div class="col1">
+        <%= yieldall %>
+      </div>
+      <div class="col2">
+        <ul class="main_files clearfix">
+          <%= [
+            ['Index', 'Home'],
+            ['README', 'Quick start for Rails (README)'],
+            ['GeneralUsage', 'General usage'],
+            ['Rails2', 'Rails 2.3'],
+            ['Rails3', 'Rails 3'],
+            ['Models', 'Models (ActiveRecord, ActiveModel, etc.)'],
+            ['Rack', 'Rack'],
+            ['Sinatra', 'Sinatra'],
+            ['Heroku', 'Heroku'],
+            ['Mongo', 'Mongo'],
+            ['DataStorage', 'Data Storage'],
+            ['Analysers', 'Analysers'],
+            ['Processing', 'Processing'],
+            ['Encoding', 'Encoding'],
+            ['Generators', 'Generators'],
+            ['Configuration', 'Configuration'],
+            ['URLs', 'URLs / Endpoints'],
+            ['MimeTypes', 'Mime Types'],
+            ['Caching', 'Caching'],
+            ['History', 'History'],
+          ].map{|(file, text)|
+            "<li>#{link_file(file, text)}</li>"
+          }.join
+          %>
+        </ul>
+      </div>
+    </div>
+
+    <%= erb(:footer) %>
+  </body>
+</html>

data/yard/templates/default/module/html/configuration_summary.erb

@@ -0,0 +1,31 @@
+<% configurable_attributes = object[:configurable_attributes] || [] %>
+<% if configurable_attributes.any? %>
+<h2>Configuration Summary</h2>
+<h3>Configurable attributes</h3>
+Configurable attributes for an object in general <code>object</code> can be configured either by using something like
+<pre class="code">
+  object.configure <%= hl :do %> |c|
+    c.some_configurable_attribute = <%= hl 'some value' %>
+    c.some_other_configurable_attribute = <%= hl 42 %>
+    ...
+  <%= hl :end %>
+</pre>
+or
+<pre class="code">
+  object.some_configurable_attribute = <%= hl 'some value' %>
+</pre>
+<h4>Configurable attributes for instances of <%= object %></h4>
+<ul>
+  <% configurable_attributes.each do |attribute| %>
+  <li>
+    <code><%= attribute[:attribute] %></code>
+    <% if attribute[:lazy_default_value] %>
+     - default <code><%= hl attribute[:lazy_default_value] %></code> (evaluated lazily) 
+    <% else %>
+     - default <code><%= hl attribute[:default_value] %></code>
+    <% end %>
+    <%= '- ' + attribute[:comments] if attribute[:comments] %>
+  </li>
+  <% end %>
+</ul>
+<% end %>

data/yard/templates/default/module/setup.rb

@@ -0,0 +1,17 @@
+def init
+  super
+  sections.place(:configuration_summary).before(:method_summary)
+end
+
+# Highlight stuff
+def hl(code)
+  case code
+  when :do, :end then %(<span class="kw">#{code}</span>)
+  when Symbol then %(<span class="symbol">#{code.inspect}</span>)
+  when Integer then %(<span class="integer val">#{code}</span>)
+  when String then %(<span class="string val">#{code.inspect}</span>)
+  when true, false then %(<span class="kw">#{code.inspect}</span>)
+  when nil then %(<span class="nil kw">#{code.inspect}</span>)
+  else code
+  end    
+end