bootstrap-sass-rails 1.4.0

data/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2011 Morton Jonuschat
+Twitter Bootstrap Copyright 2011 Twitter, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,109 @@
+# Bootstrap::Sass::Rails
+
+Bootstrap is Twitter's toolkit for kickstarting CSS for websites, apps, and more.
+It includes base CSS styles for typography, forms, buttons, tables, grids, navigation, alerts, and more.
+
+Twitter Bootstrap has been converted to Sass which makes it possible to use the default Rails Asset Pipeline
+
+* All assets have been namespaced within twitter/bootstrap to avoid naming conflicts
+* Top level requires for sprockets to get the complete bundle with a
+  simple = require twitter/bootstrap
+* Ability to import individually namespaced stylesheets or javascripts.
+
+## Usage
+
+### Stylesheets
+
+The easiest way to use Twitter Bootstrap is to require it in your `application.css` file.
+
+```css
+/*
+ *= require twitter/bootstrap
+ */
+
+#example {
+  /* Your styles... */
+}
+```
+
+If you need access to the variables within the Twitter Bootstrap framework or want to use the mixins you
+will need to import it within an `.css.scss` file. This will still include the complete framework.
+
+```css
+@import "twitter/bootstrap";
+
+#foo {
+  @include border-radius(4px);
+}
+```
+
+Using only parts of the framework like variables and mixin you can import all of these individually from
+within `.css.scss` files.
+
+```css
+@import "twitter/bootstrap/variables";
+@import "twitter/bootstrap/mixins";
+
+@mixin myButton($radius: 5px) {
+  @include border-radius($radius);
+}
+
+#foo {
+  @include myButton(10px);
+}
+```
+
+### Javascripts
+
+Using the JavaScript works the same way. You can include them all with a
+single require directive from your `application.js`.
+
+```javascript
+//= require twitter/bootstrap
+
+$(document).ready(function(){
+});
+```
+
+If you only want a part of the javascripts require the individual files
+from your `.js` file.
+
+```javascript
+//= require twitter/bootstrap/modal
+
+$(document).ready(function(){
+});
+```
+
+## Versioning
+
+This gem will directly track the semantic versioning releases of the Twitter Bootstrap project.
+If it should be necessary a build number will be added to the version to
+mark releases specific to this gem.
+
+## Note on Patches / Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Credits
+
+This work incorporates [Twitter Bootstrap](https://github.com/twitter/bootstrap) by Twitter, Inc.  
+This gem has been inspired by [less-rails-bootstrap](https://github.com/metaskills/less-rails-bootstrap) by Ken Collins
+
+## Maintainers
+
+* [Morton Jonuschat](https://github.com/yabawock)
+
+## License
+
+Apache License, Version 2.0
+
+## Copyright
+
+Copyright 2011 Morton Jonuschat  
+Twitter Bootstrap copyright 2011 Twitter, Inc  

data/Rakefile

@@ -0,0 +1,37 @@
+#!/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    = 'BootstrapSassRails'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_spec.rb'
+  t.verbose = false
+end
+
+
+task :default => :test

data/lib/bootstrap-sass-rails.rb

@@ -0,0 +1,8 @@
+module Bootstrap
+  module Sass
+    module Rails
+    end
+  end
+end
+
+require 'bootstrap/sass/rails'

data/lib/bootstrap/sass/rails.rb

@@ -0,0 +1,2 @@
+require 'bootstrap/sass/rails/version'
+require 'bootstrap/sass/rails/engine'

data/lib/bootstrap/sass/rails/engine.rb

@@ -0,0 +1,9 @@
+module Bootstrap
+  module Sass
+    module Rails
+      class Engine < ::Rails::Engine
+        # Make rails look at the vendored assets
+      end
+    end
+  end
+end

data/lib/bootstrap/sass/rails/version.rb

@@ -0,0 +1,7 @@
+module Bootstrap
+  module Sass
+    module Rails
+      VERSION = '1.4.0'
+    end
+  end
+end

data/test/cases/usage_css_spec.rb

@@ -0,0 +1,70 @@
+require 'spec_helper'
+
+class UsageCssSpec < Bootstrap::Sass::Rails::Spec
+
+  describe 'application.css' do
+
+    let(:app_css) { dummy_asset('application.css') }
+
+    it 'will render main bootstrap.less file and all included modules' do
+      app_css.must_include 'Bootstrap @VERSION',          'From bootstrap.css.scss'
+      app_css.must_include 'Forms.scss',                  'From forms.scss'
+      app_css.must_include 'Snippets of reusable CSS',    'From mixins.scss'
+      app_css.must_include 'Patterns.scss',               'From patterns.scss'
+      app_css.must_include 'Scaffolding',                 'From scaffolding.scss'
+      app_css.must_include 'Tables.scss',                 'From tables.scss'
+      app_css.must_include 'Typography.scss',             'From type.scss'
+      app_css.must_include 'Variables.scss',              'From variables.scss'
+    end
+
+    it 'must include basic css afterward' do
+      app_css.must_include '#other-css { color: red; }',  'From our code afterward.'
+    end
+
+  end
+
+  describe 'individual.scss' do
+
+    let(:individual_css) { dummy_asset('individual.css') }
+
+    it 'will render bootstrap variables and mixins' do
+      my_button_line = line_for_individual_css('individual-my-button')
+      my_button_line.must_include '-webkit-border-radius: 10px'
+      my_button_line.must_include '-moz-border-radius: 10px'
+      my_button_line.must_include 'border-radius: 10px'
+    end
+
+  end
+
+  describe 'sprockets.css' do
+
+    let(:sprockets_css) { dummy_asset('sprockets.css') }
+
+    it 'will render main bootstrap.css file and all included modules' do
+      sprockets_css.must_include 'Bootstrap @VERSION',          'From boostrap.css.scss'
+      sprockets_css.must_include 'Forms.scss',                  'From forms.scss'
+      sprockets_css.must_include 'Snippets of reusable CSS',    'From mixins.scss'
+      sprockets_css.must_include 'Patterns.scss',               'From patterns.scss'
+      sprockets_css.must_include 'Scaffolding',                 'From scaffolding.scss'
+      sprockets_css.must_include 'Tables.scss',                 'From tables.scss'
+      sprockets_css.must_include 'Typography.scss',             'From type.scss'
+      sprockets_css.must_include 'Variables.scss',              'From variables.scss'
+    end
+
+    it 'must include basic css afterward' do
+      sprockets_css.must_include '#other-css { color: red; }',  'From our code afterward.'
+    end
+
+  end
+
+  private
+
+  def line_for_framework_css(name)
+    framework_css.each_line.detect{ |line| line.include? name }.strip
+  end
+
+  def line_for_individual_css(name)
+    individual_css.each_line.detect{ |line| line.include? name }.strip
+  end
+
+end

data/test/cases/usage_js_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+class UsageJsSpec < Bootstrap::Sass::Rails::Spec
+
+  describe 'application.js' do
+
+    let(:app_js) { dummy_asset('application.js') }
+
+    it 'will render main bootstrap.js file and all included modules' do
+      app_js.must_include 'bootstrap-alerts.js'
+      app_js.must_include 'bootstrap-dropdown.js'
+      app_js.must_include 'bootstrap-modal.js'
+      app_js.must_include 'bootstrap-popover.js'
+      app_js.must_include 'bootstrap-scrollspy.js'
+      app_js.must_include 'bootstrap-tabs.js'
+      app_js.must_include 'bootstrap-twipsy.js'
+    end
+
+    it 'must include basic js afterward' do
+      app_js.must_include '$(document).ready(function(){...});'
+    end
+
+  end
+
+  describe 'individual.css.less' do
+
+    let(:individual_js) { dummy_asset('individual.js') }
+
+    it 'will render bootstrap variables and mixins' do
+      individual_js.must_include 'bootstrap-modal.js'
+    end
+
+  end
+
+end

data/test/dummy/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+# 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__)
+
+Dummy::Application.load_tasks

data/test/dummy/app/assets/javascripts/application.js

@@ -0,0 +1,3 @@
+//= require twitter/bootstrap
+
+$(document).ready(function(){...});:

data/test/dummy/app/assets/javascripts/individual.js

@@ -0,0 +1 @@
+//= require twitter/bootstrap/modal

data/test/dummy/app/assets/stylesheets/application.css.scss

@@ -0,0 +1,3 @@
+@import "twitter/bootstrap";
+
+#other-css { color: red; }

data/test/dummy/app/assets/stylesheets/individual.css.scss

@@ -0,0 +1,10 @@
+@import "twitter/bootstrap/variables";
+@import "twitter/bootstrap/mixins";
+
+@mixin myButton($radius: 5px) {
+  @include border-radius($radius);
+}
+
+#individual-my-button {
+  @include myButton(10px);
+}

data/test/dummy/app/assets/stylesheets/sprockets.css

@@ -0,0 +1,3 @@
+//= require twitter/bootstrap
+
+#other-css { color: red; }

data/test/dummy/app/controllers/application_controller.rb

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

data/test/dummy/app/helpers/application_helper.rb

@@ -0,0 +1,2 @@
+module ApplicationHelper
+end

data/test/dummy/app/views/layouts/application.html.erb

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Dummy</title>
+  <%= stylesheet_link_tag    "application" %>
+  <%= javascript_include_tag "application" %>
+  <%= csrf_meta_tags %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/test/dummy/config.ru

@@ -0,0 +1,4 @@
+# This file is used by Rack-based servers to start the application.
+
+require ::File.expand_path('../config/environment',  __FILE__)
+run Dummy::Application

data/test/dummy/config/application.rb

@@ -0,0 +1,49 @@
+require File.expand_path('../boot', __FILE__)
+
+require 'rails/all'
+
+Bundler.require
+require "bootstrap-sass-rails"
+require "sass-rails"
+
+module Dummy
+  class Application < Rails::Application
+    # Settings in config/environments/* take precedence over those specified here.
+    # Application configuration should go into files in config/initializers
+    # -- all .rb files in that directory are automatically loaded.
+
+    # Custom directories with classes and modules you want to be autoloadable.
+    # config.autoload_paths += %W(#{config.root}/extras)
+
+    # Only load the plugins named here, in the order given (default is alphabetical).
+    # :all can be used as a placeholder for all plugins not explicitly named.
+    # config.plugins = [ :exception_notification, :ssl_requirement, :all ]
+
+    # Activate observers that should always be running.
+    # config.active_record.observers = :cacher, :garbage_collector, :forum_observer
+
+    # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
+    # Run "rake -D time" for a list of tasks for finding time zone names. Default is UTC.
+    # config.time_zone = 'Central Time (US & Canada)'
+
+    # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
+    # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}').to_s]
+    # config.i18n.default_locale = :de
+
+    # Configure the default encoding used in templates for Ruby 1.9.
+    config.encoding = "utf-8"
+
+    # Configure sensitive parameters which will be filtered from the log file.
+    config.filter_parameters += [:password]
+
+    # Enable the asset pipeline
+    config.assets.enabled = true
+
+    # Version of your assets, change this if you want to expire all your assets
+    config.assets.version = '1.0'
+
+    # Set an easier to test css style
+    config.sass.style = :compact
+  end
+end
+

data/test/dummy/config/boot.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+gemfile = File.expand_path('../../../../Gemfile', __FILE__)
+
+if File.exist?(gemfile)
+  ENV['BUNDLE_GEMFILE'] = gemfile
+  require 'bundler'
+  Bundler.setup
+end
+
+$:.unshift File.expand_path('../../../../lib', __FILE__)

data/test/dummy/config/database.yml

@@ -0,0 +1,25 @@
+# SQLite version 3.x
+#   gem install sqlite3
+#
+#   Ensure the SQLite 3 gem is defined in your Gemfile
+#   gem 'sqlite3'
+development:
+  adapter: sqlite3
+  database: db/development.sqlite3
+  pool: 5
+  timeout: 5000
+
+# Warning: The database defined as "test" will be erased and
+# re-generated from your development database when you run "rake".
+# Do not set this db to the same as development or production.
+test:
+  adapter: sqlite3
+  database: db/test.sqlite3
+  pool: 5
+  timeout: 5000
+
+production:
+  adapter: sqlite3
+  database: db/production.sqlite3
+  pool: 5
+  timeout: 5000