TwP-webby 0.9.0

data/spec/core_ext/hash_spec.rb

@@ -0,0 +1,47 @@
+
+require ::File.expand_path(
+    ::File.join(::File.dirname(__FILE__), %w[.. spec_helper]))
+
+describe Hash do
+
+  it "should stringify keys" do
+    h = {
+      :one  => 1,
+      :two  => 2,
+      3     => 'three',
+      [3,4] => :thirty_four
+    }.stringify_keys
+    h.keys.sort.should == %w[3 34 one two]
+  end
+
+  it "should symbolize keys" do
+    h = {
+      'foo' => 42,
+      'bar' => 'baz'
+    }.symbolize_keys
+
+    h.has_key?('foo').should == false
+    h.has_key?('bar').should == false
+
+    h.has_key?(:foo).should == true
+    h.has_key?(:bar).should == true
+  end
+
+  describe "when sanitizing values" do
+    [
+     ['none', nil], ['nil', nil],
+     ['true', true], ['yes', true],
+     ['false', false], ['no', false]
+    ].each do |from, to|
+
+      it "should convert #{from.inspect} to #{to.inspect}" do
+        h = {:key => from}
+        h.sanitize!
+        h[:key].should == to
+      end
+    end
+  end
+
+end
+
+# EOF

data/spec/core_ext/string_spec.rb

@@ -0,0 +1,110 @@
+
+require ::File.expand_path(
+    ::File.join(::File.dirname(__FILE__), %w[.. spec_helper]))
+
+describe String do
+
+  describe "#/" do
+    it "should join other strings to form a file path" do
+      path = 'foo' / 'bar' / 'baz'
+      path.should == ::File.join(%w[foo bar baz])
+    end
+  end
+
+  describe "#titlecase" do
+    it "should not capitalize small words" do
+      'and on the other hand of fate we have a ring'.titlecase.
+          should == 'And on the Other Hand of Fate We Have a Ring'
+    end
+
+    it "should not modify words that contain capital letters other than the first character" do
+      'the iTunes store is down'.titlecase.
+          should == 'The iTunes Store Is Down'
+      "what's up with the MacUpdate site".titlecase.
+          should == "What's Up With the MacUpdate Site"
+    end
+
+    it "should skip words with line dots (example.com or del.icio.us)" do
+      'the website example.com is used in documentation'.titlecase.
+          should == 'The Website example.com Is Used in Documentation'
+    end
+
+    it "should always capitlize the first and last words of the title" do
+      'a little bit of'.titlecase.should == 'A Little Bit Of'
+      'iTunes is being released'.titlecase.should == 'iTunes Is Being Released'
+      %q("a quoted title if").titlecase.should == %q("A Quoted Title If")
+      %q(and if you do via?).titlecase.should == %q(And if You Do Via?)
+    end
+
+    it "should caplitalize a small word after a colon" do
+      %q(starting sub-phrase with a small word: a trick, perhaps?).titlecase.
+          should == %q(Starting Sub-Phrase With a Small Word: A Trick, Perhaps?)
+
+      %q(sub-phrase with a small word in quotes: 'a trick, perhaps?').titlecase.
+          should == %q(Sub-Phrase With a Small Word in Quotes: 'A Trick, Perhaps?')
+
+      %q(sub-phrase with a small word in quotes: "a trick, perhaps?").titlecase.
+          should == %q(Sub-Phrase With a Small Word in Quotes: "A Trick, Perhaps?")
+    end
+
+    it "should properly handle contractions" do
+      %q(this isn't going to work).titlecase.
+          should == %q(This Isn't Going to Work)
+
+      %q(MicroSoft won't go down that route).titlecase.
+          should == %q(MicroSoft Won't Go Down That Route)
+    end
+
+    it "should capitalize phrases inside quotations" do
+      %q(Q&A with steve jobs: 'that's what happens in technology').titlecase.
+          should == %q(Q&A With Steve Jobs: 'That's What Happens in Technology')
+    end
+
+  end
+
+  describe "#to_url" do
+    it "should convert characters to words" do
+      given    = "10% Inspiration & 90% Perspiration"
+      expected = "10-percent-inspiration-and-90-percent-perspiration"
+
+      given.to_url.should == expected
+    end
+
+    it "should convert entities to words" do
+      given    = "Tea   & crumpets & crêpes for me!"
+      expected = "tea-and-crumpets-and-crepes-for-me"
+
+      given.to_url.should == expected
+    end
+
+    it "should remove html tags" do
+      given    = "I Am <strong>Awesome</strong>"
+      expected = "i-am-awesome"
+
+      given.to_url.should == expected
+    end
+
+    it "should convert ellipses" do
+      given    = "The Suspense... Is... Killing Me"
+      expected = "the-suspense-dot-dot-dot-is-dot-dot-dot-killing-me"
+
+      given.to_url.should == expected
+    end
+
+    it "should convert underscores to dashes" do
+      given    = "How to use attr_accessible and attr_protected"
+      expected = "how-to-use-attr-accessible-and-attr-protected"
+
+      given.to_url.should == expected
+    end
+
+    it "should remove punctuation" do
+      given    = "I'm just making sure there's nothing wrong with things!"
+      expected = "im-just-making-sure-theres-nothing-wrong-with-things"
+
+      given.to_url.should == expected
+    end
+  end
+end
+
+# EOF

data/spec/core_ext/time_spec.rb

@@ -0,0 +1,19 @@
+
+require ::File.expand_path(
+    ::File.join(::File.dirname(__FILE__), %w[.. spec_helper]))
+
+describe Time do
+
+  it "should serialize to a YAML string" do
+    now = Time.now
+
+    utc_offset = now.utc_offset / 3600
+    sign, utc_offset = utc_offset < 0 ? ['-', -utc_offset] : ['', utc_offset]
+    str = "%s.%06d %s%02d:00" %
+          [now.strftime('%Y-%m-%d %H:%M:%S'), now.usec, sign, utc_offset]
+
+    now.to_y.should == str
+  end
+end
+
+# EOF

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+# Equivalent to a header guard in C/C++
+# Used to prevent the spec helper from being loaded more than once
+unless defined? WEBBY_SPEC_HELPER
+WEBBY_SPEC_HELPER = true
+
+require 'rubygems'
+require 'fileutils'
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib webby]))
+
+end  # unless defined?
+
+# EOF

data/spec/webby/apps/generator_spec.rb

@@ -0,0 +1,111 @@
+
+require ::File.expand_path(
+    ::File.join(::File.dirname(__FILE__), %w[.. .. spec_helper]))
+require 'stringio'
+
+describe Webby::Apps::Generator do
+
+  before :each do
+    @generator = Webby::Apps::Generator.new
+  end
+
+  it "should return a list of available templates" do
+    ary = %w[blog presentation tumblog webby website].map {|t| Webby.path('examples', t)}
+    @generator.templates.should == ary
+  end
+
+  it "should pretend to create a site" do
+    @generator.parse %w[-p website foo]
+    @generator.pretend?.should == true
+
+    @generator = Webby::Apps::Generator.new
+    @generator.parse %w[website foo]
+    @generator.pretend?.should == false
+
+    @generator = Webby::Apps::Generator.new
+    @generator.parse %w[--pretend website foo]
+    @generator.pretend?.should == true
+  end
+
+  it "should return a list of all the site files from the template" do
+    @generator.parse %w[website foo]
+
+    h = @generator.site_files
+    h.keys.sort.should == [
+        "",
+        "content",
+        "content/css",
+        "content/css/blueprint",
+        "content/css/blueprint/compressed",
+        "content/css/blueprint/lib",
+        "content/css/blueprint/plugins",
+        "content/css/blueprint/plugins/buttons",
+        "content/css/blueprint/plugins/buttons/icons",
+        "content/css/blueprint/plugins/css-classes",
+        "content/css/blueprint/plugins/fancy-type",
+        "layouts",
+        "lib",
+        "templates"
+    ]
+    h["content"].should == %w[content/index.txt]
+    h["layouts"].should == %w[layouts/default.txt]
+  end
+
+  describe "when parsing command line arguments" do
+
+    before :each do
+      @strio = StringIO.new
+      @generator = Webby::Apps::Generator.new
+      @generator.instance_variable_set(:@stdout, @strio)
+
+      class << @strio
+        def to_s
+          seek 0
+          str = read
+          truncate 0
+          return str
+        end
+      end
+    end
+
+    it "should force the overwriting of files on collision" do
+      @generator.options[:collision].should be_nil
+      @generator.parse %w[-f website foo]
+      @generator.options[:collision].should == :force
+    end
+
+    it "should skip files on collision" do
+      @generator.options[:collision].should be_nil
+      @generator.parse %w[-s website foo]
+      @generator.options[:collision].should == :skip
+    end
+
+    it "should update only the rake files in the tasks folder" do
+      @generator.options[:update].should be_nil
+      @generator.parse %w[-u website foo]
+      @generator.options[:update].should == true
+    end
+
+    it "should pretend to generate / alter files" do
+      @generator.options[:pretend].should be_nil
+      @generator.parse %w[-p website foo]
+      @generator.options[:pretend].should == true
+    end
+
+    it "should exit if a site is not specified" do
+      lambda{@generator.parse %w[website]}.
+          should raise_error(SystemExit, 'exit')
+      @strio.to_s.split("\n").first.
+          should == 'Usage: webby-gen [options] template site'
+    end
+
+    it "should exit if an unknown template is given" do
+      lambda{@generator.parse %w[foo bar]}.
+          should raise_error(SystemExit, 'exit')
+      @strio.to_s.split("\n").last.
+          should == "    Could not find template 'foo'"
+    end
+  end
+end
+
+# EOF

data/spec/webby/apps/main_spec.rb

@@ -0,0 +1,75 @@
+
+require ::File.expand_path(
+    ::File.join(::File.dirname(__FILE__), %w[.. .. spec_helper]))
+
+# ---------------------------------------------------------------------------
+describe Webby::Apps::Main do
+  before do
+    @main = Webby::Apps::Main.new
+  end
+
+  describe ".capture_command_line_args" do
+    it "should set the raw arguments" do
+      raw = ["The Raw Arguments"]
+      args = @main.capture_command_line_args(raw)
+      args.raw.should == raw
+    end
+
+    it "should set the page with one argument by downcasing" do
+      page = "This-is-a-page"
+      args = @main.capture_command_line_args([page])
+      args.page.should == page.downcase
+    end
+
+    it "should set the page with two or more arguments by joining" do
+      page = %w(this is a page)
+      args = @main.capture_command_line_args(page)
+      args.page.should == page.join('-')
+    end
+
+    it "should set the dir from the page's dirname" do
+      page = "foo/bar/this-is-a-page.txt"
+      args = @main.capture_command_line_args([page])
+      args.dir.should == "foo/bar"
+    end
+
+    it "should set the slug from the page's basename" do
+      page = "foo/bar/this-is-a-page.txt"
+      args = @main.capture_command_line_args([page])
+      args.slug.should == "this-is-a-page"
+    end
+
+    it "should turn the slug into a url" do
+      page = "10% Inspiration & 90% Perspiration"
+      args = @main.capture_command_line_args([page])
+      args.slug.should == "10-percent-inspiration-and-90-percent-perspiration"
+    end
+
+    it "should set the page by combining the dir and slug" do
+      page = "10% Inspiration & 90% Perspiration"
+      args = @main.capture_command_line_args([page])
+      args.page.should == "10-percent-inspiration-and-90-percent-perspiration"
+
+      page = "foo/bar/10% Inspiration & 90% Perspiration"
+      args = @main.capture_command_line_args([page])
+      args.page.should == "foo/bar/10-percent-inspiration-and-90-percent-perspiration"
+    end
+
+    # TODO: Is this desired behavior?
+    it "should set the title by joining the raw args, getting the basename, and titlecasing"  do
+      page = "foo/bar/this-is-a-page.txt"
+      args = @main.capture_command_line_args([page])
+      args.title.should == "This-Is-a-Page"
+    end
+  end
+
+  describe ".parse" do
+    it "should pass environment variables to the rake application" do
+      ARGV = ary = []
+      args = %w[rebuild foo BASE=http://www.example.com bar]
+      @main.parse args
+      ary.should == %w[rebuild BASE=http://www.example.com]
+      args.should == %w[foo bar]
+    end
+  end
+end

data/spec/webby/helpers/capture_helper_spec.rb

@@ -0,0 +1,56 @@
+
+require ::File.expand_path(
+    ::File.join(::File.dirname(__FILE__), %w[.. .. spec_helper]))
+
+# ---------------------------------------------------------------------------
+describe Webby::Helpers::CaptureHelper do
+  CFN = ::File.expand_path(::File.join(::File.dirname(__FILE__), '..', '..', 'capture_for_yaml.txt'))
+  CLINES = [
+    "--- ",
+    "filter: ",
+    "  - erb ",
+    "--- ",
+    "Hello world!",
+    "<% content_for :sidebar do %>",
+    "I'm sidebar content.",
+    "<% end %>"
+  ]
+
+  before :all do
+    ::File.open(CFN,'w') {|fd| fd.write CLINES.join("\n") }
+  end
+
+  before :each do
+    @renderman = Webby::Renderer.new(
+                 Webby::Resources::Page.new(CFN))
+    @page_content = @renderman._render_page
+  end
+
+  after :all do
+    ::FileUtils.rm_f(CFN)
+  end
+
+  it 'should not "leak" any content to containing page' do
+    @page_content.should_not be_nil
+    @page_content.should eql("Hello world!\n")
+  end
+
+  it "should return the stored content for the given key" do
+    @renderman.content_for(:sidebar).should_not be_nil
+    @renderman.content_for(:sidebar).should eql("\nI'm sidebar content.\n") # Note: Leading newline
+  end
+
+  it "should report if content is associated with a given key" do
+    @renderman.content_for?(:sidebar).should == true
+    @renderman.content_for?(:header).should == false
+  end
+
+  it "should clear content associated with a given key" do
+    @renderman.content_for?(:sidebar).should == true
+    @renderman.delete_content_for(:sidebar)
+    @renderman.content_for?(:sidebar).should == false
+  end
+
+end
+
+# EOF

data/spec/webby/resources/file_spec.rb

@@ -0,0 +1,104 @@
+
+require ::File.join(::File.dirname(__FILE__), %w[.. .. spec_helper])
+
+# ---------------------------------------------------------------------------
+describe Webby::Resources::File do
+
+  FN = ::File.expand_path(::File.join(::File.dirname(__FILE__), '..', '..', 'lorem_ipsum.txt'))
+  FN_YAML = FN.gsub %r/\.txt\z/, '_yaml.txt'
+  LINES = [
+    "Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nulla orci\n",
+    "ante, aliquet ac, vulputate ut, suscipit et, sapien. Integer elementum\n",
+    "nisi quis magna tincidunt mattis. Aliquam semper. Pellentesque pretium.\n",
+    "Ut a ligula sit amet pede malesuada laoreet. Ut et purus. Morbi turpis\n",
+    "justo, pharetra vitae, consequat a, sodales vitae, tortor. Donec non\n",
+    "massa. Maecenas adipiscing venenatis nisi. Proin vulputate lorem posuere\n",
+    "mi. Cras sagittis. Pellentesque tortor mauris, accumsan vitae, ultrices\n",
+    "vel, tristique ultricies, eros. Donec fringilla hendrerit mauris. Nam in\n",
+    "orci. Curabitur congue consectetuer leo. Donec ut pede. Proin et lorem.\n",
+    "Aliquam eget lacus. In nibh.\n"
+  ]
+
+  before do
+    ::File.open(FN,'w') {|fd| fd.write LINES}
+    ::File.open(FN_YAML,'w') do |fd|
+      fd.write "--- \n- one\n- two\n- three\n--- \n"
+      fd.write LINES
+    end
+  end
+
+  after do 
+    ::FileUtils.rm_f(FN)
+    ::FileUtils.rm_f(FN_YAML)
+  end
+
+  it 'should return nil for meta-data on regular files' do
+    begin
+      fd = Webby::Resources::File.new FN, 'r'
+      fd.meta_data.should be_nil
+
+      fd.readlines.should == LINES
+    ensure
+      fd.close
+    end
+  end
+
+  it 'should add meta-data to the top of a file' do
+    Webby::Resources::File.open(FN,'a+') do |fd|
+      fd.meta_data.should be_nil
+      fd.meta_data = %w(one two three)
+    end
+
+    Webby::Resources::File.open(FN,'r') do |fd|
+      fd.meta_data.should == %w(one two three)
+    end
+
+    ::File.open(FN_YAML, 'r') do |fd|
+      ary = LINES.dup
+      ary.insert 0, [
+        "--- \n",
+        "- one\n",
+        "- two\n",
+        "- three\n",
+        "--- \n"
+      ]
+      fd.readlines.should == ary.flatten
+    end
+  end
+
+  it 'should remove the meta-data when set to nil' do
+    Webby::Resources::File.open(FN_YAML,'a+') do |fd|
+      fd.meta_data.should == %w(one two three)
+      fd.meta_data = nil
+    end
+
+    Webby::Resources::File.open(FN_YAML,'r') do |fd|
+      fd.meta_data.should be_nil
+    end
+
+    ::File.open(FN_YAML, 'r') do |fd|
+      fd.readlines.should == LINES
+    end
+  end
+
+  it 'should skip the meta-data when reading from the file' do
+    begin
+      fd = Webby::Resources::File.new FN_YAML, 'r'
+      fd.meta_data.should == %w(one two three)
+
+      fd.getc.should == ?L;                        fd.seek 0
+      fd.gets.should == LINES.first;               fd.seek 0
+      fd.read(5).should == 'Lorem';                fd.seek 0
+      fd.read_nonblock(11) == 'Lorem ipsum';       fd.seek 0
+      fd.readchar.should == ?L;                    fd.seek 0
+      fd.readline.should == LINES.first;           fd.seek 0
+      fd.readlines.should == LINES;                fd.seek 0
+      fd.readpartial(11).should == 'Lorem ipsum';  fd.seek 0
+
+    ensure
+      fd.close
+    end
+  end
+end  # describe Webby::Resources::File
+
+# EOF

data/spec/webby/resources_spec.rb

@@ -0,0 +1,17 @@
+
+
+require ::File.join(::File.dirname(__FILE__), %w[.. spec_helper])
+
+# ---------------------------------------------------------------------------
+describe Webby::Resources do
+  it "should raise a useful error if there are no layouts" do
+    layouts = mock("Layouts")
+    Webby::Resources.stub!(:layouts).and_return(layouts)
+    layouts.should_receive(:find).and_raise RuntimeError
+
+    lambda do
+      Webby::Resources.find_layout("default")
+    end.should raise_error(Webby::Error, 'could not find layout "default"')
+    
+  end
+end

data/tasks/ann.rake

@@ -0,0 +1,81 @@
+# $Id$
+
+begin
+  require 'bones/smtp_tls'
+rescue LoadError
+  require 'net/smtp'
+end
+require 'time'
+
+namespace :ann do
+
+  # A prerequisites task that all other tasks depend upon
+  task :prereqs
+
+  file PROJ.ann.file do
+    ann = PROJ.ann
+    puts "Generating #{ann.file}"
+    File.open(ann.file,'w') do |fd|
+      fd.puts("#{PROJ.name} version #{PROJ.version}")
+      fd.puts("    by #{Array(PROJ.authors).first}") if PROJ.authors
+      fd.puts("    #{PROJ.url}") if PROJ.url.valid?
+      fd.puts("    (the \"#{PROJ.release_name}\" release)") if PROJ.release_name
+      fd.puts
+      fd.puts("== DESCRIPTION")
+      fd.puts
+      fd.puts(PROJ.description)
+      fd.puts
+      fd.puts(PROJ.changes.sub(%r/^.*$/, '== CHANGES'))
+      fd.puts
+      ann.paragraphs.each do |p|
+        fd.puts "== #{p.upcase}"
+        fd.puts
+        fd.puts paragraphs_of(PROJ.readme_file, p).join("\n\n")
+        fd.puts
+      end
+      fd.puts ann.text if ann.text
+    end
+  end
+
+  desc "Create an announcement file"
+  task :announcement => ['ann:prereqs', PROJ.ann.file]
+
+  desc "Send an email announcement"
+  task :email => ['ann:prereqs', PROJ.ann.file] do
+    ann = PROJ.ann
+    from = ann.email[:from] || PROJ.email
+    to   = Array(ann.email[:to])
+
+    ### build a mail header for RFC 822
+    rfc822msg =  "From: #{from}\n"
+    rfc822msg << "To: #{to.join(',')}\n"
+    rfc822msg << "Subject: [ANN] #{PROJ.name} #{PROJ.version}"
+    rfc822msg << " (#{PROJ.release_name})" if PROJ.release_name
+    rfc822msg << "\n"
+    rfc822msg << "Date: #{Time.new.rfc822}\n"
+    rfc822msg << "Message-Id: "
+    rfc822msg << "<#{"%.8f" % Time.now.to_f}@#{ann.email[:domain]}>\n\n"
+    rfc822msg << File.read(ann.file)
+
+    params = [:server, :port, :domain, :acct, :passwd, :authtype].map do |key|
+      ann.email[key]
+    end
+
+    params[3] = PROJ.email if params[3].nil?
+
+    if params[4].nil?
+      STDOUT.write "Please enter your e-mail password (#{params[3]}): "
+      params[4] = STDIN.gets.chomp
+    end
+
+    ### send email
+    Net::SMTP.start(*params) {|smtp| smtp.sendmail(rfc822msg, from, to)}
+  end
+end  # namespace :ann
+
+desc 'Alias to ann:announcement'
+task :ann => 'ann:announcement'
+
+CLOBBER << PROJ.ann.file
+
+# EOF

data/tasks/bones.rake

@@ -0,0 +1,21 @@
+# $Id$
+
+if HAVE_BONES
+
+namespace :bones do
+
+  desc 'Show the PROJ open struct'
+  task :debug do |t|
+    atr = if t.application.top_level_tasks.length == 2
+      t.application.top_level_tasks.pop
+    end
+
+    if atr then Bones::Debug.show_attr(PROJ, atr)
+    else Bones::Debug.show PROJ end
+  end
+
+end  # namespace :bones
+
+end  # HAVE_BONES
+
+# EOF