radiant-grandchildren_tags-extension 1.0.0

data/README.md

@@ -0,0 +1,32 @@
+Radiant Grandchildren Tags Extension
+===
+
+About
+---
+
+An extension by [Benny Degezelle][jomz] that adds r:grandchildren tags. Think of this tag like r:aggregate, where the paths attribute would be the urls of all the children of the current page. All features of r:children are implemented, see Available Tags.
+
+Tested on [Radiant CMS][radiant] 1.0.0.rc2, but should work for 0.9.1+ (uses Radiant's render_children_with_pagination)
+
+Installation
+---
+  
+    git clone git://github.com/jomz/radiant-grandchildren_tags-extension.git vendor/extensions/grandchildren_tags
+
+
+###Available Tags
+
+    * <r:grandchildren:count>
+    * <r:grandchildren:first>
+    * <r:grandchildren:last>
+    * <r:grandchildren:each>
+    * <r:grandchildren:each:if_first>
+    * <r:grandchildren:each:unless_first>
+    * <r:grandchildren:each:if_last>
+    * <r:grandchildren:each:unless_last>
+    * <r:grandchildren:each:header>
+
+See the "available tags" documentation built into the Radiant page admin for more details.
+
+[jomz]: http://github.com/jomz
+[radiant]: http://radiantcms.org/

data/Rakefile

@@ -0,0 +1,109 @@
+# Determine where the RSpec plugin is by loading the boot
+unless defined? RADIANT_ROOT
+  ENV["RAILS_ENV"] = "test"
+  case
+  when ENV["RADIANT_ENV_FILE"]
+    require File.dirname(ENV["RADIANT_ENV_FILE"]) + "/boot"
+  when File.dirname(__FILE__) =~ %r{vendor/radiant/vendor/extensions}
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../")}/config/boot"
+  else
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../")}/config/boot"
+  end
+end
+
+require 'rake'
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+rspec_base = File.expand_path(RADIANT_ROOT + '/vendor/plugins/rspec/lib')
+$LOAD_PATH.unshift(rspec_base) if File.exist?(rspec_base)
+require 'spec/rake/spectask'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+# Cleanup the RADIANT_ROOT constant so specs will load the environment
+Object.send(:remove_const, :RADIANT_ROOT)
+
+extension_root = File.expand_path(File.dirname(__FILE__))
+
+task :default => [:spec, :features]
+task :stats => "spec:statsetup"
+
+desc "Run all specs in spec directory"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+task :features => 'spec:integration'
+
+namespace :spec do
+  desc "Run all specs in spec directory with RCov"
+  Spec::Rake::SpecTask.new(:rcov) do |t|
+    t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec', '--rails']
+  end
+  
+  desc "Print Specdoc for all specs"
+  Spec::Rake::SpecTask.new(:doc) do |t|
+    t.spec_opts = ["--format", "specdoc", "--dry-run"]
+    t.spec_files = FileList['spec/**/*_spec.rb']
+  end
+
+  [:models, :controllers, :views, :helpers].each do |sub|
+    desc "Run the specs under spec/#{sub}"
+    Spec::Rake::SpecTask.new(sub) do |t|
+      t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
+      t.spec_files = FileList["spec/#{sub}/**/*_spec.rb"]
+    end
+  end
+  
+  desc "Run the Cucumber features"
+  Cucumber::Rake::Task.new(:integration) do |t|
+    t.fork = true
+    t.cucumber_opts = ['--format', (ENV['CUCUMBER_FORMAT'] || 'pretty')]
+    # t.feature_pattern = "#{extension_root}/features/**/*.feature"
+    t.profile = "default"
+  end
+
+  # Setup specs for stats
+  task :statsetup do
+    require 'code_statistics'
+    ::STATS_DIRECTORIES << %w(Model\ specs spec/models)
+    ::STATS_DIRECTORIES << %w(View\ specs spec/views)
+    ::STATS_DIRECTORIES << %w(Controller\ specs spec/controllers)
+    ::STATS_DIRECTORIES << %w(Helper\ specs spec/views)
+    ::CodeStatistics::TEST_TYPES << "Model specs"
+    ::CodeStatistics::TEST_TYPES << "View specs"
+    ::CodeStatistics::TEST_TYPES << "Controller specs"
+    ::CodeStatistics::TEST_TYPES << "Helper specs"
+    ::STATS_DIRECTORIES.delete_if {|a| a[0] =~ /test/}
+  end
+
+  namespace :db do
+    namespace :fixtures do
+      desc "Load fixtures (from spec/fixtures) into the current environment's database.  Load specific fixtures using FIXTURES=x,y"
+      task :load => :environment do
+        require 'active_record/fixtures'
+        ActiveRecord::Base.establish_connection(RAILS_ENV.to_sym)
+        (ENV['FIXTURES'] ? ENV['FIXTURES'].split(/,/) : Dir.glob(File.join(RAILS_ROOT, 'spec', 'fixtures', '*.{yml,csv}'))).each do |fixture_file|
+          Fixtures.create_fixtures('spec/fixtures', File.basename(fixture_file, '.*'))
+        end
+      end
+    end
+  end
+end
+
+desc 'Generate documentation for the grandchildren_tags extension.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'GrandchildrenTagsExtension'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# Load any custom rakefiles for extension
+Dir[File.dirname(__FILE__) + '/tasks/*.rake'].sort.each { |f| require f }

data/config/locales/en.yml

@@ -0,0 +1,3 @@
+---
+en:
+  grandchildren tags: Grandchildren Tags

data/cucumber.yml

@@ -0,0 +1 @@
+default: --format progress features --tags ~@proposed,~@in_progress

data/grandchildren_tags_extension.rb

@@ -0,0 +1,10 @@
+require 'radiant-grandchildren_tags-extension/version'
+class GrandchildrenTagsExtension < Radiant::Extension
+  version RadiantGrandchildrenTagsExtension::VERSION
+  description "Adds grandchildren tags to Radiant."
+  url "http://github.com/jomz/radiant-grandchildren_tags-extension"
+  
+  def activate
+    Page.send :include, GrandchildrenTags
+  end
+end

data/lib/grandchildren_tags.rb

@@ -0,0 +1,260 @@
+module GrandchildrenTags
+  include Radiant::Taggable
+
+  desc %{
+    Renders the contained elements only if the current contextual page has one or
+    more grandchild pages.  The @status@ attribute limits the status of found child pages
+    to the given status, the default is @"published"@. @status="all"@ includes all
+    non-virtual pages regardless of status.
+
+    *Usage:*
+    
+    <pre><code><r:if_grandchildren [status="published"]>...</r:if_grandchildren></code></pre>
+  }
+  tag "if_grandchildren" do |tag|
+    tag.locals.parent_ids = tag.locals.page.children.map(&:id)
+    options = aggregate_children(tag)
+    tag.expand if Page.count(options) > 0
+  end
+
+  desc %{
+    Renders the contained elements only if the current contextual page has no grandchildren.
+    The @status@ attribute limits the status of found child pages to the given status,
+    the default is @"published"@. @status="all"@ includes all non-virtual pages
+    regardless of status.
+
+    *Usage:*
+    
+    <pre><code><r:unless_grandchildren [status="published"]>...</r:unless_grandchildren></code></pre>
+  }
+  tag "unless_grandchildren" do |tag|
+    tag.locals.parent_ids = tag.locals.page.children.map(&:id)
+    options = aggregate_children(tag)
+    tag.expand unless Page.count(options) > 0
+  end
+
+  desc %{
+    Gives access to a page's grandchildren.
+
+    *Usage:*
+  
+    <pre><code><r:grandchildren>...</r:grandchildren></code></pre>
+  }
+  tag 'grandchildren' do |tag|
+    tag.locals.parent_ids = tag.locals.page.children.map(&:id)
+    tag.expand
+  end
+
+  desc %{
+    Renders the total number of grandchildren.
+  }
+  tag 'grandchildren:count' do |tag|
+    options = aggregate_children(tag)
+    Page.count(options)
+  end
+
+  desc %{
+    Returns the first grandchild. Inside this tag all page attribute tags are mapped to
+    the first child. Takes the same ordering options as @<r:children:each>@.
+
+    *Usage:*
+  
+    <pre><code><r:grandchildren:first>...</r:grandchildren:first></code></pre>
+  }
+  tag 'grandchildren:first' do |tag|
+    options = aggregate_children(tag)
+    grandchildren = Page.find(:all, options)
+    if first = grandchildren.first
+      tag.locals.page = first
+      tag.expand
+    end
+  end
+
+  desc %{
+    Returns the last grandchild. Inside this tag all page attribute tags are mapped to
+    the last grandchild. Takes the same ordering options as @<r:children:each>@.
+
+    *Usage:*
+  
+    <pre><code><r:grandchildren:last>...</r:grandchildren:last></code></pre>
+  }
+  tag 'grandchildren:last' do |tag|
+    options = aggregate_children(tag)
+    grandchildren = Page.find(:all, options)
+    if last = grandchildren.last
+      tag.locals.page = last
+      tag.expand
+    end
+  end
+
+  desc %{
+    Cycles through each of the grandchildren. Inside this tag all page attribute tags
+    are mapped to the current grandchild page.
+  
+    Supply @paginated="true"@ to paginate the displayed list. will_paginate view helper
+    options can also be specified, including @per_page@, @previous_label@, @next_label@,
+    @class@, @separator@, @inner_window@ and @outer_window@.
+
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each [offset="number"] [limit="number"]
+     [by="published_at|updated_at|created_at|slug|title|keywords|description"]
+     [order="asc|desc"] 
+     [status="draft|reviewed|published|hidden|all"]
+     [paginated="true"]
+     [per_page="number"]
+     >
+     ...
+    </r:children:each>
+    </code></pre>
+  }
+  tag 'grandchildren:each' do |tag|
+    render_children_with_pagination(tag, :aggregate => true)
+  end
+
+  desc %{
+    The pagination tag is not usually called directly. Supply paginated="true" when you display a list and it will
+    be automatically display only the current page of results, with pagination controls at the bottom.
+
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each paginated="true" per_page="50" container="false" previous_label="foo" next_label="bar">
+      <r:child>...</r:child>
+    </r:grandchildren:each>
+    </code></pre>
+  }
+  tag 'pagination' do |tag|
+    if tag.locals.paginated_list
+      will_paginate(tag.locals.paginated_list, will_paginate_options(tag))
+    end
+  end
+
+  desc %{
+    Page attribute tags inside of this tag refer to the current grandchild. This is occasionally
+    useful if you are inside of another tag (like &lt;r:find&gt;) and need to refer back to the
+    current child.
+
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each>
+      <r:child>...</r:child>
+    </r:grandchildren:each>
+    </code></pre>
+  }
+  tag 'grandchildren:each:child' do |tag|
+    tag.locals.page = tag.locals.child
+    tag.expand
+  end
+
+  desc %{
+    Renders the tag contents only if the current page is the first child in the context of
+    a grandchildren:each tag
+  
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each>
+      <r:if_first >
+        ...
+      </r:if_first>
+    </r:grandchildren:each>
+    </code></pre>
+  
+  }
+  tag 'grandchildren:each:if_first' do |tag|
+    tag.expand if tag.locals.first_child
+  end
+
+
+  desc %{
+    Renders the tag contents unless the current page is the first child in the context of
+    a grandchildren:each tag
+  
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each>
+      <r:unless_first >
+        ...
+      </r:unless_first>
+    </r:grandchildren:each>
+    </code></pre>
+  
+  }
+  tag 'grandchildren:each:unless_first' do |tag|
+    tag.expand unless tag.locals.first_child
+  end
+
+  desc %{
+    Renders the tag contents only if the current page is the last child in the context of
+    a grandchildren:each tag
+  
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each>
+      <r:if_last >
+        ...
+      </r:if_last>
+    </r:grandchildren:each>
+    </code></pre>
+  
+  }
+  tag 'grandchildren:each:if_last' do |tag|
+    tag.expand if tag.locals.last_child
+  end
+
+
+  desc %{
+    Renders the tag contents unless the current page is the last child in the context of
+    a grandchildren:each tag
+  
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each>
+      <r:unless_last >
+        ...
+      </r:unless_last>
+    </r:grandchildren:each>
+    </code></pre>
+  
+  }
+  tag 'grandchildren:each:unless_last' do |tag|
+    tag.expand unless tag.locals.last_child
+  end
+
+  desc %{
+    Renders the tag contents only if the contents do not match the previous header. This
+    is extremely useful for rendering date headers for a list of child pages.
+
+    If you would like to use several header blocks you may use the @name@ attribute to
+    name the header. When a header is named it will not restart until another header of
+    the same name is different.
+
+    Using the @restart@ attribute you can cause other named headers to restart when the
+    present header changes. Simply specify the names of the other headers in a semicolon
+    separated list.
+
+    *Usage:*
+  
+    <pre><code><r:grandchildren:each>
+      <r:header [name="header_name"] [restart="name1[;name2;...]"]>
+        ...
+      </r:header>
+    </r:grandchildren:each>
+    </code></pre>
+  }
+  tag 'grandchildren:each:header' do |tag|
+    previous_headers = tag.locals.previous_headers
+    name = tag.attr['name'] || :unnamed
+    restart = (tag.attr['restart'] || '').split(';')
+    header = tag.expand
+    unless header == previous_headers[name]
+      previous_headers[name] = header
+      unless restart.empty?
+        restart.each do |n|
+          previous_headers[n] = nil
+        end
+      end
+      header
+    end
+  end
+  
+end

data/lib/radiant-grandchildren_tags-extension.rb

@@ -0,0 +1,2 @@
+module RadiantGrandchildrenTagsExtension
+end

data/lib/radiant-grandchildren_tags-extension/version.rb

@@ -0,0 +1,3 @@
+module RadiantGrandchildrenTagsExtension
+  VERSION = '1.0.0'
+end

data/lib/tasks/grandchildren_tags_extension_tasks.rake

@@ -0,0 +1,55 @@
+namespace :radiant do
+  namespace :extensions do
+    namespace :grandchildren_tags do
+      
+      desc "Runs the migration of the Grandchildren Tags extension"
+      task :migrate => :environment do
+        require 'radiant/extension_migrator'
+        if ENV["VERSION"]
+          GrandchildrenTagsExtension.migrator.migrate(ENV["VERSION"].to_i)
+          Rake::Task['db:schema:dump'].invoke
+        else
+          GrandchildrenTagsExtension.migrator.migrate
+          Rake::Task['db:schema:dump'].invoke
+        end
+      end
+      
+      desc "Copies public assets of the Grandchildren Tags to the instance public/ directory."
+      task :update => :environment do
+        is_svn_or_dir = proc {|path| path =~ /\.svn/ || File.directory?(path) }
+        puts "Copying assets from GrandchildrenTagsExtension"
+        Dir[GrandchildrenTagsExtension.root + "/public/**/*"].reject(&is_svn_or_dir).each do |file|
+          path = file.sub(GrandchildrenTagsExtension.root, '')
+          directory = File.dirname(path)
+          mkdir_p RAILS_ROOT + directory, :verbose => false
+          cp file, RAILS_ROOT + path, :verbose => false
+        end
+        unless GrandchildrenTagsExtension.root.starts_with? RAILS_ROOT # don't need to copy vendored tasks
+          puts "Copying rake tasks from GrandchildrenTagsExtension"
+          local_tasks_path = File.join(RAILS_ROOT, %w(lib tasks))
+          mkdir_p local_tasks_path, :verbose => false
+          Dir[File.join GrandchildrenTagsExtension.root, %w(lib tasks *.rake)].each do |file|
+            cp file, local_tasks_path, :verbose => false
+          end
+        end
+      end  
+      
+      desc "Syncs all available translations for this ext to the English ext master"
+      task :sync => :environment do
+        # The main translation root, basically where English is kept
+        language_root = GrandchildrenTagsExtension.root + "/config/locales"
+        words = TranslationSupport.get_translation_keys(language_root)
+        
+        Dir["#{language_root}/*.yml"].each do |filename|
+          next if filename.match('_available_tags')
+          basename = File.basename(filename, '.yml')
+          puts "Syncing #{basename}"
+          (comments, other) = TranslationSupport.read_file(filename, basename)
+          words.each { |k,v| other[k] ||= words[k] }  # Initializing hash variable as empty if it does not exist
+          other.delete_if { |k,v| !words[k] }         # Remove if not defined in en.yml
+          TranslationSupport.write_file(filename, basename, comments, other)
+        end
+      end
+    end
+  end
+end

data/radiant-grandchildren_tags-extension.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "radiant-grandchildren_tags-extension/version"
+
+Gem::Specification.new do |s|
+  s.name        = "radiant-grandchildren_tags-extension"
+  s.version     = RadiantGrandchildrenTagsExtension::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Benny Degezelle"]
+  s.email       = ["benny@gorilla-webdesign.be"]
+  s.homepage    = "http://github.com/jomz/radiant-grandchildren_tags-extension"
+  s.summary     = %q{Grandchildren Tags for Radiant CMS}
+  s.description = %q{Makes Radiant better by adding grandchildren_tags!}
+  
+  ignores = if File.exist?('.gitignore')
+    File.read('.gitignore').split("\n").inject([]) {|a,p| a + Dir[p] }
+  else
+    []
+  end
+  s.files         = Dir['**/*'] - ignores
+  s.test_files    = Dir['test/**/*','spec/**/*','features/**/*'] - ignores
+  # s.executables   = Dir['bin/*'] - ignores
+  s.require_paths = ["lib"]
+  
+  s.post_install_message = %{
+  Add this to your radiant project with:
+    config.gem 'radiant-grandchildren_tags-extension', :version => '~>#{RadiantGrandchildrenTagsExtension::VERSION}'
+  }
+end

data/spec/datasets/grandchildren_dataset.rb

@@ -0,0 +1,35 @@
+class GrandchildrenDataset < Dataset::Base
+  uses :home_page, :pages
+    
+  helpers do
+    describe "Archive index page", :shared => true do
+      it "should render <r:archive:children:first /> as unimplemented" do
+        @page.should render('<r:archive:children:first><r:slug /></r:archive:children:first>').as('unimplemented')
+      end
+
+      it "should render <r:archive:children:last /> as unimplemented" do
+        @page.should render('<r:archive:children:last><r:slug /></r:archive:children:last>').as('unimplemented')
+      end
+
+      it "should <r:archive:children:count /> as unimplemented" do
+        @page.should render('<r:archive:children:count><r:slug /></r:archive:children:count>').as('unimplemented')
+      end
+      
+      it "should render the <r:archive:year /> tag" do
+        @page.should render("<r:archive:year />").as("2000").on("/archive/2000/")
+      end
+      
+      it "should render the <r:archive:month /> tag" do
+        @page.should render("<r:archive:month />").as("June").on("/archive/2000/06/")
+      end
+      
+      it "should render the <r:archive:day /> tag" do
+        @page.should render('<r:archive:day />').as("9").on('/archive/2000/06/09/')
+      end
+      
+      it "should render the <r:archive:day_of_week /> tag" do
+        @page.should render('<r:archive:day_of_week />').as('Friday').on("/archive/2000/06/09/")
+      end
+    end
+  end
+end

data/spec/models/grandchildren_tags_spec.rb

@@ -0,0 +1,253 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "Grandchildren Tags" do
+  dataset :home_page, :users_and_pages
+  
+  it '<r:if_grandchildren> should render the contained block if the current page has child pages' do
+    pages(:home).should render('<r:if_grandchildren>true</r:if_grandchildren>').as('true')
+    pages(:childless).should render('<r:if_grandchildren>true</r:if_grandchildren>').as('')
+  end
+
+  it '<r:unless_grandchildren> should render the contained block if the current page has no child pages' do
+    pages(:home).should render('<r:unless_grandchildren>true</r:unless_grandchildren>').as('')
+    pages(:childless).should render('<r:unless_grandchildren>true</r:unless_grandchildren>').as('true')
+  end
+
+  describe "<r:grandchildren:each>" do
+    it "should iterate through the grandchildren of the current page" do
+      pages(:parent).should render('<r:grandchildren:each:title />').as('Grandchild')
+      pages(:parent).should render('<r:grandchildren:each><r:parent:slug />/<r:slug /></r:grandchildren:each>').as('child/grandchild')
+    end
+
+    it 'should not list draft pages' do
+      pages(:home).should render(page_grandchildren_each_tags(%{by="title"})).as('a article article-2 article-3 article-4 b c child child-2 child-3 d e f g guests h i j ')
+    end
+
+    it 'should include draft pages with status="all"' do
+      pages(:home).should render(page_grandchildren_each_tags(%{status="all" by="slug"})).as('a article article-2 article-3 article-4 b c child child-2 child-3 d draft draft-article e f g guests h i j ')
+    end
+
+    it "should include draft pages by default on the dev host" do
+      pages(:home).should render(page_grandchildren_each_tags(%{by="slug"})).as('a article article-2 article-3 article-4 b c child child-2 child-3 d draft draft-article e f g guests h i j ').on('dev.site.com')
+    end
+
+    it 'should not list draft pages on dev.site.com when Radiant::Config["dev.host"] is set to something else' do
+      Radiant::Config['dev.host'] = 'preview.site.com'
+      pages(:home).should render(page_grandchildren_each_tags(%{by="title"})).as('a article article-2 article-3 article-4 b c child child-2 child-3 d e f g guests h i j ').on('dev.site.com')
+    end
+
+    describe 'with paginated="true"' do
+      it 'should limit correctly the result set' do
+        page(:home)
+        page.pagination_parameters = {:page => 1, :per_page => 20}
+        page.should render(page_grandchildren_each_tags(%{paginated="true"})).as('article article-2 article-3 article-4 a b c d e f g h i j child child-3 child-2 guests ')
+        page.should render(page_grandchildren_each_tags(%{paginated="true" per_page="2"})).not_matching(/article article-2 article-3/)
+      end
+      it 'should display a pagination control block' do
+        page(:home)
+        page.pagination_parameters = {:page => 1, :per_page => 1}
+        page.should render(page_grandchildren_each_tags(%{ paginated="true"})).matching(/div class="pagination"/)
+      end
+      it 'should link to the correct paginated page' do
+        page(:home)
+        page.pagination_parameters = {:page => 1, :per_page => 1}
+        page.should render('<r:find path="/"><r:grandchildren:each paginated="true"><r:slug /> </r:grandchildren:each></r:find>').matching(%r{href="/\?page=2})
+      end
+      it 'should pass through selected will_paginate parameters' do
+        page(:home)
+        page.pagination_parameters = {:page => 5, :per_page => 1}
+        page.should render(page_grandchildren_each_tags(%{ paginated="true" separator="not that likely a choice"})).matching(/not that likely a choice/)
+        page.should render(page_grandchildren_each_tags(%{ paginated="true" previous_label="before"})).matching(/before/)
+        page.should render(page_grandchildren_each_tags(%{ paginated="true" next_label="after"})).matching(/after/)
+        page.should render(page_grandchildren_each_tags(%{ paginated="true" inner_window="1" outer_window="0"})).not_matching(/\?p=2/)
+      end
+    end
+  
+    it 'should error with invalid "limit" attribute' do
+      message = "`limit' attribute must be a positive number"
+      pages(:home).should render(page_grandchildren_each_tags(%{limit="a"})).with_error(message)
+      pages(:home).should render(page_grandchildren_each_tags(%{limit="-10"})).with_error(message)
+    end
+
+    it 'should error with invalid "offset" attribute' do
+      message = "`offset' attribute must be a positive number"
+      pages(:home).should render(page_grandchildren_each_tags(%{offset="a"})).with_error(message)
+      pages(:home).should render(page_grandchildren_each_tags(%{offset="-10"})).with_error(message)
+    end
+
+    it 'should error with invalid "by" attribute' do
+      message = "`by' attribute of `each' tag must be set to a valid field name"
+      pages(:home).should render(page_grandchildren_each_tags(%{by="non-existant-field"})).with_error(message)
+    end
+
+    it 'should error with invalid "order" attribute' do
+      message = %{`order' attribute of `each' tag must be set to either "asc" or "desc"}
+      pages(:home).should render(page_grandchildren_each_tags(%{order="asdf"})).with_error(message)
+    end
+
+    it "should limit the number of children when given a 'limit' attribute" do
+      pages(:home).should render(page_grandchildren_each_tags(%{limit="5"})).as('article article-2 article-3 article-4 a ')
+    end
+
+    it "should limit and offset the children when given 'limit' and 'offset' attributes" do
+      pages(:home).should render(page_grandchildren_each_tags(%{offset="3" limit="5"})).as('article-4 a b c d ')
+    end
+
+    it "should sort by the 'by' attribute" do
+      pages(:home).should render(page_grandchildren_each_tags(%{by="breadcrumb"})).as('f article article-2 article-3 article-4 e d child child-2 child-3 c b a j guests i h g ')
+    end
+
+    it "should sort by the 'by' attribute according to the 'order' attribute" do
+      pages(:home).should render(page_grandchildren_each_tags(%{by="breadcrumb" order="desc"})).as('g h i guests j a b c child-3 child-2 child d e article-4 article-3 article-2 article f ')
+    end
+
+    describe 'with "status" attribute' do
+      it "set to 'draft' should list only children with 'draft' status" do
+        pages(:home).should render(page_grandchildren_each_tags(%{status="draft"})).as('draft draft-article ')
+      end
+
+      it "set to 'published' should list only children with 'draft' status" do
+        pages(:home).should render(page_grandchildren_each_tags(%{status="published"})).as('article article-2 article-3 article-4 a b c d e f g h i j child child-3 child-2 guests ')
+      end
+
+      it "set to an invalid status should render an error" do
+        pages(:home).should render(page_grandchildren_each_tags(%{status="askdf"})).with_error("`status' attribute of `each' tag must be set to a valid status")
+      end
+    end
+  end
+
+  describe "<r:grandchildren:each:if_first>" do
+    it "should render for the first child" do
+      tags = '<r:grandchildren:each><r:if_first>FIRST:</r:if_first><r:slug /> </r:grandchildren:each>'
+      expected = "FIRST:article article-2 article-3 article-4 a b c d e f g h i j child child-3 child-2 guests "
+      page(:home).should render(tags).as(expected)
+    end
+  end
+
+  describe "<r:grandchildren:each:unless_first>" do
+    it "should render for all but the first child" do
+      tags = '<r:grandchildren:each><r:unless_first>NOT-FIRST:</r:unless_first><r:slug /> </r:grandchildren:each>'
+      expected = "article NOT-FIRST:article-2 NOT-FIRST:article-3 NOT-FIRST:article-4 NOT-FIRST:a NOT-FIRST:b NOT-FIRST:c NOT-FIRST:d NOT-FIRST:e NOT-FIRST:f NOT-FIRST:g NOT-FIRST:h NOT-FIRST:i NOT-FIRST:j NOT-FIRST:child NOT-FIRST:child-3 NOT-FIRST:child-2 NOT-FIRST:guests "
+      page(:home).should render(tags).as(expected)
+    end
+  end
+
+  describe "<r:grandchildren:each:if_last>" do
+    it "should render for the last child" do
+      tags = '<r:grandchildren:each><r:if_last>LAST:</r:if_last><r:slug /> </r:grandchildren:each>'
+      expected = "article article-2 article-3 article-4 a b c d e f g h i j child child-3 child-2 LAST:guests "
+      page(:home).should render(tags).as(expected)
+    end
+  end
+
+  describe "<r:grandchildren:each:unless_last>" do
+    it "should render for all but the last child" do
+      tags = '<r:grandchildren:each><r:unless_last>NOT-LAST:</r:unless_last><r:slug /> </r:grandchildren:each>'
+      expected = "NOT-LAST:article NOT-LAST:article-2 NOT-LAST:article-3 NOT-LAST:article-4 NOT-LAST:a NOT-LAST:b NOT-LAST:c NOT-LAST:d NOT-LAST:e NOT-LAST:f NOT-LAST:g NOT-LAST:h NOT-LAST:i NOT-LAST:j NOT-LAST:child NOT-LAST:child-3 NOT-LAST:child-2 guests "
+      page(:home).should render(tags).as(expected)
+    end
+  end
+
+  describe "<r:grandchildren:each:header>" do
+    it "should render the header when it changes" do
+      tags = '<r:grandchildren:each><r:header>[<r:date format="%b/%y" />] </r:header><r:slug /> </r:grandchildren:each>'
+      expected = "[Dec/00] article [Feb/01] article-2 article-3 [Mar/01] article-4 [Jun/11] a b c d e f g h i j child child-3 child-2 guests "
+      page(:home).should render(tags).as(expected)
+    end
+
+    it 'with "name" attribute should maintain a separate header' do
+      tags = %{<r:grandchildren:each><r:header name="year">[<r:date format='%Y' />] </r:header><r:header name="month">(<r:date format="%b" />) </r:header><r:slug /> </r:grandchildren:each>}
+      expected = "[2000] (Dec) article [2001] (Feb) article-2 article-3 (Mar) article-4 [2011] (Jun) a b c d e f g h i j child child-3 child-2 guests "
+      page(:home).should render(tags).as(expected)
+    end
+
+    it 'with "restart" attribute set to one name should restart that header' do
+      tags = %{<r:grandchildren:each><r:header name="year" restart="month">[<r:date format='%Y' />] </r:header><r:header name="month">(<r:date format="%b" />) </r:header><r:slug /> </r:grandchildren:each>}
+      expected = "[2000] (Dec) article [2001] (Feb) article-2 article-3 (Mar) article-4 [2011] (Jun) a b c d e f g h i j child child-3 child-2 guests "
+      page(:home).should render(tags).as(expected)
+    end
+
+    it 'with "restart" attribute set to two names should restart both headers' do
+      tags = %{<r:grandchildren:each><r:header name="year" restart="month;day">[<r:date format='%Y' />] </r:header><r:header name="month" restart="day">(<r:date format="%b" />) </r:header><r:header name="day"><<r:date format='%d' />> </r:header><r:slug /> </r:grandchildren:each>}
+      expected = "[2000] (Dec) <01> article [2001] (Feb) <09> article-2 <24> article-3 (Mar) <06> article-4 [2011] (Jun) <05> a b c d e f g h i j child child-3 child-2 guests "
+      page(:home).should render(tags).as(expected)
+    end
+  end
+
+  describe "<r:grandchildren:count>" do
+    it 'should render the number of grandchildren of the current page' do
+      page(:home).should render('<r:grandchildren:count />').as('18')
+    end
+
+    it "should accept the same scoping conditions as <r:children:each>" do
+      page(:home).should render('<r:grandchildren:count status="all" />').as('20')
+      page(:home).should render('<r:grandchildren:count status="draft" />').as('2')
+      page(:home).should render('<r:grandchildren:count status="hidden" />').as('0')
+    end
+  end
+
+  describe "<r:grandchildren:first>" do
+    it 'should render its contents in the context of the first grandchild page' do
+      page(:parent).should render('<r:grandchildren:first:title />').as('Grandchild')
+    end
+
+    it 'should accept the same scoping attributes as <r:children:each>' do
+      page(:home)
+      page.should render(page_grandchildren_first_tags).as('article')
+      page.should render(page_grandchildren_first_tags(%{limit="5"})).as('article')
+      page.should render(page_grandchildren_first_tags(%{offset="3" limit="5"})).as('article-4')
+      page.should render(page_grandchildren_first_tags(%{order="desc" by="published_at"})).as('guests')
+      page.should render(page_grandchildren_first_tags(%{by="breadcrumb"})).as('f')
+      page.should render(page_grandchildren_first_tags(%{by="breadcrumb" order="desc"})).as('g')
+    end
+
+    it "should render nothing when no children exist" do
+      page(:first).should render('<r:grandchildren:first:title />').as('')
+    end
+  end
+
+  describe "<r:grandchildren:last>" do
+    it 'should render its contents in the context of the last child page' do
+      pages(:home).should render('<r:grandchildren:last:title />').as('Guests')
+    end
+
+    it 'should accept the same scoping attributes as <r:children:each>' do
+      page(:home)
+      page.should render(page_grandchildren_last_tags).as('guests')
+      page.should render(page_grandchildren_last_tags(%{limit="5"})).as('a')
+      page.should render(page_grandchildren_last_tags(%{offset="3" limit="5"})).as('d')
+      page.should render(page_grandchildren_last_tags(%{order="desc" by="published_at"})).as('article')
+      page.should render(page_grandchildren_last_tags(%{by="breadcrumb"})).as('g')
+      page.should render(page_grandchildren_last_tags(%{by="breadcrumb" order="desc"})).as('f')
+    end
+
+    it "should render nothing when no grandchildren exist" do
+      page(:first).should render('<r:grandchildren:last:title />').as('')
+    end
+  end
+  
+  private
+
+    def page(symbol = nil)
+      if symbol.nil?
+        @page ||= pages(:assorted)
+      else
+        @page = pages(symbol)
+      end
+    end
+
+    def page_grandchildren_each_tags(attr = nil)
+      attr = ' ' + attr unless attr.nil?
+      "<r:grandchildren:each#{attr}><r:slug /> </r:grandchildren:each>"
+    end
+
+    def page_grandchildren_first_tags(attr = nil)
+      attr = ' ' + attr unless attr.nil?
+      "<r:grandchildren:first#{attr}><r:slug /></r:grandchildren:first>"
+    end
+
+    def page_grandchildren_last_tags(attr = nil)
+      attr = ' ' + attr unless attr.nil?
+      "<r:grandchildren:last#{attr}><r:slug /></r:grandchildren:last>"
+    end
+end

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+progress
+--loadby
+mtime
+--reverse

data/spec/spec_helper.rb

@@ -0,0 +1,36 @@
+unless defined? RADIANT_ROOT
+  ENV["RAILS_ENV"] = "test"
+  case
+  when ENV["RADIANT_ENV_FILE"]
+    require ENV["RADIANT_ENV_FILE"]
+  when File.dirname(__FILE__) =~ %r{vendor/radiant/vendor/extensions}
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../../")}/config/environment"
+  else
+    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../")}/config/environment"
+  end
+end
+require "#{RADIANT_ROOT}/spec/spec_helper"
+
+Dataset::Resolver.default << (File.dirname(__FILE__) + "/datasets")
+
+if File.directory?(File.dirname(__FILE__) + "/matchers")
+  Dir[File.dirname(__FILE__) + "/matchers/*.rb"].each {|file| require file }
+end
+
+Spec::Runner.configure do |config|
+  # config.use_transactional_fixtures = true
+  # config.use_instantiated_fixtures  = false
+  # config.fixture_path = RAILS_ROOT + '/spec/fixtures'
+
+  # You can declare fixtures for each behaviour like this:
+  #   describe "...." do
+  #     fixtures :table_a, :table_b
+  #
+  # Alternatively, if you prefer to declare them only once, you can
+  # do so here, like so ...
+  #
+  #   config.global_fixtures = :table_a, :table_b
+  #
+  # If you declare global fixtures, be aware that they will be declared
+  # for all of your examples, even those that don't use them.
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification 
+name: radiant-grandchildren_tags-extension
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Benny Degezelle
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-05 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Makes Radiant better by adding grandchildren_tags!
+email: 
+- benny@gorilla-webdesign.be
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- config/locales/en.yml
+- cucumber.yml
+- grandchildren_tags_extension.rb
+- lib/grandchildren_tags.rb
+- lib/radiant-grandchildren_tags-extension/version.rb
+- lib/radiant-grandchildren_tags-extension.rb
+- lib/tasks/grandchildren_tags_extension_tasks.rake
+- radiant-grandchildren_tags-extension.gemspec
+- Rakefile
+- README.md
+- spec/datasets/grandchildren_dataset.rb
+- spec/models/grandchildren_tags_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/jomz/radiant-grandchildren_tags-extension
+licenses: []
+
+post_install_message: "\n  Add this to your radiant project with:\n    config.gem 'radiant-grandchildren_tags-extension', :version => '~>1.0.0'\n  "
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Grandchildren Tags for Radiant CMS
+test_files: 
+- spec/datasets/grandchildren_dataset.rb
+- spec/models/grandchildren_tags_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb