ruby-slippers 0.0.1

data/lib/ruby_slippers/site.rb

@@ -0,0 +1,103 @@
+module RubySlippers
+  module Engine
+    class Site
+      def initialize config
+        @config = config
+      end
+
+      def [] *args
+        @config[*args]
+      end
+
+      def []= key, value
+        @config.set key, value
+      end
+
+      def index type = :html
+        articles = type == :html ? self.articles.reverse : self.articles
+        {:articles => articles.map do |article|
+          Article.new article, @config
+        end}.merge archives
+      end
+
+      def archives filter = ""
+        entries = ! self.articles.empty??
+          self.articles.select do |a|
+            filter !~ /^\d{4}/ || File.basename(a) =~ /^#{filter}/
+          end.reverse.map do |article|
+            Article.new article, @config
+          end : []
+
+        return :archives => Archives.new(entries, @config)
+      end
+
+      def article route
+        Article.new("#{Paths[:articles]}/#{route.join('-')}.#{self[:ext]}", @config).load
+      end
+
+      def tagged tag
+        articles = self.articles.collect do |article|
+          Article.new article, @config
+        end.select do |article|
+          article[:tags].index(tag.humanize.downcase) if article[:tags]
+        end
+
+        {:articles => articles, :tagged => tag}
+      end
+
+      def /
+        self[:root]
+      end
+
+      def go route, env = {}, type = :html
+        route << self./ if route.empty?
+        type, path = type =~ /html|xml|json/ ? type.to_sym : :html, route.join('/')
+        context = lambda do |data, page|
+          Context.new(data, @config, path, env).render(page, type)
+        end
+
+        body, status = if Context.new.respond_to?(:"to_#{type}")
+          if route.first =~ /\d{4}/
+            case route.size
+              when 1..3
+                context[archives(route * '-'), :archives]
+              when 4
+                context[article(route), :article]
+              else http 400
+            end
+          elsif route.first == "tagged"
+            context[tagged(route.last), :tagged]
+          elsif respond_to?(path)
+            context[send(path, type), path.to_sym]
+          elsif (repo = @config[:github][:repos].grep(/#{path}/).first) &&
+                !@config[:github][:user].empty?
+            context[Repo.new(repo, @config), :repo]
+          else
+            context[{}, path.to_sym]
+          end
+        else
+          http 400
+        end
+
+      rescue NoMethodError, Errno::ENOENT => e
+        return :body => http(404).first, :type => :html, :status => 404
+      else
+        return :body => body || "", :type => type, :status => status || 200
+      end
+
+    protected
+
+      def http code
+        [@config[:error].call(code), code]
+      end
+
+      def articles
+        self.class.articles self[:ext]
+      end
+
+      def self.articles ext
+        Dir["#{Paths[:articles]}/*.#{ext}"].sort_by {|entry| File.basename(entry) }
+      end
+    end
+  end
+end

data/lib/ruby_slippers/template.rb

@@ -0,0 +1,28 @@
+module RubySlippers
+  module Engine
+    module Template
+      def to_html page, config, &blk
+        path = ([:layout, :repo].include?(page) ? Paths[:templates] : Paths[:pages])
+        config[:to_html].call(path, page, binding)
+      end
+
+      def markdown text
+        if (options = @config[:markdown])
+          Markdown.new(text.to_s.strip, *(options.eql?(true) ? [] : options)).to_html
+        else
+          text.strip
+        end
+      end
+
+      def method_missing m, *args, &blk
+        self.keys.include?(m) ? self[m] : super
+      end
+
+      def self.included obj
+        obj.class_eval do
+          define_method(obj.to_s.split('::').last.downcase) { self }
+        end
+      end
+    end
+  end
+end

data/lib/ruby_slippers.rb

@@ -0,0 +1,28 @@
+require 'yaml'
+require 'date'
+require 'erb'
+require 'rack'
+require 'digest'
+require 'open-uri'
+
+if RUBY_PLATFORM =~ /win32/
+  require 'maruku'
+  Markdown = Maruku
+else
+  require 'rdiscount'
+end
+
+require 'builder'
+
+$:.unshift File.dirname(__FILE__)
+
+require 'ext/ext'
+require 'ruby_slippers/app'
+require 'ruby_slippers/site'
+require 'ruby_slippers/engine'
+require 'ruby_slippers/config'
+require 'ruby_slippers/template'
+require 'ruby_slippers/context'
+require 'ruby_slippers/article'
+require 'ruby_slippers/archives'
+require 'ruby_slippers/repo'

data/lib/tasks/gemspec.rake

@@ -0,0 +1,24 @@
+namespace :gem do
+  begin
+    require 'jeweler'
+    Jeweler::Tasks.new do |gem|
+      gem.name = "ruby-slippers"
+      gem.summary = %Q{the smartest blog-engine in all of Oz}
+      gem.description = %Q{A ruby and rack based blog engine for heroku}
+      gem.email = "james@rubyloves.me"
+      gem.homepage = "http://github.com/dreamr/ruby_slippers"
+      gem.authors = ["dreamr", "cloudhead"]
+      gem.add_development_dependency "riot"
+      gem.add_dependency "builder"
+      gem.add_dependency "rack"
+      if RUBY_PLATFORM =~ /win32/
+        gem.add_dependency "maruku"
+      else
+        gem.add_dependency "rdiscount"
+      end
+    end
+    Jeweler::GemcutterTasks.new
+  rescue LoadError
+    puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+  end
+end

data/lib/tasks/test.rake

@@ -0,0 +1,17 @@
+require 'rake/testtask'
+namespace :test do
+  TEST_TYPES = %w(unit integration)
+  TEST_TYPES.each do |type|
+    Rake::TestTask.new(type) do |test|
+      test.libs << 'lib' << 'test'
+      test.pattern = "test/#{type}/*_test.rb"
+      test.verbose = true
+    end
+  end
+  
+  Rake::TestTask.new(:all) do |test|
+    test.libs << 'lib' << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+end

data/test/fixtures/articles/2010-05-17-the-wonderful-wizard-of-oz.txt

@@ -0,0 +1,6 @@
+title: The Wonderful Wizard of Oz
+date: 17/05/2010
+tags: wizard
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+

data/test/fixtures/articles/2010-05-18-the-marvelous-land-of-oz.txt

@@ -0,0 +1,6 @@
+title: The Marvelous Land of Oz
+date: 18/05/2010
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

data/test/fixtures/articles/2010-05-20-dorothy-and-the-wizard-of-oz.txt

@@ -0,0 +1,6 @@
+title: Dorothy and the Wizard of Oz
+date: 20/05/2010
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

data/test/fixtures/articles/2011-05-18-ozma-of-oz.txt

@@ -0,0 +1,8 @@
+title: Ozma of Oz
+date: 18/05/2011
+tags: ozma, oz
+image: test/fixtures/images/ozma.png
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

data/test/fixtures/pages/about.rhtml

@@ -0,0 +1 @@
+<span id="count"><%= @articles.length %></span>

data/test/fixtures/pages/archives.rhtml

@@ -0,0 +1,5 @@
+<h1><%= @path %></h1>
+<% for entry in archives %>
+  <li class="entry"><%= entry.title %></li>
+<% end %>
+

data/test/fixtures/pages/article.rhtml

@@ -0,0 +1,4 @@
+<h2><%= title %></h2>
+<span><%= date %></h2>
+<p><%= body %></p>
+

data/test/fixtures/pages/index.rhtml

@@ -0,0 +1,13 @@
+<ul id="articles">
+  <% for article in articles[0...2] %>
+    <li><img src="<%= article.image_src %>" /><%= article %></li>
+  <% end %>
+</ul>
+<div id="archives">
+  <%= archives[2...5] %>
+</div>
+<!-- testing env variable passing -->
+<p>env passed: <%= env != nil %><br/></p>
+<!-- testing get/post parameter passing -->
+<p>request method type: <%= env['REQUEST_METHOD'] %><br/></p>
+<p>request name value pair: <%= env['QUERY_STRING'] %><br/></p>

data/test/fixtures/pages/tagged.rhtml

@@ -0,0 +1,9 @@
+<h1>Posts tagged with: <%= tagged %></h1>
+
+<% unless articles.empty? %>
+  <ul>
+    <% for article in articles %>
+      <li class="entry"><a href="<%= article.url %>"><%= article.title %></a></li>
+    <% end %>
+  </ul>
+<% end %>

data/test/fixtures/templates/index.builder

@@ -0,0 +1,21 @@
+xml.instruct!
+xml.feed "xmlns" => "http://www.w3.org/2005/Atom" do
+  xml.title @config[:title]
+  xml.id @config[:url]
+  xml.updated articles.first[:date].iso8601 unless articles.empty?
+  xml.author { xml.name @config[:author] }
+
+  articles.each do |article|
+    xml.entry do
+      xml.title article.title
+      xml.link "rel" => "alternate", "href" => article.url
+      xml.id article.url
+      xml.published article[:date].iso8601
+      xml.updated article[:date].iso8601
+      xml.author { xml.name @config[:author] }
+      xml.summary article.summary, "type" => "html"
+      xml.content article.body, "type" => "html"
+    end
+  end
+end
+

data/test/fixtures/templates/layout.rhtml

@@ -0,0 +1,4 @@
+<html>
+  <%= yield %>
+</html>
+

data/test/fixtures/templates/repo.rhtml

@@ -0,0 +1 @@
+<%= readme %>

data/test/integration/article_test.rb

@@ -0,0 +1,44 @@
+require 'support/test_helper'
+context RubySlippers::Engine::Article do
+  setup do
+    @config = RubySlippers::Engine::Config.new(:markdown => true, :author => AUTHOR, :url => URL)
+    @ruby_slippers = Rack::MockRequest.new(RubySlippers::Engine::App.new(@config))
+    RubySlippers::Engine::Paths[:articles]  = "test/fixtures/articles"
+    RubySlippers::Engine::Paths[:pages]     = "test/fixtures/pages"
+    RubySlippers::Engine::Paths[:templates] = "test/fixtures/templates"
+  end
+
+  context "GET a single article" do
+    setup { @ruby_slippers.get("/2010/05/17/the-wonderful-wizard-of-oz") }
+    asserts("returns a 200")                { topic.status }.equals 200
+    asserts("content type is set properly") { topic.content_type }.equals "text/html"
+    should("contain the article")           { topic.body }.includes_html("p" => /Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum./)
+  end
+
+  context "GET to the archive" do
+    context "through a year" do
+      setup { @ruby_slippers.get('/2011') }
+      asserts("returns a 200")                     { topic.status }.equals 200
+      should("includes the entries for that year") { topic.body }.includes_elements("li.entry", 1)
+    end
+
+    context "through a year & month" do
+      setup { @ruby_slippers.get('/2011/05') }
+      asserts("returns a 200")                      { topic.status }.equals 200
+      should("includes the entries for that month") { topic.body }.includes_elements("li.entry", 1)
+      should("includes the year & month")           { topic.body }.includes_html("h1" => /2011\/05/)
+    end
+
+    context "through /archives" do
+      setup { @ruby_slippers.get('/archives') }
+    end
+  end
+
+  context "GET the tagged page" do 
+    setup { @ruby_slippers.get('/tagged/wizard') }
+    asserts("returns a 200")                         { topic.status }.equals 200 
+    asserts("body is not empty")                     { not topic.body.empty? }
+    should("includes only the entries for that tag") { topic.body }.includes_elements("li.entry", 1)
+    should("has access to @tag")                     { topic.body }.includes_html("h1" => /wizard/)
+  end
+end

data/test/integration/atom_test.rb

@@ -0,0 +1,19 @@
+require 'support/test_helper'
+
+context RubySlippers::Engine::Article do
+  setup do
+    @config = RubySlippers::Engine::Config.new(:markdown => true, :author => AUTHOR, :url => URL)
+    @ruby_slippers = Rack::MockRequest.new(RubySlippers::Engine::App.new(@config))
+    RubySlippers::Engine::Paths[:articles] = "test/fixtures/articles"
+    RubySlippers::Engine::Paths[:pages] = "test/fixtures/pages"
+    RubySlippers::Engine::Paths[:templates] = "test/fixtures/templates"
+  end
+  
+  context "GET /index.xml (atom feed)" do
+    setup { @ruby_slippers.get('/index.xml') }
+    asserts("content type is set properly") { topic.content_type }.equals "application/xml"
+    asserts("body should be valid xml")     { topic.body }.includes_html("feed > entry" => /.+/)
+    asserts("summary shouldn't be empty")   { topic.body }.includes_html("summary" => /.{10,}/)
+  end
+  
+end

data/test/integration/ruby_slippers_test.rb

@@ -0,0 +1,77 @@
+require 'support/test_helper'
+require 'date'
+
+context RubySlippers::Engine do
+  setup do
+    @config = RubySlippers::Engine::Config.new(:markdown => true, :author => AUTHOR, :url => URL)
+    @ruby_slippers = Rack::MockRequest.new(RubySlippers::Engine::App.new(@config))
+    RubySlippers::Engine::Paths[:articles] = "test/fixtures/articles"
+    RubySlippers::Engine::Paths[:pages] = "test/fixtures/pages"
+    RubySlippers::Engine::Paths[:templates] = "test/fixtures/templates"
+  end
+  
+  context "GET /" do
+    setup { @ruby_slippers.get('/') }
+
+    asserts("returns a 200")                { topic.status }.equals 200
+    asserts("body is not empty")            { not topic.body.empty? }
+    asserts("content type is set properly") { topic.content_type }.equals "text/html"
+    should("include a couple of articles")   { topic.body }.includes_elements("#articles li", 2)
+    should("include an archive")            { topic.body }.includes_elements("#archives li", 2)
+
+    context "with no articles" do
+      setup { Rack::MockRequest.new(RubySlippers::Engine::App.new(@config.merge(:ext => 'oxo'))).get('/') }
+
+      asserts("body is not empty")          { not topic.body.empty? }
+      asserts("returns a 200")              { topic.status }.equals 200
+    end
+
+    context "with a user-defined to_html" do
+      setup do
+        @config[:to_html] = lambda do |path, page, binding|
+          ERB.new(File.read("#{path}/#{page}.rhtml")).result(binding)
+        end
+        @ruby_slippers.get('/')
+      end
+
+      asserts("returns a 200")                { topic.status }.equals 200
+      asserts("body is not empty")            { not topic.body.empty? }
+      asserts("content type is set properly") { topic.content_type }.equals "text/html"
+      should("include a couple of article")   { topic.body }.includes_elements("#articles li", 2)
+      should("include an archive")            { topic.body }.includes_elements("#archives li", 2)
+      asserts("Etag header present")          { topic.headers.include? "ETag" }
+      asserts("Etag header has a value")      { not topic.headers["ETag"].empty? }
+    end
+  end
+
+  context "GET /about" do
+    setup { @ruby_slippers.get('/about') }
+    asserts("returns a 200")                { topic.status }.equals 200
+    asserts("body is not empty")            { not topic.body.empty? }
+    should("have access to @articles")      { topic.body }.includes_html("#count" => /4/)
+  end
+
+  context "GET to an unknown route with a custom error" do
+    setup do
+      @config[:error] = lambda {|code| "error: #{code}" }
+      @ruby_slippers.get('/unknown')
+    end
+
+    should("returns a 404") { topic.status }.equals 404
+    should("return the custom error") { topic.body }.equals "error: 404"
+  end
+
+  context "Request is invalid" do
+    setup { @ruby_slippers.delete('/invalid') }
+    should("returns a 400") { topic.status }.equals 400
+  end
+
+  context "GET /index?param=testparam (get parameter)" do
+    setup { @ruby_slippers.get('/index?param=testparam')   }
+    asserts("returns a 200")                { topic.status }.equals 200
+    asserts("content type is set properly") { topic.content_type }.equals "text/html"
+    asserts("contain the env variable")           { topic.body }.includes_html("p" => /env passed: true/)
+    asserts("access the http get parameter")           { topic.body }.includes_html("p" => /request method type: GET/)
+    asserts("access the http parameter name value pair")           { topic.body }.includes_html("p" => /request name value pair: param=testparam/)
+  end
+end

data/test/support/test_helper.rb

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'hpricot'
+require 'riot'
+
+$:.unshift File.dirname(__FILE__)
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+
+require File.expand_path('../../../lib/ruby_slippers', __FILE__)
+
+URL = "http://domain.oz"
+AUTHOR = "author"
+
+class IncludesHTMLMacro < Riot::AssertionMacro
+  register :includes_html
+
+  def evaluate(actual, expected)
+    doc = Hpricot.parse(actual)
+    expected = expected.to_a.flatten
+
+    if (doc/expected.first).empty?
+      fail("expected #{actual} to contain a <#{expected.first}>")
+    elsif !(doc/expected.first).inner_html.match(expected.last)
+      fail("expected <#{expected.first}> to contain #{expected.last}")
+    else
+      pass
+    end
+  end
+end
+
+class IncludesElementsMacro < Riot::AssertionMacro
+  register :includes_elements
+
+  def evaluate(actual, selector, count)
+    doc = Hpricot.parse(actual)
+    (doc/selector).size == count ? pass : fail("expected #{actual} to contain #{count} #{selector}(s)")
+  end
+end
+
+class WithinMacro < Riot::AssertionMacro
+  register :within
+
+  def evaluate(actual, expected)
+    expected.include?(actual) ? pass : fail("expected #{actual} to be within #{expected}")
+  end
+end
+

data/test/unit/archives_test.rb

@@ -0,0 +1,8 @@
+require 'support/test_helper'
+
+context RubySlippers::Engine::Archives do
+  setup do
+    @config = RubySlippers::Engine::Config.new(:markdown => true, :author => AUTHOR, :url => URL)
+  end
+  
+end

data/test/unit/article_test.rb

@@ -0,0 +1,118 @@
+require 'support/test_helper'
+
+context RubySlippers::Engine::Article do
+  setup do
+    @config = RubySlippers::Engine::Config.new(:markdown => true, :author => AUTHOR, :url => URL)
+    @config[:markdown] = true
+    @config[:date] = lambda {|t| "the time is #{t.strftime("%Y/%m/%d %H:%M")}" }
+    @config[:summary] = {:length => 50}
+    @config[:tag_separator] = ", "
+  end
+
+  context "with the bare essentials" do
+    setup do
+      RubySlippers::Engine::Article.new({
+        :title => "Dorothy & The Wizard of Oz.",
+        :body => "#Chapter I\nhello, *stranger*."
+      }, @config)
+    end
+
+    should("have a title")               { topic.title }.equals "Dorothy & The Wizard of Oz."
+    should("parse the body as markdown") { topic.body }.equals "<h1>Chapter I</h1>\n\n<p>hello, <em>stranger</em>.</p>\n"
+    should("create an appropriate slug") { topic.slug }.equals "dorothy-and-the-wizard-of-oz"
+    should("set the date")               { topic.date }.equals "the time is #{Date.today.strftime("%Y/%m/%d %H:%M")}"
+    should("create a summary")           { topic.summary == topic.body }
+    should("have an author")             { topic.author }.equals AUTHOR
+    should("have a path")                { topic.path }.equals Date.today.strftime("/%Y/%m/%d/dorothy-and-the-wizard-of-oz/")
+    should("have a url")                 { topic.url }.equals Date.today.strftime("#{URL}/%Y/%m/%d/dorothy-and-the-wizard-of-oz/")
+  end
+
+  context "with a user-defined summary" do
+    setup do
+      RubySlippers::Engine::Article.new({
+        :title => "Dorothy & The Wizard of Oz.",
+        :body => "Well,\nhello ~\n, *stranger*."
+      }, @config.merge(:markdown => false, :summary => {:max => 150, :delim => /~\n/}))
+    end
+
+    should("split the article at the delimiter") { topic.summary }.equals "Well,\nhello"
+    should("not have the delimiter in the body") { topic.body !~ /~/ }
+  end
+
+  context "with everything specified" do
+    setup do
+      RubySlippers::Engine::Article.new({
+        :title  => "The Wizard of Oz",
+        :body   => ("a little bit of text." * 5) + "\n" + "filler" * 10,
+        :date   => "19/10/1976",
+        :slug   => "wizard-of-oz",
+        :author => "toetoe",
+        :tags   => "wizards, oz",
+        :image  => "img/articles/2011/may/ozma.png"
+      }, @config)
+    end
+
+    should("parse the date")  { [topic[:date].month, topic[:date].year] }.equals [10, 1976]
+    should("use the slug")    { topic.slug }.equals "wizard-of-oz"
+    should("use the author")  { topic.author }.equals "toetoe"
+    should("have tags")       { topic.tags }.equals "wizards, oz"
+    should("have tag links")  { topic.tag_links }.equals "<a href=\"/tagged/wizards\">wizards</a>, <a href=\"/tagged/oz\">oz</a>"
+    should("have an image")   { topic.image_src }.equals "img/articles/2011/may/ozma.png"
+
+    context "and long first paragraph" do
+      should("create a valid summary") { topic.summary }.equals "<p>" + ("a little bit of text." * 5).chop + "&hellip;</p>\n"
+    end
+
+    context "and a short first paragraph" do
+      setup do
+        @config[:markdown] = false
+        RubySlippers::Engine::Article.new({:body => "there ain't such thing as a free lunch\n" * 10}, @config)
+      end
+
+      should("create a valid summary") { topic.summary.size }.within 75..80
+    end
+  end
+
+  context "in a subdirectory" do
+    context "with implicit leading forward slash" do
+      setup do
+        conf = RubySlippers::Engine::Config.new({})
+        conf.set(:prefix, "blog")
+        RubySlippers::Engine::Article.new({
+          :title => "Dorothy & The Wizard of Oz.",
+          :body => "#Chapter I\nhello, *stranger*."
+        }, conf)
+      end
+
+      should("be in the directory") { topic.path }.equals Date.today.strftime("/blog/%Y/%m/%d/dorothy-and-the-wizard-of-oz/")
+    end
+
+    context "with explicit leading forward slash" do
+      setup do
+        conf = RubySlippers::Engine::Config.new({})
+        conf.set(:prefix, "/blog")
+        RubySlippers::Engine::Article.new({
+          :title => "Dorothy & The Wizard of Oz.",
+          :body => "#Chapter I\nhello, *stranger*."
+        }, conf)
+      end
+
+      should("be in the directory") { topic.path }.equals Date.today.strftime("/blog/%Y/%m/%d/dorothy-and-the-wizard-of-oz/")
+    end
+
+    context "with explicit trailing forward slash" do
+      setup do
+        conf = RubySlippers::Engine::Config.new({})
+        conf.set(:prefix, "blog/")
+        RubySlippers::Engine::Article.new({
+          :title => "Dorothy & The Wizard of Oz.",
+          :body => "#Chapter I\nhello, *stranger*."
+        }, conf)
+      end
+
+      should("be in the directory") { topic.path }.equals Date.today.strftime("/blog/%Y/%m/%d/dorothy-and-the-wizard-of-oz/")
+    end
+  end
+
+
+end