spurs 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2012 TrueNorth Applications, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,118 @@
+# Spurs
+
+Spurs is a library that adds some bells and whistles to the Twitter Bootstrap GUI framework. I consists mostly of helpers and javascript, and thus is ORM agnostic.
+
+## Flash Messages
+
+Put this in your layout file wherever you want to render the flash messages
+  
+    <%= spurs_flash_helper %>
+
+and flash messages will be automatically rendered on page loads
+
+### From the rails side
+
+By default, you can create four types of messages
+    
+    flash_addItem(:notices,"A message about something successfully happening!")
+    flash_addItem(:warnings, "Something is unusual, but not absolutely critical")
+    flash_addItem(:errors, "Something critical has happened")
+    flash_addItem(:infos, "Here's some information")
+
+You can also create multiple messages for each type
+    
+    flash_addItem(:errors, "Problem validating phone number")
+    flash_addItem(:errors, "Problem validating street address")
+
+### From the javascript side
+
+You can also create matching flash messages via javascript
+  
+    spurs.flash.alert("Something has gone wrong!","error");
+
+for the singular versions of each of the four types above ("info", "warning", "error", "notice")
+
+## Navigation
+
+Spurs makes creation of bootstrap navigation easy!.
+
+    spurs_nav :type => :pills do |nav|
+      
+      # a simple nav item as a regular link
+      nav.tab :user, :icon => :user, :href => "#user"
+      
+      # a nav item that runs some javascript
+      nav.tab :settings, :icon => :cog, :onclick => "alert('hello');"
+      
+      # a nav item that only shows its icon (not its name)
+      nav.tab :secure, :icon => :lock, :icon_only => true
+      
+      # a dropdown menu with two actions
+      nav.dropdown :menu, 
+                    :icon => :cog, 
+                    :icon_only => true,
+                    :actions => [ {:name => "one", :icon => :plus, :href => "#one"},
+                                 {:name => "two", :icon => :minus, :href => "#two"}]
+
+will generate a menu like this...
+
+![image](https://github.com/TrueNorth/spurs/raw/master/docs/img/pic1.png)
+
+or in HTML...
+  
+    <ul class="nav nav-pills  ">
+      <li>
+        <a href="#user">
+          <i class="icon-user"></i>User
+        </a>
+      </li>
+      <li>
+        <a onclick="alert('hello');">
+          <i class="icon-cog"></i>Settings
+        </a>
+      </li>
+      <li>
+        <a>
+          <i class="icon-lock"></i>Secure
+        </a>
+      </li>
+      <li class="dropdown" data-dropdown="dropdown">
+        <a class="dropdown-toggle" data-toggle="dropdown">
+          <i class="icon-cog"></i>
+          <b class="caret"></b>
+        </a>
+        <ul class="dropdown-menu">
+          <li>
+            <a href="#one">
+              <i class="icon-plus"></i>No Name
+            </a>
+          </li>
+          <li>
+            <a href="#two">
+              <i class="icon-minus"></i>No Name
+            </a>
+          </li>
+        </ul>
+      </li>
+    </ul>
+
+You can specify some active criteria for menu items
+
+    spurs_nav :type => :pills do |nav|
+  
+      # force this to be active with a boolean
+      nav.tab :user, :icon => :user, :href => "#user", 
+              :active => true
+      
+      # controller criteria (if controller_name == :settings)
+      nav.tab :settings, :icon => :cog, :onclick => "alert('hello');", 
+              :active => {:controller => :settings}
+  
+      # controller and action criteria (if controller_name == :settings && action_name == ;edit)
+      nav.tab :settings, :icon => :cog, :onclick => "alert('hello');", 
+              :active => {:controller => :settings, :action => :edit}
+  
+      # multiple controller/action criteria (if (controller_name == :settings && action_name == :edit) || (controller_name == :user && action_name == :edit)
+      nav.tab :settings, :icon => :cog, :onclick => "alert('hello');", 
+              :active => [{:controller => :settings, :action => :edit},
+                          {:controller => :users, :action => :edit}]

data/Rakefile

@@ -0,0 +1,40 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Spurs'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../test/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+
+task :default => :test

data/app/assets/javascripts/spurs/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require jquery
+//= require jquery_ujs
+//= require_tree .

data/app/assets/javascripts/spurs/flashes.js.coffee

@@ -0,0 +1,30 @@
+if !window.spurs then window.spurs = {}
+
+window.spurs.flashes =
+  highest_priority_flash_container: ->
+    highest = -100
+    highest_item = null
+    $("." + spurs.vars.flashes.container_class).each (idx, item) ->
+      priority = parseInt($(item).attr("id").substring($("." + spurs.vars.flashes.container_class).attr("id").indexOf(spurs.vars.flashes.container_id_prefix) + spurs.vars.flashes.container_id_prefix.length))
+      if priority > highest
+        highest = priority
+        highest_item = $(item)
+    highest_item
+
+  lowest_priority_flash_container: ->
+      lowest = 9999
+      lowest_item = null
+      $("." + spurs.vars.flashes.container_class).each (idx, item) ->
+        priority = parseInt($(item).attr("id").substring($("." + spurs.vars.flashes.container_class).attr("id").indexOf(spurs.vars.flashes.container_id_prefix) + spurs.vars.flashes.container_id_prefix.length))
+        if priority < lowest
+          lowest = priority
+          lowest_item = $(item)
+      lowest_item
+
+  alert: (message, flavor) ->
+    $.ajax
+      url: spurs.vars.flashes.create_path + ".js"
+      type: "POST"
+      data:
+        message: message
+        flavor: flavor

data/app/assets/javascripts/spurs/flashes.js.erb

@@ -0,0 +1,32 @@
+// Place all the behaviors and hooks related to the matching controller here.
+// All this logic will automatically be available in application.js.
+var spurs = spurs ? spurs : {};
+
+spurs.flashes = {
+
+    highest_priority_flash_container:function () {
+        var highest = -100;
+        var highest_item = null;
+        $('.' + spurs.vars.flashes.container_class).each(
+                function (idx, item) {
+                    priority = parseInt($(item).attr('id').substring($('.' + spurs.vars.flashes.container_class).attr('id').indexOf(spurs.vars.flashes.container_id_prefix) + spurs.vars.flashes.container_id_prefix.length));
+                    if (priority > highest) {
+                        highest = priority;
+                        highest_item = $(item);
+                    }
+
+                });
+        return highest_item;
+    },
+    alert:function (message, flavor) {
+        $.ajax({
+            url: spurs.vars.flashes.create_path + '.js',
+            type:'POST',
+            data:{
+                message:message,
+                flavor:flavor
+            }
+        });
+    }
+
+}

data/app/assets/javascripts/spurs/sections.js.coffee

@@ -0,0 +1,9 @@
+if !window.spurs then window.spurs = {}
+
+window.spurs.sections = toggle: (section) ->
+  if section.hasClass("open")
+    section.removeClass "open"
+    section.find(".section_toggle").html "<i class=\"icon-chevron-right\"></i>"
+  else
+    section.addClass "open"
+    section.find(".section_toggle").html "<i class=\"icon-chevron-down\"></i>"

data/app/assets/javascripts/spurs/vars.js.coffee.erb

@@ -0,0 +1,6 @@
+if !window.spurs then window.spurs = {}
+
+window.spurs.vars = flashes:
+  create_path: "spurs/flashes"
+  container_class: "<%=Spurs::Flash::Helper::flashes_container_class%>"
+  container_id_prefix: "<%=Spurs::Flash::Helper::flashes_container_id_prefix%>"

data/app/assets/javascripts/spurs/vars.js.erb

@@ -0,0 +1,10 @@
+var spurs = spurs ? spurs : {};
+
+spurs.vars = {
+    flashes: {
+        create_path:"spurs/flashes",
+        container_class:"<%=Spurs::Flash::Helper::flashes_container_class%>",
+        container_id_prefix:"<%=Spurs::Flash::Helper::flashes_container_id_prefix%>",
+    }
+
+}

data/app/assets/javascripts/spurs.js

@@ -0,0 +1,20 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require jquery
+//= require jquery_ujs
+
+//= require ./spurs/vars
+//= require ./spurs/flashes
+//= require ./spurs/sections
+
+var spurs = window.spurs;

data/app/assets/stylesheets/spurs/application.css

@@ -0,0 +1,13 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the top of the
+ * compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_self
+ *= require_tree .
+*/

data/app/assets/stylesheets/spurs/jquery-ui-theme.css

@@ -0,0 +1,13 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the top of the
+ * compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_self
+ *= require ./jquery_ui_theme/jquery-ui-1.8.16.custom.css
+*/