giraffesoft-webby 0.9.5

data/lib/webby/stelan/paginator.rb

@@ -0,0 +1,165 @@
+# This code was originally written by Bruce Williams, and it is available
+# as the Paginator gem. I've added a few helper methods and modifications so
+# it plays a little more nicely with Webby. Specifically, a Webby::Resource
+# can be given to the Page and used to generate links to the previous and
+# next pages.
+#
+# Many thanks to Bruce Williams for letting me use his work. Drop him a note
+# of praise scribbled on the back of a $100 bill. He'd appreciate it.
+
+require 'forwardable'
+
+module Webby
+class Paginator
+  
+  include Enumerable
+
+  class ArgumentError < ::ArgumentError; end
+  class MissingCountError < ArgumentError; end
+  class MissingSelectError < ArgumentError; end  
+  
+  attr_reader :per_page, :count, :resource, :filename, :directory
+  
+  # Instantiate a new Paginator object
+  #
+  # Provide:
+  # * A total count of the number of objects to paginate
+  # * The number of objects in each page
+  # * A block that returns the array of items
+  #   * The block is passed the item offset 
+  #     (and the number of items to show per page, for
+  #     convenience, if the arity is 2)
+  def initialize(count, per_page, resource, &select)
+    @count, @per_page, @resource = count, per_page, resource
+    @meta_data = @resource._meta_data.dup
+    @filename = @resource.filename
+    @directory = @resource.directory
+    unless select
+      raise MissingSelectError, "Must provide block to select data for each page"
+    end
+    @select = select
+  end
+  
+  # Total number of pages
+  def number_of_pages
+     (@count / @per_page).to_i + (@count % @per_page > 0 ? 1 : 0)
+  end
+  
+  # First page object
+  def first
+    page 1
+  end
+  
+  # Last page object
+  def last
+    page number_of_pages
+  end
+  
+  def each
+    1.upto(number_of_pages) do |number|
+      yield page(number)
+    end
+  end
+  
+  # Retrieve page object by number
+  def page(number)
+    number = (n = number.to_i) > 0 ? n : 1
+    Page.new(self, number, lambda { 
+      offset = (number - 1) * @per_page
+      args = [offset]
+      args << @per_page if @select.arity == 2
+      @select.call(*args)
+    })
+  end
+
+  # Finalizer method that should be called when the paginator is finished
+  def reset
+    resource._reset(@meta_data)
+  end
+  
+  # Page object
+  #
+  # Retrieves items for a page and provides metadata about the position
+  # of the page in the paginator
+  class Page
+    
+    include Enumerable
+        
+    attr_reader :number, :pager, :url
+    
+    def initialize(pager, number, select) #:nodoc:
+      @pager, @number = pager, number
+      @offset = (number - 1) * pager.per_page
+      @select = select
+
+      @pager.reset
+      if number > 1
+        if ::Webby.site.create_mode == 'directory'
+          @pager.resource['directory'] = File.join(@pager.directory, number.to_s)
+        else
+          @pager.resource['filename'] = @pager.filename + number.to_s
+        end
+      end
+      @url = @pager.resource.url
+    end
+
+    # Retrieve the items for this page
+    # * Caches
+    def items
+      @items ||= @select.call
+    end
+    
+    # Checks to see if there's a page before this one
+    def prev?
+      @number > 1
+    end
+    
+    # Get previous page (if possible)
+    def prev
+      @pager.page(@number - 1) if prev?
+    end
+     
+    # Checks to see if there's a page after this one
+    def next?
+      @number < @pager.number_of_pages
+    end
+     
+    # Get next page (if possible)
+    def next
+      @pager.page(@number + 1) if next?
+    end
+     
+    # The "item number" of the first item on this page
+    def first_item_number
+      1 + @offset
+    end
+     
+    # The "item number" of the last item on this page
+    def last_item_number
+      if next?
+        @offset + @pager.per_page
+      else
+        @pager.count
+      end
+    end
+     
+    def ==(other) #:nodoc:
+      @pager == other.pager && self.number == other.number
+    end
+     
+    def each(&block)
+      items.each(&block)
+    end
+     
+    def method_missing(meth, *args, &block) #:nodoc:
+      if @pager.respond_to?(meth)
+        @pager.__send__(meth, *args, &block)
+      else
+        super
+      end
+    end
+
+  end
+  
+end  # class Paginator
+end  # module Webby

data/lib/webby/tasks/build.rake

@@ -0,0 +1,27 @@
+
+task :configure_basepath do
+  Webby.site.base = ENV['BASE'] if ENV.has_key?('BASE')
+end
+
+desc "Build the website"
+task :build => :configure_basepath do |t|
+  Webby::Builder.run
+end
+
+desc "Rebuild the website"
+task :rebuild => :configure_basepath do |t|
+  Webby::Builder.run :rebuild => true
+end
+
+desc "Continuously build the website"
+task :autobuild => :configure_basepath do |t|
+  Webby::AutoBuilder.run
+end
+
+desc "Delete the website"
+task :clobber do |t|
+  rm_rf Webby.site.output_dir
+  mkdir Webby.site.output_dir
+end
+
+# EOF

data/lib/webby/tasks/create.rake

@@ -0,0 +1,25 @@
+
+namespace :create do
+
+  FileList["#{Webby.site.template_dir}/*"].each do |template|
+    next unless test(?f, template)
+    name = template.pathmap '%n'
+
+    # if the file is a partial template
+    name = $1 if name =~ %r/^_(.*)/
+
+    desc "Create a new #{name}"
+    task name do |t|
+      page, title, dir = Webby::Builder.new_page_info
+      page = Webby::Builder.create(page, :from => template,
+                 :locals => {:title => title, :directory => dir})
+      unless ::Webby.editor.nil?
+        args = [::Webby.editor.split, page].flatten
+        exec(*args)
+      end
+    end
+  end  # each
+
+end  # namespace :create
+
+# EOF

data/lib/webby/tasks/deploy.rake

@@ -0,0 +1,22 @@
+
+require 'rake/contrib/sshpublisher'
+
+namespace :deploy do
+
+  desc 'Deploy to the server using rsync'
+  task :rsync do
+    cmd = "rsync #{SITE.rsync_args.join(' ')} "
+    cmd << "#{SITE.output_dir}/ #{SITE.user}@#{SITE.host}:#{SITE.remote_dir}"
+    sh cmd
+  end
+
+  desc 'Deploy to the server using ssh'
+  task :ssh do
+    Rake::SshDirPublisher.new(
+        "#{SITE.user}@#{SITE.host}", SITE.remote_dir, SITE.output_dir
+    ).upload
+  end
+
+end  # deploy
+
+# EOF

data/lib/webby/tasks/growl.rake

@@ -0,0 +1,16 @@
+
+unless WINDOWS
+
+task :growl do
+  growl = Logging::Appenders::Growl.new('growl',
+    :layout => Logging::Layouts::Pattern.new(:pattern => "%5l - Webby\000%m"),
+    :coalesce => true,
+    :separator => "\000"
+  )
+  Logging::Logger['Webby'].add_appenders(growl)
+  Logging::Logger['Webby::Journal'].add_appenders(growl)
+end
+
+end  # unless WINDOWS
+
+# EOF

data/lib/webby/tasks/validate.rake

@@ -0,0 +1,19 @@
+
+namespace :validate do
+
+  desc 'Validate hyperlinks (exclude external sites)'
+  task :internal => :build do
+    Webby::LinkValidator.validate(:external => false)
+  end
+
+  desc 'Validate hyperlinks (include external sites)'
+  task :external => :build do
+    Webby::LinkValidator.validate(:external => true)
+  end
+
+end  # validate
+
+desc 'Alias to validate:internal'
+task :validate => 'validate:internal'
+
+# EOF

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