your_platform 0.0.1 → 0.0.2

data/spec/models/may_need_review_spec.rb

@@ -0,0 +1,114 @@
+require 'spec_helper'
+
+describe "MayNeedReview: " do
+  
+  describe "ProfileField" do
+    
+    before do
+      @profile_field = ProfileField.create
+    end
+    
+    describe "#needs_review?" do
+      subject { @profile_field.needs_review? }
+      describe "if set to true" do
+        before { @profile_field.needs_review = true }
+        it { should == true }
+      end
+      describe "if set to false" do
+        before { @profile_field.needs_review = false }
+        it { should == false }
+      end
+      describe "by default" do
+        it { should == false }
+      end
+    end
+    
+    describe "#needs_review" do
+      subject { @profile_field.needs_review }
+      describe "if set to true" do
+        before { @profile_field.needs_review = true }
+        it { should == true }
+      end
+      describe "if set to false" do
+        before { @profile_field.needs_review = false }
+        it { should == false }
+      end
+      describe "by default" do
+        it { should == false }
+      end
+    end
+    
+    describe "#needs_review = true" do
+      subject { @profile_field.needs_review = true }
+      it "should persist" do
+        @profile_field.needs_review?.should == false
+        subject
+        @profile_field.reload.needs_review?.should == true
+      end
+    end
+  
+    describe "#needs_review = false" do
+      before { @profile_field.needs_review = true}
+      subject { @profile_field.needs_review = false }
+      it "should persist" do
+        @profile_field.needs_review?.should == true
+        subject
+        @profile_field.reload.needs_review?.should == false
+      end
+    end
+    
+    describe "#needs_review!" do
+      subject { @profile_field.needs_review! }
+      it "should set needs_review? to true" do
+        @profile_field.needs_review?.should == false
+        subject
+        @profile_field.needs_review?.should == true
+      end
+      it "should persist" do
+        @profile_field.needs_review?.should == false
+        subject
+        @profile_field.reload.needs_review?.should == true
+      end
+    end
+    
+    describe ".find_all_that_need_review" do
+      before do
+        @another_profile_field = ProfileField.create
+        @profile_field.needs_review!
+      end
+      subject { ProfileField.find_all_that_need_review }
+      it "should include the profile fields that need review" do
+        subject.should include @profile_field
+      end
+      it "should not include the profile fields that do not need review" do
+        subject.should_not include @another_profile_field
+      end
+    end
+    
+    describe ".find_all_that_need_review_by_profile_field_ids" do
+      before do
+        @another_profile_field = ProfileField.create
+        @yet_another_profile_field = ProfileField.create
+        @yet_another_profile_field.needs_review!
+        @profile_field.needs_review!
+        @ids = [@profile_field.id, @another_profile_field.id]
+      end
+      subject { ProfileField.find_all_that_need_review_by_profile_field_ids(@ids) }
+      it "should include the profile fields that match the ids and need review" do
+        subject.should include @profile_field
+      end
+      it "should not include the profile fields that do not need review" do
+        subject.should_not include @another_profile_field
+      end
+      it "should not include the profile fields that do not match the ids" do
+        subject.should_not include @yet_another_profile_field
+      end
+    end
+  end
+  
+  describe "UserGroupMembership" do
+    subject { UserGroupMembership.new }
+    it { should respond_to :needs_review?, :needs_review!, :needs_review, :needs_review= }
+  end
+  
+end

data/spec/models/nav_node_spec.rb

@@ -0,0 +1,277 @@
+require 'spec_helper'
+
+describe NavNode do
+  before do
+    # Since Users, Pages, Groups, etc. are Navables, i.e. have NavNodes associated,
+    # we here just pick the NavNode of a Page.
+    @page = create(:page, title: "My Page")
+    @nav_node = @page.nav_node
+    @nav_node.save
+  end
+  subject { @nav_node }
+  
+  describe "#url_component" do
+    subject { @nav_node.url_component }
+    describe "for no url_component set" do
+      it "should use the navable's title for generation" do
+        subject.should == "my-page/"
+      end
+    end
+    describe "for a url_component set" do
+      before do
+        @nav_node.url_component = "foo/"
+      end
+      it "should use the customized setting" do
+        subject.should == "foo/"
+      end
+    end
+  end
+  describe "#url_component=" do
+    subject { @nav_node.url_component = "foo/" }
+    it "should override the default setting" do
+      @nav_node.url_component.should_not == "foo/"
+      subject
+      @nav_node.url_component.should == "foo/"
+    end
+    it "should persist after saving" do
+      @nav_node.url_component.should_not == "foo/"
+      subject
+      @nav_node.save
+      @reloaded_nav_node = NavNode.find(@nav_node.id)
+      @reloaded_nav_node.url_component.should == "foo/"
+    end
+  end
+  
+  describe "#breadcrumb_item" do
+    subject { @nav_node.breadcrumb_item }
+    describe "for no breadcrumb_item set" do
+      it "should use the navable's title for generation" do
+        subject.should == "My Page"
+      end
+    end
+    describe "for a breadcrumb_item set" do
+      before do
+        @nav_node.breadcrumb_item = "Foo"
+      end
+      it "should use the customized setting" do
+        subject.should == "Foo"
+      end
+    end
+  end
+  describe "#breadcrumb_item=" do
+    subject { @nav_node.breadcrumb_item = "Foo" }
+    it "should override the default setting" do
+      @nav_node.breadcrumb_item.should_not == "Foo"
+      subject
+      @nav_node.breadcrumb_item.should == "Foo"
+    end
+    it "should persist after saving" do
+      @nav_node.breadcrumb_item.should_not == "Foo"
+      subject
+      @nav_node.save
+      @reloaded_nav_node = NavNode.find(@nav_node.id)
+      @reloaded_nav_node.breadcrumb_item.should == "Foo"
+    end
+  end
+  
+  describe "#menu_item" do
+    subject { @nav_node.menu_item }
+    describe "for no menu_item set" do
+      it "should use the navable's title for generation" do
+        subject.should == "My Page"
+      end
+    end
+    describe "for a menu_item set" do
+      before do
+        @nav_node.menu_item = "Foo"
+      end
+      it "should use the customized setting" do
+        subject.should == "Foo"
+      end
+    end
+  end
+  describe "#menu_item=" do
+    subject { @nav_node.menu_item = "Foo" }
+    it "should override the default setting" do
+      @nav_node.menu_item.should_not == "Foo"
+      subject
+      @nav_node.menu_item.should == "Foo"
+    end
+    it "should persist after saving" do
+      @nav_node.menu_item.should_not == "Foo"
+      subject
+      @nav_node.save
+      @reloaded_nav_node = NavNode.find(@nav_node.id)
+      @reloaded_nav_node.menu_item.should == "Foo"
+    end
+  end
+    
+  describe "#hidden_menu" do
+    subject { @nav_node.hidden_menu }
+    describe "for the setting being overridden" do
+      it "should return the forced setting" do
+        @nav_node.hidden_menu = true
+        @nav_node.hidden_menu.should == true
+        @nav_node.hidden_menu = false
+        @nav_node.hidden_menu.should == false
+      end
+    end
+    describe "for Pages, by default" do
+      before { @nav_node = create(:page).nav_node }
+      it { should == false }
+    end
+    describe "for Groups, by default" do
+      before { @nav_node = create(:group).nav_node }
+      it { should == false }
+    end
+    describe "for :officers_parent groups, by default" do
+      before { @nav_node = create(:group).find_or_create_officers_parent_group.nav_node }
+      it { should == true }
+    end
+    describe "for Users, by default" do
+      before { @nav_node = create(:user).nav_node }
+      it { should == true }
+    end
+    describe "for Events, by default" do
+      before { @nav_node = create(:event).nav_node }
+      it { should == true }
+    end
+    # 
+    # TODO: Later, when Workflows are Navables, use this:
+    #
+    # describe "for Workflows, by default" do
+    #   before { @nav_node = create(:workflow).nav_node }
+    #   it { should == true }
+    # end
+    # 
+    # For the moment:
+    #
+    describe "for Workflows, by default" do
+      specify "Workflows are not Navable at the moment, thus do not respond to #nav_node" do
+        create(:workflow).should_not respond_to :nav_node
+      end
+    end
+  end
+  
+  describe "#slim_breadcrumb" do
+    subject { @nav_node.slim_breadcrumb }
+    describe "for being set to true" do
+      before { @nav_node.slim_breadcrumb = true }
+      it { should == true }
+    end
+    describe "for being set to false" do
+      before { @nav_node.slim_breadcrumb = false }
+      it { should == false }
+    end
+    describe "for not being set" do
+      it { should == false }
+    end
+  end
+  
+  describe "(route methods)" do
+    before do
+      @root_page = create(:page, title: "Example.com")
+      @root_page.nav_node.update_attribute(:url_component, "http://example.com/")
+      @products_page = create(:page, title: "Products")
+      @products_page.parent_pages << @root_page
+      @phones_page = create(:page, title: "Phones")
+      @phones_page.parent_pages << @products_page
+      
+      @nav_node = @phones_page.nav_node
+    end
+  
+    describe "#url" do
+      subject { @nav_node.url }
+      it "should return the joined url" do
+        subject.should == "http://example.com/products/phones"
+      end
+      it "should remove the trailing slash (/)" do
+        subject.should_not end_with "/"
+      end
+    end
+  
+    describe "#breadcrumbs" do
+      subject { @nav_node.breadcrumbs }
+      it "should return an Array of Hashes" do
+        subject.should be_kind_of Array
+        subject.first.should be_kind_of Hash
+      end
+      specify "the Hash's attributes :title, :navable and :slim should be set" do
+        subject.first[:title].should_not == nil
+        subject.first[:navable].should_not == nil
+        subject.first[:slim].should_not == nil        
+      end
+      it { should == [ {title: "Example.com", navable: @root_page, slim: false},
+                       {title: "Products", navable: @products_page, slim: false},
+                       {title: "Phones", navable: @phones_page, slim: false} ] }
+    end
+  
+    describe "#ancestor_navables" do
+      subject { @nav_node.ancestor_navables }
+      it "should return the navable ancestors of the NavNode's Navable" do
+        subject.should == [ @root_page, @products_page ]
+      end
+      describe "for the ancestors' ids not being in an ascending order matching the hierarchy" do
+        before do
+          
+          # The @products_page is created before the @root_page on purpose.
+          #
+          @products_page = create(:page, title: "Products") 
+          @root_page = create(:page, title: "Example.com")
+          @root_page.nav_node.update_attribute(:url_component, "http://example.com/")
+          @products_page.parent_pages << @root_page
+          @phones_page = create(:page, title: "Phones")
+          @phones_page.parent_pages << @products_page
+      
+          @nav_node = @phones_page.nav_node
+        end
+        it "should return the navable ancestors of the NavNode's Navable" do
+          subject.should == [ @root_page, @products_page ]
+        end
+        describe "for ambiguous routes" do
+          before do
+            @other_ancestor_page = create(:page)
+            @phones_page.parent_pages << @other_ancestor_page
+            @nav_node = @phones_page.nav_node
+          end
+          it "should list only the first route" do
+            #
+            #   @root_page
+            #       |
+            #   @products_page   @other_ancestor_page
+            #              |       |
+            #             @phones_page
+            #
+            @phones_page.ancestors.should include @root_page, @products_page, @other_ancestor_page
+            subject.should include @root_page, @products_page
+            subject.should_not include @other_ancestor_page
+          end
+        end
+      end
+    end
+
+    describe "#ancestor_navables_and_own" do
+      it { should = [ @root_page, @products_page, @phone_page ] }
+    end 
+
+    describe "#ancestor_nodes" do
+      subject { @nav_node.ancestor_nodes }
+      it "should be an Array of NavNodes" do
+        subject.should be_kind_of Array
+        subject.first.should be_kind_of NavNode
+      end
+      it "should return the NavNodes of the Navable's ancestors" do
+        # use .to_s since these are, in fact, different objects in memory.
+        subject.to_s.should == [ @root_page.nav_node, @products_page.nav_node ].to_s
+      end
+    end
+    
+    describe "#ancestor_nodes_and_self" do
+      subject { @nav_node.ancestor_nodes_and_self }
+      it "should return an Array of the ancestor_nodes plus this NavNode as the last element" do
+        subject.to_s.should == [ @root_page.nav_node, @products_page.nav_node, @nav_node ].to_s
+      end
+    end
+    
+  end
+end

data/spec/models/navable_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+unless ActiveRecord::Migration.table_exists? :my_structureables
+  ActiveRecord::Migration.create_table :my_structureables do |t|
+    t.string :name
+  end
+end
+
+describe Navable do
+  
+  before do
+    class MyStructureable < ActiveRecord::Base
+      attr_accessible :name
+      is_structureable( ancestor_class_names: %w(MyStructureable),
+                        descendant_class_names: %w(MyStructureable Group User Workflow Page) )
+      is_navable
+    end
+
+    @my_structureable = MyStructureable.create( name: "My Structureable" )
+  end
+
+  describe "#navable_children" do
+    before do
+      @workflow = create(:workflow)
+      @user = create(:user)
+      @page = create(:page)
+      @group = create(:group)
+      @my_structureable.child_users << @user 
+      @my_structureable.child_pages << @page
+      @my_structureable.child_groups << @group 
+      @my_structureable.child_workflows << @workflow
+    end
+    subject { @my_structureable.navable_children }
+    
+    specify "prerequisites" do
+      @my_structureable.children.should include @user, @page, @group, @workflow
+    end
+    it "should include only navable children" do
+      subject.each do |child|
+        child.should respond_to :nav_node
+      end
+    end
+    it "should include pages, users and groups" do
+      subject.should include @page, @user, @group
+    end
+
+    # TODO: Maybe, later, Workflow objects become navables.
+    # Then, this spec has to be changed accordingly.
+    it "should not include workflows" do 
+      subject.should_not include @workflow
+    end
+  end
+  
+end

data/spec/models/page_spec.rb

@@ -0,0 +1,185 @@
+require 'spec_helper'
+
+describe Page do
+
+  def create_page_structure
+    Page.destroy_all # in case there are already pages defined elsewhere
+    @root = create( :page, title: "Root" )
+    @intranet_root = create( :page, title: "Intranet Root" )
+    @some_page = create( :page, title: "Some Page" )
+
+    @intranet_root.add_flag( :intranet_root )
+
+    @root.child_pages << @intranet_root
+    @root.add_flag( :root )
+    @intranet_root.child_pages << @some_page
+  end
+
+  subject { create( :page ) }
+
+
+  # General Properties
+  # ----------------------------------------------------------------------------------------------------
+
+  it { should respond_to( :content, :content=, :title, :title= ) }
+
+  it "should be structureable" do
+    subject.should respond_to( :parents, :children, :ancestors, :descendants )
+  end
+
+  it "should be navable" do
+    subject.should respond_to( :nav_node )
+  end
+
+  it "should have attachments" do
+    subject.should respond_to( :attachments )
+    subject.attachments.should == []
+  end
+  
+
+  # Quick Assignment of Children
+  # ----------------------------------------------------------------------------------------------------
+  
+  describe "#<<" do
+    before { @page = create(:page) }
+    subject { @page << @object_to_add }
+    
+    describe "( page )" do
+      before { @object_to_add = create(:page) }
+      before { subject }
+      it "should add the other page as a child" do
+        @page.children.should include @object_to_add
+      end
+    end
+    
+    describe "( blog_post )" do
+      before { @object_to_add = create(:blog_post) }
+      before { subject }
+      it "should add the blog post as a child" do
+        @page.children.should include @object_to_add
+      end
+    end
+    
+    describe "( group )" do
+      before { @object_to_add = create(:group) }
+      before { subject }
+      it "should add the group as a child" do
+        @page.children.should include @object_to_add
+      end
+    end
+    
+    describe "adding an object that is already a descendant" do
+      #
+      #  @group
+      #     |----- @page
+      #     |        |
+      #     |        | <----------------- this relation is added
+      #     |        |
+      #     |----- @object_to_add
+      #
+      before do
+        @object_to_add = create(:page)
+        @group = create(:group)
+        @group.child_pages << @object_to_add
+        @page = create(:page)
+        @page.parent_groups << @group
+      end
+      before { subject }
+      it "should add the object as a direct child" do
+        @page.children.should include @object_to_add
+      end
+      it "should not unassign the object of the group" do
+        @group.children.should include @object_to_add
+      end
+    end
+  end
+
+
+  # Redirection
+  # ----------------------------------------------------------------------------------------------------
+
+  describe "#redirect_to" do
+    before { @page = create(:page) }
+    subject { @page.redirect_to }
+    describe "for urls with given protocol" do
+      before { @page.redirect_to = "http://example.com" }
+      it "should return the url" do
+        subject.should == "http://example.com"
+      end
+    end
+    describe "for controller#action strings" do
+      before { @page.redirect_to = "users#index" }
+      it "should return a Hash with controller and index" do
+        subject.should == { controller: "users", action: "index" }
+      end
+    end
+  end
+
+  describe "#redirect_to=" do
+    before { @page = create(:page) }
+    subject { @page.redirect_to = @redirect_to }
+    describe "for setting it to a url with protocol" do
+      before { @redirect_to = "http://example.com" }
+      it "should store the url" do
+        subject
+        @page.read_attribute(:redirect_to).should == @redirect_to
+      end
+      it "should retrieve the url unchanged" do
+        subject
+        @page.redirect_to.should == @redirect_to
+      end
+    end
+    describe "for setting it to a controller#action string" do
+      before { @redirect_to = "users#index" }
+      it "should store the controller#action string" do
+        subject
+        @page.read_attribute(:redirect_to).should == @redirect_to
+      end
+      it "should retrieve a Hash with controller and action" do
+        subject
+        @page.redirect_to.should == { controller: "users", action: "index" }
+      end
+    end
+    describe "for setting it to a Hash with controller and action" do
+      before { @redirect_to = { controller: "users", action: "index" } }
+      it "should retrieve it as a Hash with controller and action" do
+        subject
+        @page.redirect_to.should == @redirect_to
+      end
+    end
+  end
+
+
+  # Association Related Methods
+  # ----------------------------------------------------------------------------------------------------
+
+  describe "#attachments_by_type" do
+    it "should be the same as #attachments.find_by_type" do
+      type = "image"
+      subject.attachments_by_type( type ).should == subject.attachments.find_by_type( type )
+    end
+  end
+
+
+  # Finder Methods
+  # ----------------------------------------------------------------------------------------------------
+
+  describe "#find_root" do
+    before { create_page_structure }
+    subject { Page.find_root }
+
+    it "should return the root page" do
+      subject.should == @root
+    end
+  end
+
+  describe "#find_intranet_root" do
+    before { create_page_structure }
+    subject { Page.find_intranet_root }
+
+    it "should return the intranet root page" do
+      subject.should == @intranet_root
+    end
+  end
+
+end