mango 0.1.1 → 0.5.0.beta1

data/spec/mango/content_page/initializing_spec.rb

@@ -0,0 +1,298 @@
+# encoding: UTF-8
+require "spec_helper"
+
+describe Mango::ContentPage do
+
+  #################################################################################################
+
+  describe "initializing with attributes and Haml body" do
+    before(:all) do
+      @expected_data = <<-EOS
+---
+title: Delicious Cake!
+view: blog
+---
+%p So delicious!
+EOS
+      @expected_content_engine = :haml
+      @page = Mango::ContentPage.new(@expected_data, :content_engine => @expected_content_engine)
+    end
+
+    it "should save the data" do
+      @page.data.should == @expected_data
+    end
+
+    it "should use default content engine" do
+      @page.content_engine.should == @expected_content_engine
+    end
+
+    it "should load attributes" do
+      @page.attributes.should have(2).items
+      @page.attributes.should include("title" => "Delicious Cake!")
+      @page.attributes.should include("view" => "blog")
+    end
+
+    it "should load body" do
+      @page.body.should == "%p So delicious!\n"
+    end
+
+    it "should convert to HTML" do
+      @page.to_html.should == "<p>So delicious!</p>\n"
+    end
+
+    it "should determine the view template's base file name" do
+      @page.view.should == :blog
+    end
+  end
+
+  #################################################################################################
+
+  describe "initializing with attributes and Markdown body" do
+    before(:all) do
+      @expected_data = <<-EOS
+---
+title: Chocolate Pie!
+view: blog
+---
+### Sweet and crumbly!
+EOS
+      @expected_content_engine = :markdown
+      @page = Mango::ContentPage.new(@expected_data, :content_engine => @expected_content_engine)
+    end
+
+    it "should save the data" do
+      @page.data.should == @expected_data
+    end
+
+    it "should use default content engine" do
+      @page.content_engine.should == @expected_content_engine
+    end
+
+    it "should load attributes" do
+      @page.attributes.should have(2).items
+      @page.attributes.should include("title" => "Chocolate Pie!")
+      @page.attributes.should include("view" => "blog")
+    end
+
+    it "should load body" do
+      @page.body.should == "### Sweet and crumbly!\n"
+    end
+
+    it "should convert to HTML" do
+      @page.to_html.should == "<h3>Sweet and crumbly!</h3>"
+    end
+
+    it "should determine the view template's base file name" do
+      @page.view.should == :blog
+    end
+  end
+
+  #################################################################################################
+
+  describe "initializing with just attributes" do
+    before(:all) do
+      @expected_data = <<-EOS
+---
+title: Delicious Cake!
+view: blog.haml
+---
+EOS
+      @page = Mango::ContentPage.new(@expected_data)
+    end
+
+    it "should save the data" do
+      @page.data.should == @expected_data
+    end
+
+    it "should use default content engine" do
+      @page.content_engine.should == Mango::ContentPage::DEFAULT[:content_engine]
+    end
+
+    it "should load attributes" do
+      @page.attributes.should have(2).items
+      @page.attributes.should include("title" => "Delicious Cake!")
+      @page.attributes.should include("view" => "blog.haml")
+    end
+
+    it "should load body" do
+      @page.body.should be_empty
+    end
+
+    it "should convert to HTML" do
+      @page.to_html.should be_empty
+    end
+
+    it "should determine the view template's base file name" do
+      @page.view.should == :blog
+    end
+  end
+
+  #################################################################################################
+
+  describe "initializing with just body using the default content engine" do
+    before(:all) do
+      @expected_data = <<-EOS
+### So delicious!
+EOS
+      @page = Mango::ContentPage.new(@expected_data)
+    end
+
+    it "should save the data" do
+      @page.data.should == @expected_data
+    end
+
+    it "should use default content engine" do
+      @page.content_engine.should == Mango::ContentPage::DEFAULT[:content_engine]
+    end
+
+    it "should load attributes" do
+      @page.attributes.should have(1).items
+      @page.attributes.should include("view" => :page)
+    end
+
+    it "should load body" do
+      @page.body.should == "### So delicious!\n"
+    end
+
+    it "should convert to HTML" do
+      @page.to_html.should == "<h3>So delicious!</h3>"
+    end
+
+    it "should determine the view template's base file name" do
+      @page.view.should == :page
+    end
+  end
+
+  #################################################################################################
+
+  describe "initializing with empty attributes and body" do
+    before(:all) do
+      @expected_data = <<-EOS
+---
+---
+EOS
+      @page = Mango::ContentPage.new(@expected_data)
+    end
+
+    it "should save the data" do
+      @page.data.should == @expected_data
+    end
+
+    it "should use default content engine" do
+      @page.content_engine.should == Mango::ContentPage::DEFAULT[:content_engine]
+    end
+
+    it "should load attributes" do
+      @page.attributes.should have(1).items
+      @page.attributes.should include("view" => :page)
+    end
+
+    it "should load body" do
+      @page.body.should be_empty
+    end
+
+    it "should convert to HTML" do
+      @page.to_html.should be_empty
+    end
+
+    it "should determine the view template's base file name" do
+      @page.view.should == :page
+    end
+  end
+
+  #################################################################################################
+
+  describe "initializing with nil" do
+    before(:all) do
+      @expected_data = nil
+      @page = Mango::ContentPage.new(@expected_data)
+    end
+
+    it "should save the data" do
+      @page.data.should == @expected_data
+    end
+
+    it "should use default content engine" do
+      @page.content_engine.should == Mango::ContentPage::DEFAULT[:content_engine]
+    end
+
+    it "should load attributes" do
+      @page.attributes.should have(1).items
+      @page.attributes.should include("view" => :page)
+    end
+
+    it "should load body" do
+      @page.body.should be_empty
+    end
+
+    it "should convert to HTML" do
+      @page.to_html.should be_empty
+    end
+
+    it "should determine the view template's base file name" do
+      @page.view.should == :page
+    end
+  end
+
+  #################################################################################################
+
+  describe "initializing with unknown content engine" do
+    before(:all) do
+      @expected_data = ""
+      @expected_content_engine = :unknown
+      @page = Mango::ContentPage.new(@expected_data, :content_engine => @expected_content_engine)
+    end
+
+    it "should save the data" do
+      @page.data.should == @expected_data
+    end
+
+    it "should use unknown content engine" do
+      @page.content_engine.should == @expected_content_engine
+    end
+
+    it "should load attributes" do
+      @page.attributes.should have(1).items
+      @page.attributes.should include("view" => :page)
+    end
+
+    it "should load body" do
+      @page.body.should be_empty
+    end
+
+    it "should raise an exception when converting to HTML" do
+      lambda { @page.to_html }.should raise_exception("Unknown content engine -- unknown")
+    end
+
+    it "should determine the view template's base file name" do
+      @page.view.should == :page
+    end
+  end
+
+  #################################################################################################
+
+  describe "initializing with seasonable Markdown body" do
+    it "should season the rendered markup with Mango::FlavoredMarkdown" do
+      data = <<-EOS
+Mango is like a drug.
+You must have more_and_more and more of the Mango
+until there is no Mango left.
+Not even for Mango!
+      EOS
+
+      page = Mango::ContentPage.new(data, :content_engine => :markdown)
+
+      expected = <<-EOS
+<p>Mango is like a drug.<br/>
+You must have more_and_more and more of the Mango<br/>
+until there is no Mango left.<br/>
+Not even for Mango!<br/>
+</p>
+      EOS
+
+      page.to_html.should == expected.strip
+    end
+
+  end
+
+end

data/spec/mango/content_page_spec.rb

@@ -0,0 +1,44 @@
+# encoding: UTF-8
+require "spec_helper"
+
+describe Mango::ContentPage do
+
+  #################################################################################################
+
+  describe "class constants" do
+    it "should define CONTENT_ENGINES" do
+      Mango::ContentPage::CONTENT_ENGINES.should have(2).item
+      Mango::ContentPage::CONTENT_ENGINES.should include(:haml => ["haml"])
+      Mango::ContentPage::CONTENT_ENGINES.should include(:markdown => ["md", "mdown", "markdown"])
+    end
+
+    it "should define DEFAULT" do
+      Mango::ContentPage::DEFAULT.should have(3).items
+      Mango::ContentPage::DEFAULT.should include(:body => "")
+      Mango::ContentPage::DEFAULT.should include(:content_engine => :markdown)
+
+      attributes = Mango::ContentPage::DEFAULT[:attributes]
+      attributes.should include("view" => :page)
+    end
+  end
+
+  #################################################################################################
+
+  describe "attribute syntactic sugar" do
+    before(:all) do
+      @page = Mango::ContentPage.new <<-EOS
+---
+title: Syntactic Sugar Makes Life Sweeter
+---
+EOS
+    end
+
+    it "should make title sweeter" do
+      @page.title.should == @page.attributes["title"]
+    end
+    it "should not make unknown sweeter" do
+      lambda { @page.unknown }.should raise_exception(NoMethodError)
+    end
+  end
+
+end

data/spec/mango/dependencies_spec.rb

@@ -0,0 +1,189 @@
+# encoding: UTF-8
+require "spec_helper"
+
+describe Mango::Dependencies do
+
+  #################################################################################################
+
+  describe "class constant and variable defaults" do
+    it "required ruby version should be correct" do
+      Mango::Dependencies::REQUIRED_RUBY_VERSION.should == "1.9.1"
+    end
+
+    it "development gem names and versions should be correct" do
+      expected = {
+        :"rack-test"    => "0.5.4",
+        :rspec          => "1.3.0",
+        :yard           => "0.5.8",
+        :"yard-sinatra" => "0.5.0",
+        :bluecloth      => "2.0.7"
+      }
+
+      Mango::Dependencies::DEVELOPMENT_GEMS.should == expected
+    end
+
+    it "file name to gem name look-up table should be correct" do
+      expected = {
+        :"rack/test"          => :"rack-test",
+        :"spec/rake/spectask" => :rspec,
+        :"yard/sinatra"       => :"yard-sinatra"
+      }
+      Mango::Dependencies::FILE_NAME_TO_GEM_NAME.should == expected
+    end
+
+    it "warnings cache should be empty" do
+      Mango::Dependencies.class_variable_get(:@@warnings_cache).should be_empty
+    end
+  end
+
+  #################################################################################################
+
+  describe ".check_ruby_version (private)" do
+    before(:each) do
+      $stderr = StringIO.new
+    end
+
+    after(:each) do
+      $stderr = STDERR
+    end
+
+    def expected_message(version)
+      @expected_message = <<-ERROR
+This library requires Ruby 1.9.1, but you're using #{version}.
+Please visit http://www.ruby-lang.org/ for installation instructions.
+      ERROR
+    end
+
+    it "should abort for ruby 1.8.6" do
+      version = "1.8.6"
+      lambda {
+        Mango::Dependencies.send(:check_ruby_version, version)
+      }.should raise_exception(SystemExit, expected_message(version))
+    end
+
+    it "should abort for ruby 1.8.7" do
+      version = "1.8.7"
+      lambda {
+        Mango::Dependencies.send(:check_ruby_version, version)
+      }.should raise_exception(SystemExit, expected_message(version))
+    end
+
+    it "should abort for ruby 1.9.0" do
+      version = "1.9.0"
+      lambda {
+        Mango::Dependencies.send(:check_ruby_version, version)
+      }.should raise_exception(SystemExit, expected_message(version))
+    end
+
+    it "should not abort for ruby 1.9.1" do
+      version = "1.9.1"
+      lambda {
+        Mango::Dependencies.send(:check_ruby_version, version)
+      }.should_not raise_exception(SystemExit, expected_message(version))
+    end
+
+    it "should abort for ruby 1.9.2" do
+      version = "1.9.2"
+      lambda {
+        Mango::Dependencies.send(:check_ruby_version, version)
+      }.should raise_exception(SystemExit, expected_message(version))
+    end
+  end
+
+  #################################################################################################
+
+  describe ".destroy_warnings" do
+    it "should empty the warnings cache" do
+      Mango::Dependencies.class_variable_get(:@@warnings_cache).should be_empty
+
+      Mango::Dependencies.create_warning_for(LoadError.new("no such file to load -- yard"))
+      Mango::Dependencies.class_variable_get(:@@warnings_cache).should_not be_empty
+
+      Mango::Dependencies.destroy_warnings
+      Mango::Dependencies.class_variable_get(:@@warnings_cache).should be_empty
+    end
+  end
+
+  #################################################################################################
+
+  describe ".create_warning_for" do
+    after(:each) do
+      Mango::Dependencies.destroy_warnings
+    end
+
+    it "should create and cache one warning from a known development gem dependency" do
+      Mango::Dependencies.create_warning_for(LoadError.new("no such file to load -- yard"))
+      Mango::Dependencies.class_variable_get(:@@warnings_cache).should ==  ["yard --version '0.5.8'"]
+    end
+
+    it "should create and cache warnings from all known development gem dependencies" do
+      Mango::Dependencies::DEVELOPMENT_GEMS.each_key do |file_name|
+        gem_name = if Mango::Dependencies::FILE_NAME_TO_GEM_NAME.has_key?(file_name)
+          Mango::Dependencies::FILE_NAME_TO_GEM_NAME[file_name]
+        else
+          file_name
+        end
+        load_error = LoadError.new("no such file to load -- #{gem_name}")
+        Mango::Dependencies.create_warning_for(load_error)
+      end
+
+      expected = [
+        "rack-test --version '0.5.4'",
+        "rspec --version '1.3.0'",
+        "yard --version '0.5.8'",
+        "yard-sinatra --version '0.5.0'",
+        "bluecloth --version '2.0.7'"
+      ]
+      Mango::Dependencies.class_variable_get(:@@warnings_cache).should == expected
+    end
+
+    it "should raise an exception when creating a warning from an unknown development gem dependency" do
+      lambda {
+        Mango::Dependencies.create_warning_for(LoadError.new("no such file to load -- _fakegem"))
+      }.should raise_exception(RuntimeError, "Cannot create a dependency warning for unknown development gem -- _fakegem")
+    end
+  end
+
+  #################################################################################################
+
+  describe ".render_warnings" do
+    before(:each) do
+      $stdout = StringIO.new
+    end
+
+    after(:each) do
+      $stdout = STDOUT
+    end
+
+    it "should display a warning message to the user on the standard output channel" do
+      Mango::Dependencies.create_warning_for(LoadError.new("no such file to load -- spec/rake/spectask"))
+      Mango::Dependencies.create_warning_for(LoadError.new("no such file to load -- yard"))
+      Mango::Dependencies.create_warning_for(LoadError.new("no such file to load -- bluecloth"))
+      Mango::Dependencies.render_warnings
+      $stdout.string.should == <<-MESSAGE
+
+The following development gem dependencies could not be found. Without them, some available development features are missing:
+rspec --version '1.3.0'
+yard --version '0.5.8'
+bluecloth --version '2.0.7'
+      MESSAGE
+    end
+
+    it "should not display a warning message to the user if there are no warnings in the cache" do
+      Mango::Dependencies.destroy_warnings
+      Mango::Dependencies.render_warnings
+      $stdout.string.should be_empty
+    end
+  end
+
+  #################################################################################################
+
+  describe ".warn_at_exit" do
+    it "should ensure Kernel#at_exit is invoked with a block" do
+      Mango::Dependencies.should_receive(:at_exit)
+      # TODO how to specify that #at_exit receives a block?
+      # maybe i can intercept the block, execute it and test the output?
+      Mango::Dependencies.warn_at_exit
+    end
+  end
+end