mariner 0.0.2 → 0.0.3

data/README.md

@@ -48,7 +48,8 @@ After creating your nav, render it in your views with:
 
     <%= render_navigation :topbar %>
 
-See Mariner::Helper for usage on `render_navigation`.
+See Mariner::Helper for usage on `#render_navigation`. See also
+`#render_navigations` and `#render_sub_navigations`.
 
 ## Contributing
 

data/lib/mariner/helper.rb

@@ -1,3 +1,5 @@
+require 'active_support/core_ext/array/extract_options'
+
 module Mariner
 
   # Public: Gets included in controllers (see the Railtie)
@@ -41,6 +43,9 @@ module Mariner
     #     render_navigation :a_group, FakeRenderingStrategy.new
     #     #=> renders `a_group` with a FakeRenderingStrategy instance
     #
+    #     render_navigation :a_group, :other_strategy
+    #     #=> renders `a_group` with Mariner.rendering_strategies[:other_strategy]
+    #
     def render_navigation(config_path=nil, renderer=nil)
       target   = target_from_path(config_path)
       strategy = rendering_strategy_from(renderer)
@@ -63,10 +68,10 @@ module Mariner
     #       end
     #     end
     #
-    #     render_navigations
+    #     render_sub_navigations
     #     #=> renders the group_a and group_b trees and joins the result
     #
-    def render_navigations(config_path=nil, renderer=nil)
+    def render_sub_navigations(config_path=nil, renderer=nil)
       target = target_from_path(config_path)
       strategy = rendering_strategy_from(renderer)
 
@@ -76,6 +81,38 @@ module Mariner
       end.join
     end
 
+    # Public: For when you want to render multiple specific nav trees
+    #
+    # *args - A comma separated list of groups to render. The last argument
+    # may be an options hash. Options:
+    #
+    # - :rendering_strategy - A symbol, class, or object to use for rendering.
+    # See #render_navigation for details.
+    #
+    # Examples:
+    #
+    #     Mariner.configure do
+    #       group_a do
+    #         root_path "Home"
+    #
+    #         sub_group do
+    #           products_path "Products"
+    #         end
+    #       end
+    #
+    #       group_b do
+    #         users_path "Manage Users"
+    #       end
+    #     end
+    #
+    #     render_navigations 'group_a/sub_group', :group_b
+    #     render_navigations :group_a, :group_b, :rendering_strategy => :different_strategy
+    #
+    def render_navigations(*args)
+      renderer = args.extract_options![:rendering_strategy]
+      args.map { |target_path| render_navigation(*[target_path, renderer].compact) }.join
+    end
+
     private
 
     def target_from_path(config_path)

data/lib/mariner/railtie.rb

@@ -12,7 +12,7 @@ module Mariner
 
       ActiveSupport.on_load(:action_controller) do
         include Mariner::Helper
-        helper_method :render_navigation, :render_navigations
+        helper_method :render_navigation, :render_navigations, :render_sub_navigations
       end
     end
 

data/lib/mariner/version.rb

@@ -1,3 +1,3 @@
 module Mariner
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/spec/navigation/helper_spec.rb

@@ -97,7 +97,7 @@ module Mariner
 
     end
 
-    describe "#render_navigations" do
+    describe "#render_sub_navigations" do
 
       before do
         Mariner.configure do
@@ -121,7 +121,44 @@ module Mariner
           entity.should_receive(:render)
         end
 
-        render_navigations
+        render_sub_navigations
+      end
+
+    end
+
+    describe "#render_navigations" do
+
+      before do
+        Mariner.configure do
+          group_one {}
+          group_two do
+            sub_group {}
+          end
+          group_three {}
+        end
+
+      end
+
+      context "without rendering options" do
+
+        it "renders each navigation given" do
+          helper.should_receive(:render_navigation).with('group_two/sub_group').once.ordered
+          helper.should_receive(:render_navigation).with(:group_three).once.ordered
+
+          helper.render_navigations 'group_two/sub_group', :group_three
+        end
+
+      end
+
+      context "with rendering options" do
+
+        it "renders each navigation with the specified renderer" do
+          helper.should_receive(:render_navigation).with('group_two/sub_group', :default).once.ordered
+          helper.should_receive(:render_navigation).with(:group_three, :default).once.ordered
+
+          helper.render_navigations 'group_two/sub_group', :group_three, :rendering_strategy => :default
+        end
+
       end
 
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mariner
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-24 00:00:00.000000000 Z
+date: 2012-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: abyss
-  requirement: &70198988231340 !ruby/object:Gem::Requirement
+  requirement: &70093358817540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70198988231340
+  version_requirements: *70093358817540
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &70198984120560 !ruby/object:Gem::Requirement
+  requirement: &70093358817040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,7 +33,7 @@ dependencies:
         version: 3.2.0
   type: :runtime
   prerelease: false
-  version_requirements: *70198984120560
+  version_requirements: *70093358817040
 description: A DSL for creating navigation structures based on the Rails routing table
   using Abyss.
 email: