tabulous 0.0.1

data/lib/tabulous/tabulous.rb

@@ -0,0 +1,162 @@
+module Tabulous
+
+  def self.setup
+    yield self
+  end
+  
+  def self.tabs=(ary)
+    @@tabs = []
+    last_tab = nil
+    ary.each do |tab_args|
+      begin
+        tab = Tab.new(*tab_args)
+      rescue ArgumentError
+        raise ColumnError,
+              "Your config.tabs table is improperly formatted.  You probably have " +
+              "the wrong number of columns.  Or, in other words, one of the arrays " +
+              "in the config.tabs array has the wrong number of elements."
+      end
+      if tab.subtab?
+        tab.add_parent(last_tab)
+      else
+        last_tab = tab
+      end
+      @@tabs << tab
+    end
+  end
+  
+  def self.actions=(ary)
+    @@actions = {}
+    ary.each do |a|
+      if a.size != 3
+        raise ColumnError,
+              "Your config.actions table is improperly formatted.  You probably have " +
+              "the wrong number of columns.  Or, in other words, one of the arrays " +
+              "in the config.actions array has the wrong number of elements."
+      end
+    end
+    ary.each do |controller, action, tab|
+      @@actions[controller] ||= {}
+      @@actions[controller][action] ||= []
+      @@actions[controller][action] << tab
+    end
+  end
+  
+  def self.render_tabs(view)
+    return unless tab_defined?(view)
+    html = ''
+    html << embed_styles
+    active_tab = active_tab(view)
+    active_tab_name = active_tab.name
+    html << (@@html5 ? '<nav id="tabs">' : '<div id="tabs">')
+    html << '<ul>'
+    for tab in main_tabs
+      next if !tab.visible?(view)
+      html << render_tab(:text => tab.text(view),
+                         :path => tab.path(view),
+                         :active => (tab.name == active_tab_name),
+                         :enabled => tab.enabled?(view))
+    end
+    html << '</ul>'
+    html << (@@html5 ? '</nav>' : '</div>')
+    view.raw(html)
+  end
+  
+  def self.render_subtabs(view)
+    return unless tab_defined?(view)
+    controller = view.controller_name.to_sym
+    action = view.action_name.to_sym
+    tab = active_tab(view)
+    html = ''
+    html << (@@html5 ? '<nav id="subtabs">' : '<div id="subtabs">')
+    html << '<ul>'
+    subtabs = tab.subtabs.select{|subtab| subtab.visible?(view)}
+    return if subtabs.empty? && !@@always_render_subtabs
+    for subtab in subtabs
+      html << render_tab(:text => subtab.text(view),
+                         :path => subtab.path(view),
+                         :active => active?(controller, action, subtab.name),
+                         :enabled => subtab.enabled?(view))
+    end
+    html << '</ul>'
+    html << (@@html5 ? '</nav>' : '</div>')
+    view.raw(html)
+  end
+
+  def self.render_tab(options)
+    html = ''
+    klass = (options[:active] ? 'active' : 'inactive')
+    klass << (options[:enabled] ? ' enabled' : ' disabled')
+    html << %Q{<li class="#{klass}">}
+    if (options[:active] && !@@active_tab_clickable) || options[:enabled] == false
+      html << %Q{<span class="tab">#{options[:text]}</span>}
+    else
+      html << %Q{<a href="#{options[:path]}" class="tab">#{options[:text]}</a>}
+    end
+    html << '</li>'
+    html
+  end
+
+  def self.main_tabs
+    @@tabs.select { |t| !t.subtab? }
+  end
+  
+  def self.active_tab(view)
+    controller = view.controller_name.to_sym
+    action = view.action_name.to_sym
+    for tab in @@tabs
+      if active?(controller, action, tab.name)
+        if tab.subtab?
+          return tab.parent
+        else
+          return tab
+        end
+      end
+    end
+    nil
+  end
+
+  def self.active?(controller, action, tab_name)
+    (@@actions[controller][action] && @@actions[controller][action].include?(tab_name)) ||
+     (@@actions[controller][:all_actions] && @@actions[controller][:all_actions].include?(tab_name))
+  end
+
+  def self.tab_defined?(view)
+    controller = view.controller_name.to_sym
+    action = view.action_name.to_sym
+    if @@actions[controller].nil?
+      if @@raise_error_if_no_tab_found
+        raise NoTabFoundError,
+              "No tabs are defined for the controller '#{controller}'.  " +
+              "You can define a tab for this controller in config/initializers/tabulous.rb " +
+              "in the 'config.actions =' section.  You can also turn off NoTabFoundErrors " +
+              "by setting config.raise_error_if_no_tab_found to false."
+      else
+        return false
+      end
+    end
+    if @@actions[controller][action].nil? && !@@actions[controller][:all_actions]
+      if @@raise_error_if_no_tab_found
+        raise NoTabFoundError,
+              "No tab is defined for the action '#{action}' in the controller '#{controller}'.  " +
+              "You can define a tab for this action in config/initializers/tabulous.rb " +
+              "in the 'config.actions =' section.  You can also turn off NoTabFoundErrors " +
+              "by setting config.raise_error_if_no_tab_found to false."
+      else
+        return false
+      end
+    end
+    tab = active_tab(view)
+    if tab.nil?
+      alleged_tab = @@actions[controller][action]
+      if alleged_tab.nil?
+        alleged_tab = @@actions[controller][:all_actions]
+      end
+      raise UnknownTabError,
+            "You've hooked the action '#{action}' in controller '#{controller}' to " +
+            "the tab '#{alleged_tab}', but this tab is not defined."
+    end
+    true
+  end
+
+end

data/lib/tabulous/version.rb

@@ -0,0 +1,3 @@
+module Tabulous
+  VERSION = "0.0.1"
+end

data/lib/tasks/tabulous.rake

@@ -0,0 +1,11 @@
+namespace :tabs do
+  desc "Prettify config/initializers/tabulous.rb"
+  task :format do
+    require File.expand_path('../tabulous/formatter', File.dirname(__FILE__))
+    filename = File.join(Rails.root.to_s, 'config', 'initializers', 'tabulous.rb')
+    reformatted = Tabulous::Formatter.format(IO.readlines(filename))
+    File.open(filename, 'w') do |f|
+      f.puts reformatted
+    end
+  end
+end

data/tabulous.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/tabulous/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "tabulous"
+  s.version     = Tabulous::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Wyatt Greene"]
+  s.email       = ["techiferous@gmail.com"]
+  s.homepage    = "http://rubygems.org/gems/tabulous"
+  s.summary     = "Easy tabbed navigation for Rails."
+  s.description = "Tabulous provides an easy way to add tabs to your Rails application."
+
+  s.required_rubygems_version = ">= 1.4.0"
+  s.rubyforge_project         = "tabulous"
+
+  s.add_dependency "colored", "~> 1.2.0"
+  s.add_dependency "rails", "~> 3.0.0"
+  s.add_development_dependency "bundler", "~> 1.0.10"
+  s.add_development_dependency "capybara", "~> 0.4.1.2"
+  if RUBY_VERSION < "1.9"
+    s.add_development_dependency "redgreen"
+  end
+  s.add_development_dependency "launchy"
+  s.add_development_dependency "diffy"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+end

data/test/applications/main/.gitignore

@@ -0,0 +1,3 @@
+Gemfile.lock
+log/*.log
+tmp/

data/test/applications/main/Gemfile

@@ -0,0 +1,7 @@
+source :rubygems
+
+# Do not add gems directly to this file.  Add them to the test/test_application_gemfile
+# instead and they will be automatically loaded in.
+
+require File.expand_path('../../test_application_gemfile', File.dirname(__FILE__))
+shared_test_application_gems(self)

data/test/applications/main/Rakefile

@@ -0,0 +1,7 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+Main::Application.load_tasks

data/test/applications/main/app/controllers/application_controller.rb

@@ -0,0 +1,3 @@
+class ApplicationController < ActionController::Base
+  protect_from_forgery
+end

data/test/applications/main/app/controllers/galaxies_controller.rb

@@ -0,0 +1,83 @@
+class GalaxiesController < ApplicationController
+  # GET /galaxies
+  # GET /galaxies.xml
+  def index
+    @galaxies = Galaxy.all
+
+    respond_to do |format|
+      format.html # index.html.erb
+      format.xml  { render :xml => @galaxies }
+    end
+  end
+
+  # GET /galaxies/1
+  # GET /galaxies/1.xml
+  def show
+    @galaxy = Galaxy.find(params[:id])
+
+    respond_to do |format|
+      format.html # show.html.erb
+      format.xml  { render :xml => @galaxy }
+    end
+  end
+
+  # GET /galaxies/new
+  # GET /galaxies/new.xml
+  def new
+    @galaxy = Galaxy.new
+
+    respond_to do |format|
+      format.html # new.html.erb
+      format.xml  { render :xml => @galaxy }
+    end
+  end
+
+  # GET /galaxies/1/edit
+  def edit
+    @galaxy = Galaxy.find(params[:id])
+  end
+
+  # POST /galaxies
+  # POST /galaxies.xml
+  def create
+    @galaxy = Galaxy.new(params[:galaxy])
+
+    respond_to do |format|
+      if @galaxy.save
+        format.html { redirect_to(@galaxy, :notice => 'Galaxy was successfully created.') }
+        format.xml  { render :xml => @galaxy, :status => :created, :location => @galaxy }
+      else
+        format.html { render :action => "new" }
+        format.xml  { render :xml => @galaxy.errors, :status => :unprocessable_entity }
+      end
+    end
+  end
+
+  # PUT /galaxies/1
+  # PUT /galaxies/1.xml
+  def update
+    @galaxy = Galaxy.find(params[:id])
+
+    respond_to do |format|
+      if @galaxy.update_attributes(params[:galaxy])
+        format.html { redirect_to(@galaxy, :notice => 'Galaxy was successfully updated.') }
+        format.xml  { head :ok }
+      else
+        format.html { render :action => "edit" }
+        format.xml  { render :xml => @galaxy.errors, :status => :unprocessable_entity }
+      end
+    end
+  end
+
+  # DELETE /galaxies/1
+  # DELETE /galaxies/1.xml
+  def destroy
+    @galaxy = Galaxy.find(params[:id])
+    @galaxy.destroy
+
+    respond_to do |format|
+      format.html { redirect_to(galaxies_url) }
+      format.xml  { head :ok }
+    end
+  end
+end

data/test/applications/main/app/controllers/home_controller.rb

@@ -0,0 +1,4 @@
+class HomeController < ApplicationController
+  def index
+  end
+end

data/test/applications/main/app/controllers/planets_controller.rb

@@ -0,0 +1,83 @@
+class PlanetsController < ApplicationController
+  # GET /planets
+  # GET /planets.xml
+  def index
+    @planets = Planet.all
+
+    respond_to do |format|
+      format.html # index.html.erb
+      format.xml  { render :xml => @planets }
+    end
+  end
+
+  # GET /planets/1
+  # GET /planets/1.xml
+  def show
+    @planet = Planet.find(params[:id])
+
+    respond_to do |format|
+      format.html # show.html.erb
+      format.xml  { render :xml => @planet }
+    end
+  end
+
+  # GET /planets/new
+  # GET /planets/new.xml
+  def new
+    @planet = Planet.new
+
+    respond_to do |format|
+      format.html # new.html.erb
+      format.xml  { render :xml => @planet }
+    end
+  end
+
+  # GET /planets/1/edit
+  def edit
+    @planet = Planet.find(params[:id])
+  end
+
+  # POST /planets
+  # POST /planets.xml
+  def create
+    @planet = Planet.new(params[:planet])
+
+    respond_to do |format|
+      if @planet.save
+        format.html { redirect_to(@planet, :notice => 'Planet was successfully created.') }
+        format.xml  { render :xml => @planet, :status => :created, :location => @planet }
+      else
+        format.html { render :action => "new" }
+        format.xml  { render :xml => @planet.errors, :status => :unprocessable_entity }
+      end
+    end
+  end
+
+  # PUT /planets/1
+  # PUT /planets/1.xml
+  def update
+    @planet = Planet.find(params[:id])
+
+    respond_to do |format|
+      if @planet.update_attributes(params[:planet])
+        format.html { redirect_to(@planet, :notice => 'Planet was successfully updated.') }
+        format.xml  { head :ok }
+      else
+        format.html { render :action => "edit" }
+        format.xml  { render :xml => @planet.errors, :status => :unprocessable_entity }
+      end
+    end
+  end
+
+  # DELETE /planets/1
+  # DELETE /planets/1.xml
+  def destroy
+    @planet = Planet.find(params[:id])
+    @planet.destroy
+
+    respond_to do |format|
+      format.html { redirect_to(planets_url) }
+      format.xml  { head :ok }
+    end
+  end
+end

data/test/applications/main/app/controllers/stars_controller.rb

@@ -0,0 +1,83 @@
+class StarsController < ApplicationController
+  # GET /stars
+  # GET /stars.xml
+  def index
+    @stars = Star.all
+
+    respond_to do |format|
+      format.html # index.html.erb
+      format.xml  { render :xml => @stars }
+    end
+  end
+
+  # GET /stars/1
+  # GET /stars/1.xml
+  def show
+    @star = Star.find(params[:id])
+
+    respond_to do |format|
+      format.html # show.html.erb
+      format.xml  { render :xml => @star }
+    end
+  end
+
+  # GET /stars/new
+  # GET /stars/new.xml
+  def new
+    @star = Star.new
+
+    respond_to do |format|
+      format.html # new.html.erb
+      format.xml  { render :xml => @star }
+    end
+  end
+
+  # GET /stars/1/edit
+  def edit
+    @star = Star.find(params[:id])
+  end
+
+  # POST /stars
+  # POST /stars.xml
+  def create
+    @star = Star.new(params[:star])
+
+    respond_to do |format|
+      if @star.save
+        format.html { redirect_to(@star, :notice => 'Star was successfully created.') }
+        format.xml  { render :xml => @star, :status => :created, :location => @star }
+      else
+        format.html { render :action => "new" }
+        format.xml  { render :xml => @star.errors, :status => :unprocessable_entity }
+      end
+    end
+  end
+
+  # PUT /stars/1
+  # PUT /stars/1.xml
+  def update
+    @star = Star.find(params[:id])
+
+    respond_to do |format|
+      if @star.update_attributes(params[:star])
+        format.html { redirect_to(@star, :notice => 'Star was successfully updated.') }
+        format.xml  { head :ok }
+      else
+        format.html { render :action => "edit" }
+        format.xml  { render :xml => @star.errors, :status => :unprocessable_entity }
+      end
+    end
+  end
+
+  # DELETE /stars/1
+  # DELETE /stars/1.xml
+  def destroy
+    @star = Star.find(params[:id])
+    @star.destroy
+
+    respond_to do |format|
+      format.html { redirect_to(stars_url) }
+      format.xml  { head :ok }
+    end
+  end
+end