tabulous 1.3.1 → 1.3.2

data/spec/applications/main/rails_4-0-0-beta1/spec/features/tab_path_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+describe 'a tab' do
+
+  include TabHelpers
+
+  before(:each) do
+    use_tab_file %Q{
+      Tabulous.setup do |config|
+
+        config.tabs do
+          [
+            #------------------------------------------------------------------------------------------------------------------------------------------------------#
+            #    TAB NAME         |    DISPLAY TEXT     |    PATH                                                                |    VISIBLE?    |    ENABLED?    #
+            #------------------------------------------------------------------------------------------------------------------------------------------------------#
+            [    :home_tab        ,    'Explanation'    ,    "/"                                                                 ,    true        ,    true        ],
+            [    :galaxies_tab    ,    'Galaxies'       ,    "/galaxies"                                                         ,    true        ,    true        ],
+            [    :stars_tab       ,    'Stars'          ,    controller_name == 'galaxies' ? "/stars" : "/planets"               ,    true        ,    true        ],
+            [    :planets_tab     ,    'Planets'        ,    "/planets"                                                          ,    true        ,    true        ],
+            [    :subtabs_tab     ,    'Subtabs'        ,    "/subtabs/one"                                                      ,    true        ,    true        ],
+            [    :one_subtab      ,    'One'            ,    "/subtabs/one"                                                      ,    true        ,    true        ],
+            [    :two_subtab      ,    'Two'            ,    "/subtabs/two"                                                      ,    true        ,    true        ],
+            [    :three_subtab    ,    'Three'          ,    "/subtabs" + "/three"                                               ,    true        ,    true        ],
+            #------------------------------------------------------------------------------------------------------------------------------------------------------#
+            #    TAB NAME         |    DISPLAY TEXT     |    PATH                                                                |    VISIBLE?    |    ENABLED?    #
+            #------------------------------------------------------------------------------------------------------------------------------------------------------#
+          ]
+        end
+
+        config.actions do
+          [
+            #-------------------------------------------------------------#
+            #    CONTROLLER    |    ACTION          |    TAB              #
+            #-------------------------------------------------------------#
+            [    :home         ,    :all_actions    ,    :home_tab        ],
+            [    :galaxies     ,    :all_actions    ,    :galaxies_tab    ],
+            [    :stars        ,    :all_actions    ,    :stars_tab       ],
+            [    :planets      ,    :all_actions    ,    :planets_tab     ],
+            [    :subtabs      ,    :one            ,    :one_subtab      ],
+            [    :subtabs      ,    :two            ,    :two_subtab      ],
+            [    :subtabs      ,    :three          ,    :three_subtab    ],
+            #-------------------------------------------------------------#
+            #    CONTROLLER    |    ACTION          |    TAB              #
+            #-------------------------------------------------------------#
+          ]
+        end
+
+        config.css.scaffolding = true
+
+      end
+    }
+    visit '/'
+  end
+
+  it 'can be be assigned a path' do
+    click_link 'Galaxies'
+    page.should have_content('Listing galaxies')
+    click_link 'Planets'
+    page.should have_content('Listing planets')
+  end
+
+  it 'can be assigned a path dynamically' do
+    click_link 'Stars'
+    page.should have_content('Listing planets')
+    click_link 'Galaxies'
+    click_link 'Stars'
+    page.should have_content('Listing stars')
+  end
+
+  context 'that is a subtab' do
+    it 'can be be assigned a path' do
+      click_link 'Subtabs'
+      click_link 'Two'
+      page.should have_content('Subtab #2')
+      click_link 'One'
+      page.should have_content('Subtab #1')
+    end
+
+    it 'can be assigned a path dynamically' do
+      visit '/'
+      click_link 'Subtabs'
+      click_link 'Three'
+      page.should have_content('Subtab #3')
+    end
+  end
+
+end

data/spec/applications/main/rails_4-0-0-beta1/spec/features/tab_visible_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+describe 'a tab' do
+
+  include TabHelpers
+
+  before(:each) do
+    use_tab_file %Q{
+      Tabulous.setup do |config|
+
+        config.tabs do
+          [
+            #-------------------------------------------------------------------------------------------------------------------------------#
+            #    TAB NAME         |    DISPLAY TEXT     |    PATH                |    VISIBLE?                             |    ENABLED?    #
+            #-------------------------------------------------------------------------------------------------------------------------------#
+            [    :home_tab        ,    'Explanation'    ,    "/"                 ,    true                                 ,    true        ],
+            [    :galaxies_tab    ,    'Galaxies'       ,    "/galaxies"         ,    true                                 ,    true        ],
+            [    :stars_tab       ,    'Stars'          ,    "/stars"            ,    controller_name =~ /s/               ,    true        ],
+            [    :planets_tab     ,    'Planets'        ,    "/planets"          ,    false                                ,    true        ],
+            [    :subtabs_tab     ,    'Subtabs'        ,    "/subtabs/one"      ,    true                                 ,    true        ],
+            [    :one_subtab      ,    'One'            ,    "/subtabs/one"      ,    true                                 ,    true        ],
+            [    :two_subtab      ,    'Two'            ,    "/subtabs/two"      ,    false                                ,    true        ],
+            [    :three_subtab    ,    'Three'          ,    "/subtabs/three"    ,    !true                                ,    true        ],
+            #-------------------------------------------------------------------------------------------------------------------------------#
+            #    TAB NAME         |    DISPLAY TEXT     |    PATH                |    VISIBLE?                             |    ENABLED?    #
+            #-------------------------------------------------------------------------------------------------------------------------------#
+          ]
+        end
+
+        config.actions do
+          [
+            #-------------------------------------------------------------#
+            #    CONTROLLER    |    ACTION          |    TAB              #
+            #-------------------------------------------------------------#
+            [    :home         ,    :all_actions    ,    :home_tab        ],
+            [    :galaxies     ,    :all_actions    ,    :galaxies_tab    ],
+            [    :stars        ,    :all_actions    ,    :stars_tab       ],
+            [    :planets      ,    :all_actions    ,    :planets_tab     ],
+            [    :subtabs      ,    :one            ,    :one_subtab      ],
+            [    :subtabs      ,    :two            ,    :two_subtab      ],
+            [    :subtabs      ,    :three          ,    :three_subtab    ],
+            #-------------------------------------------------------------#
+            #    CONTROLLER    |    ACTION          |    TAB              #
+            #-------------------------------------------------------------#
+          ]
+        end
+
+        config.css.scaffolding = true
+
+      end
+    }
+    visit '/'
+  end
+
+  it 'can be hidden' do
+    # visible
+    visible_tabs.should include('Explanation')
+    visible_tabs.should include('Galaxies')
+    visible_tabs.should include('Subtabs')
+    # hidden
+    visible_tabs.should_not include('Planets')
+  end
+
+  it 'can be hidden dynamically' do
+    visible_tabs.should_not include('Stars')
+    click_link 'Galaxies'
+    visible_tabs.should include('Stars')
+    click_link 'Stars'
+    visible_tabs.should include('Stars')
+    click_link 'Subtabs'
+    visible_tabs.should include('Stars')
+  end
+
+  context 'that is a subtab' do
+    it 'can be hidden' do
+      click_link 'Subtabs'
+      visible_subtabs.should include('One')
+      visible_subtabs.should_not include('Two')
+    end
+
+    it 'can be hidden dynamically' do
+      click_link 'Subtabs'
+      visible_subtabs.should_not include('Three')
+    end
+  end
+
+end

data/spec/applications/main/rails_4-0-0-beta1/spec/spec_helper.rb

@@ -0,0 +1,38 @@
+# This file is copied to spec/ when you run 'rails generate rspec:install'
+ENV["RAILS_ENV"] ||= 'test'
+require File.expand_path("../../config/environment", __FILE__)
+require 'rspec/rails'
+require 'rspec/autorun'
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[Rails.root.join("spec/support/**/*.rb")].each {|f| require f}
+
+RSpec.configure do |config|
+  # ## Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+
+  # Remove this line if you're not using ActiveRecord or ActiveRecord fixtures
+  config.fixture_path = "#{::Rails.root}/spec/fixtures"
+
+  # If you're not using ActiveRecord, or you'd prefer not to run each of your
+  # examples within a transaction, remove the following line or assign false
+  # instead of true.
+  config.use_transactional_fixtures = true
+
+  # If true, the base class of anonymous controllers will be inferred
+  # automatically. This will be the default behavior in future versions of
+  # rspec-rails.
+  config.infer_base_class_for_anonymous_controllers = false
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = "random"
+end

data/spec/applications/main/rails_4-0-0-beta1/spec/support/should_be_clickable.rb

@@ -0,0 +1,15 @@
+RSpec::Matchers.define :be_clickable do
+  match do |tab_text|
+    clickable_tab = page.all('#tabs li a', :text => tab_text)
+    clickable_subtab = page.all('#subtabs li a', :text => tab_text)
+    !clickable_tab.empty? || !clickable_subtab.empty?
+  end
+
+  failure_message_for_should do |actual|
+    "expected that a tab or subtab with the text '#{tab_text}' would be clickable"
+  end
+
+  failure_message_for_should_not do |actual|
+    "expected that a tab or subtab with the text '#{tab_text}' would not be clickable"
+  end
+end

data/spec/applications/main/rails_4-0-0-beta1/spec/support/tab_helpers.rb

@@ -0,0 +1,51 @@
+module TabHelpers
+
+  def use_tab_file(i)
+    eval i
+  end
+
+  def visible_tabs
+    page.all('#tabs li', :visible => true).map(&:text)
+  end
+
+  def visible_subtabs
+    page.all('#subtabs li', :visible => true).map(&:text)
+  end
+
+  def disabled_tabs
+    page.all('#tabs li.disabled', :visible => true).map(&:text)
+  end
+
+  def disabled_subtabs
+    page.all('#subtabs li.disabled', :visible => true).map(&:text)
+  end
+
+  def enabled_tabs
+    page.all('#tabs li.enabled', :visible => true).map(&:text)
+  end
+
+  def enabled_subtabs
+    page.all('#subtabs li.enabled', :visible => true).map(&:text)
+  end
+
+  def active_tab
+    active_tabs = page.all('#tabs li.active', :visible => true)
+    raise "more than one active tab" if active_tabs.count > 1
+    active_tabs.first.text
+  end
+
+  def active_subtab
+    active_subtabs = page.all('#subtabs li.active', :visible => true)
+    raise "more than one active subtab" if active_subtabs.count > 1
+    active_subtabs.first.text
+  end
+
+  def subtabs_should_be_present
+    page.all('#subtabs', :visible => false).should_not be_empty
+  end
+
+  def subtabs_should_not_be_present
+    page.all('#subtabs', :visible => false).should be_empty
+  end
+
+end

data/spec/applications/main/rails_4-0-0-beta1/test/test_helper.rb

@@ -0,0 +1,14 @@
+ENV["RAILS_ENV"] = "test"
+require 'redgreen' unless RUBY_VERSION >= "1.9"
+require File.expand_path('../../config/environment', __FILE__)
+require 'rails/test_help'
+
+class ActiveSupport::TestCase
+  # Setup all fixtures in test/fixtures/*.(yml|csv) for all tests in alphabetical order.
+  #
+  # Note: You'll currently still have to declare fixtures explicitly in integration tests
+  # -- they do not yet inherit this setting
+  fixtures :all
+
+  # Add more helper methods to be used by all tests here...
+end

data/spec/applications/main/rails_4-0-0-beta1/test/unit/tabs_generator_test.rb

@@ -0,0 +1,14 @@
+require File.expand_path('../test_helper', File.dirname(__FILE__))
+require 'rails/generators'
+require 'generators/tabs/tabs_generator'
+
+class TabsGeneratorTest < Rails::Generators::TestCase
+  tests TabsGenerator
+  destination File.expand_path("../../tmp", File.dirname(__FILE__))
+  setup :prepare_destination
+
+  test "all files are properly created" do
+    run_generator
+    assert_file "app/tabs/tabulous.rb"
+  end
+end

data/spec/applications/main/shared/app/tabs/tabulous.rb

@@ -0,0 +1,158 @@
+# Tabulous gives you an easy way to set up tabs for your Rails application.
+#
+#   1. Configure this file.
+#   2. Add <%= tabs %> and <%= subtabs %> in your layout(s) wherever you want
+#      your tabs to appear.
+#   3. Add styles for these tabs in your stylesheets.
+#   4. Profit!
+
+Tabulous.setup do |config|
+
+  #---------------------------
+  #   HOW TO USE THE TABLES
+  #---------------------------
+  #
+  # The following tables are just an array of arrays.  As such, you can put
+  # any Ruby code into a cell.  For example, you could put "/foo/bar" in
+  # a path cell or you could put "/foo" + "/bar".  You can even wrap up code
+  # in a lambda to be executed later.  These will be executed in the context
+  # of a Rails view meaning they will have access to view helpers.
+  #
+  # However, there is something special about the format of these tables.
+  # Because it would be a pain for you to manually prettify the tables each
+  # time you edit them, there is a special rake task that does this for
+  # you: rake tabs:format.  However, for this prettifier to work properly
+  # you have to follow some special rules:
+  #
+  #   * No comments are allowed between rows.
+  #   * Comments are allowed to the right of rows, except for header rows.
+  #   * The start of a table is signified by a [ all by itself on a line.
+  #   * The end of a table is signified by a ] all by itself on a line.
+  #   * And most importantly: commas that separate cells should be surrounded
+  #     by spaces and commas that are within cells should not.  This gives the
+  #     formatter an easy way to distinguish between cells without having
+  #     to actually parse the Ruby.
+
+  #----------
+  #   TABS
+  #----------
+  #
+  # This is where you define your tabs and subtabs.  The order that the tabs
+  # appear in this list is the order they will appear in your views.  Any
+  # subtabs defined will have the previous tab as their parent.
+  #
+  # TAB NAME
+  #   must end in _tab or _subtab
+  # DISPLAY TEXT
+  #   the text the user sees on the tab
+  # PATH
+  #   the URL that gets sent to the server when the tab is clicked
+  # VISIBLE
+  #   whether to display the tab
+  # ENABLED
+  #   whether the tab is disabled (unclickable)
+
+  config.tabs do
+    [
+      #------------------------------------------------------------------------------------------------------#
+      #    TAB NAME         |    DISPLAY TEXT     |    PATH                |    VISIBLE?    |    ENABLED?    #
+      #------------------------------------------------------------------------------------------------------#
+      [    :home_tab        ,    'Explanation'    ,    "/"                 ,    true        ,    true        ],
+      [    :galaxies_tab    ,    'Galaxies'       ,    "/galaxies"         ,    true        ,    true        ],
+      [    :stars_tab       ,    'Stars'          ,    "/stars"            ,    true        ,    true        ],
+      [    :planets_tab     ,    'Planets'        ,    "/planets"          ,    true        ,    true        ],
+      [    :subtabs_tab     ,    'Subtabs'        ,    "/subtabs/one"      ,    true        ,    true        ],
+      [    :one_subtab      ,    'One'            ,    "/subtabs/one"      ,    true        ,    true        ],
+      [    :two_subtab      ,    'Two'            ,    "/subtabs/two"      ,    true        ,    true        ],
+      [    :three_subtab    ,    'Three'          ,    "/subtabs/three"    ,    true        ,    true        ],
+      #------------------------------------------------------------------------------------------------------#
+      #    TAB NAME         |    DISPLAY TEXT     |    PATH                |    VISIBLE?    |    ENABLED?    #
+      #------------------------------------------------------------------------------------------------------#
+    ]
+  end
+
+  #-------------
+  #   ACTIONS
+  #-------------
+  #
+  # This is where you hook up actions with tabs.  That way tabulous knows
+  # which tab and subtab to mark active when an action is rendered.
+  #
+  # CONTROLLER
+  #   the name of the controller
+  # ACTION
+  #   the name of the action, or :all_actions
+  # TAB
+  #   the name of the tab or subtab that is active when this action is rendered
+
+  config.actions do
+    [
+      #-------------------------------------------------------------#
+      #    CONTROLLER    |    ACTION          |    TAB              #
+      #-------------------------------------------------------------#
+      [    :home         ,    :all_actions    ,    :home_tab        ],
+      [    :galaxies     ,    :all_actions    ,    :galaxies_tab    ],
+      [    :stars        ,    :all_actions    ,    :stars_tab       ],
+      [    :planets      ,    :all_actions    ,    :planets_tab     ],
+      [    :subtabs      ,    :one            ,    :one_subtab      ],
+      [    :subtabs      ,    :two            ,    :two_subtab      ],
+      [    :subtabs      ,    :three          ,    :three_subtab    ],
+      #-------------------------------------------------------------#
+      #    CONTROLLER    |    ACTION          |    TAB              #
+      #-------------------------------------------------------------#
+    ]
+  end
+
+  #-------------
+  #   OPTIONS
+  #-------------
+
+  # By default, you cannot click on the active tab.
+  config.active_tab_clickable = false
+
+  # By default, the subtabs HTML element is not rendered if it is empty.
+  config.always_render_subtabs = false
+
+  # Tabulous expects every controller action to be associated with a tab.
+  # When an action does not have an associated tab (or subtab), you can
+  # instruct tabulous how to behave:
+  config.when_action_has_no_tab = :raise_error      # the default behavior
+  # config.when_action_has_no_tab = :do_not_render  # no tab navigation HTML will be generated
+  # config.when_action_has_no_tab = :render         # the tab navigation HTML will be generated,
+                                                    # but no tab or subtab will be active
+
+  # By default, div elements are used in the tab markup.  When html5 is
+  # true, nav elements are used instead.
+  config.html5 = false
+
+  #------------
+  #   STYLES
+  #------------
+  #
+  # The markup that is generated has the following properties:
+  #
+  #   Tabs and subtabs that are selected have the class "active".
+  #   Tabs and subtabs that are not selected have the class "inactive".
+  #   Tabs that are disabled have the class "disabled"; otherwise, "enabled".
+  #   Tabs that are not visible do not appear in the markup at all.
+  #
+  # These classes are provided to make it easier for you to create your
+  # own CSS (and JavaScript) for the tabs.
+
+  # Some styles will be generated for you to get you off to a good start.
+  # Scaffolded styles are not meant to be used in production as they
+  # generate invalid HTML markup.  They are merely meant to give you a
+  # head start or an easy way to prototype quickly.
+  #
+  config.css.scaffolding = true
+
+  # You can tweak the colors of the generated CSS.
+  #
+  # config.css.background_color = '#ccc'
+  # config.css.text_color = '#444'
+  # config.css.active_tab_color = 'white'
+  # config.css.hover_tab_color = '#ddd'
+  # config.css.inactive_tab_color = '#aaa'
+  # config.css.inactive_text_color = '#888'
+
+end