bh 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e69edccfc681f4a4d24ba2d5212ab4f609b7f15e
-  data.tar.gz: e9cb987e0b6d6dbf58342169d5cb37088167a93f
+  metadata.gz: fd20f354ba7792ddb18ca83618d77b0510bbc3c8
+  data.tar.gz: 447b0f2f6e06aaabbba876616a29db1d2a4e577f
 SHA512:
-  metadata.gz: 4b20a81f7e2b445f9fc263b80c5a72f1f3a72caafaa562752129f72843bf67b0424d2ef6bfddee5c2d3abdb737bd926c70d31adcb50f2cd668fe85402b9c5c58
-  data.tar.gz: 891b720e5fb99e30003fc13410956750d862c71089fc3eb19e2ebe3147ae099d402f47084a5324f342c5dd0169eab2d8abcb180a7b047688d876f36368a39232
+  metadata.gz: 0d18cd3d04c5d8f1af19bf3ead08f17e27045b4c592ba7e68ed72e9b1102ad9d922ae8f14036a69872aeceadedda75aebf3679704b03d1d6dcedb7762ee897dc
+  data.tar.gz: b0de752c4c5cd633e5683f1cf6bba061cc16eea865165b12d7e5f5adaee5a33233ea28248431d5b4108f07aa768a4912cd22b0e2aa1a8cbe1b0e1542b881c733

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+notifications:
+  email: true
+matrix:
+  include:
+  - rvm: 1.9.3
+    gemfile: gemfiles/Gemfile.rails-3.x
+  - rvm: 2.0.0
+    gemfile: gemfiles/Gemfile.rails-4.x

data/CHANGELOG.md

@@ -6,6 +6,10 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.0.3 - 2014-08-15
+
+* [FEATURE] Add `bootstrap_css`, `bootstrap_theme_css` and `bootstrap_js`
+
 ## 0.0.2 - 2014-08-15
 
 * [FEATURE] Add `alert_box` helper

data/Gemfile

@@ -1,4 +1,4 @@
 source 'https://rubygems.org'
-gem 'pry'
+
 # Specify your gem's dependencies in bh.gemspec
 gemspec

data/README.md

@@ -1,9 +1,18 @@
 Bh - Bootstrap Helpers
 ======================
 
-Bh provides a set of powerful helpers that streamlines the use of
+Bh provides a set of helpers that streamlines the use of
 [Bootstrap components](http://getbootstrap.com/components) in Rails views.
 
+The **full documentation** is available at [rubydoc.info](http://rubydoc.info/github/Fullscreen/bh/master/frames).
+
+[![Build Status](http://img.shields.io/travis/Fullscreen/bh/master.svg)](https://travis-ci.org/Fullscreen/bh)
+[![Coverage Status](http://img.shields.io/coveralls/Fullscreen/bh/master.svg)](https://coveralls.io/r/Fullscreen/bh)
+[![Dependency Status](http://img.shields.io/gemnasium/Fullscreen/bh.svg)](https://gemnasium.com/Fullscreen/bh)
+[![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/bh.svg)](https://codeclimate.com/github/Fullscreen/bh)
+[![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://rubydoc.info/github/Fullscreen/bh/master/frames)
+[![Gem Version](http://img.shields.io/gem/v/bh.svg)](http://rubygems.org/gems/bh)
+
 Bootstrap is a great framework, but requires to write many lines of HTML code
 even for simple components.
 For instance, you need to write the following HTML to show a _dismissible alert_:
@@ -22,7 +31,7 @@ Writing this for every _dismissible alert_ in a web site is cumbersome,
 repetitive, and prone to errors.
 
 Bh offers a solution to this problem by means of a set of helper methods.
-The example above can be with just one line of code:
+The example above can be rewritten with just one line of code:
 
 ```erb
 <%= alert_box 'You accepted the Terms of service.', dismissible: true %>
@@ -37,7 +46,7 @@ How to install
 
 Bh is meant to be included in Rails apps by adding this line to the Gemfile:
 
-    gem 'bh', '~> 0.0.2'
+    gem 'bh', '~> 0.0.3'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -47,11 +56,11 @@ and a new version of Bh is released.
 Adding 'bh' to your Gemfile is all you need!
 From now on, you will be able to use any of the following Bh helpers in your Rails views.
 
-The `alert_box` helper
-======================
+AlertHelper
+===========
 
 To include [Boostrap alert boxes](http://getbootstrap.com/components/#alerts)
-in your Rails views, you can use the [alert_box](#doc) helper.
+in your Rails views, you can use the [alert_box](http://rubydoc.info/github/Fullscreen/bh/master/Bh/AlertHelper) helper.
 Here are some examples.
 
 Basic alerts
@@ -155,6 +164,49 @@ highlighted text and appropriately styled links:
 
 ![alert-complex](https://cloud.githubusercontent.com/assets/7408595/3936903/7c1b70f0-24a7-11e4-95ee-11f6920ddd4d.png)
 
+CdnHelper
+=========
+
+To load the CSS and JS files of Bootstrap from
+[BootstrapCDN](http://getbootstrap.com/getting-started/#download), you can use
+the [bootstrap_css](http://rubydoc.info/github/Fullscreen/bh/master/Bh/CdnHelper),
+[bootstrap_theme_css](http://rubydoc.info/github/Fullscreen/bh/master/Bh/CdnHelper) and
+[bootstrap_js](http://rubydoc.info/github/Fullscreen/bh/master/Bh/CdnHelper) helpers.
+Here are some examples.
+
+Load the latest Bootstrap assets
+--------------------------------
+
+```erb
+<%= stylesheet_link_tag bootstrap_css, bootstrap_theme_css, :application %>
+<%= javascript_include_tag bootstrap_js, :application %>
+```
+
+will generate the HTML to load the latest versions of Bootstrap CSS, Bootstrap
+Theme CSS and Bootstrap JS from MaxCDN, before your application assets:
+
+```html
+<link href="//netdna.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css" media="screen" rel="stylesheet" type="text/css" />
+<link href="//netdna.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap-theme.min.css" media="screen" rel="stylesheet" type="text/css" />
+<link href="/assets/application.css" media="screen" rel="stylesheet" type="text/css" />
+
+<script src="//netdna.bootstrapcdn.com/bootstrap/3.2.0/js/bootstrap.min.js" type="text/javascript"></script>
+<script src="/assets/application.js" type="text/javascript"></script>
+```
+
+Load a specific version of a Bootstrap asset
+--------------------------------------------
+
+```erb
+<%= stylesheet_link_tag bootstrap_css(version: '3.1.0', minified: false, scheme: :http) %>
+```
+
+will generate the HTML to load the non-minified 3.1.0 versions of Bootstrap CSS
+over HTTP scheme:
+
+```html
+<link href="http://netdna.bootstrapcdn.com/bootstrap/3.1.0/css/bootstrap.css" media="screen" rel="stylesheet" type="text/css" />
+```
 
 How to release new versions
 ===========================
@@ -178,7 +230,8 @@ Bh needs your support!
 
 If you find that a method is missing, fork the project, add the missing code,
 write the appropriate tests, then submit a pull request, and it will gladly
-be merged! If you need an inspiration, look at the TODO.md file.
+be merged! If you need an inspiration, look at the
+[TODO](https://github.com/Fullscreen/bh/blob/master/TODO.md).
 
 To run the tests, simply type `rspec` on the command line.
 

data/gemfiles/Gemfile.rails-3.x

@@ -0,0 +1,5 @@
+source 'http://rubygems.org'
+
+gem 'activesupport', '~> 3.0'
+gem 'actionpack', '~> 3.0'
+gemspec path: '../'

data/gemfiles/Gemfile.rails-4.x

@@ -0,0 +1,5 @@
+source 'http://rubygems.org'
+
+gem 'activesupport', '~> 4.0'
+gem 'actionpack', '~> 4.0'
+gemspec path: '../'

data/lib/bh/helpers/cdn_helper.rb

@@ -0,0 +1,50 @@
+module Bh
+  # Provides methods to retrieve the URLs of Bootstrap stylesheets and
+  # Javascript files from Bootstrap CDN
+  # @see http://www.bootstrapcdn.com
+  module CdnHelper
+    # @return [String] the URL of the Bootstrap CSS file
+    # @param [Hash] options the options for which CSS file to retrieve.
+    # @option options [String] :version the version of Bootstrap.
+    # @option options [String] :scheme the URI scheme to use.
+    # @option options [Boolean] :minified whether to use the minified version.
+    def bootstrap_css(options = {})
+      bootstrap_asset options.merge(name: 'bootstrap', extension: 'css')
+    end
+
+    # @return [String] the URL of the Bootstrap Theme CSS file
+    # @param [Hash] options the options for which CSS file to retrieve.
+    # @option options [String] :version the version of Bootstrap.
+    # @option options [String] :scheme the URI scheme to use.
+    # @option options [Boolean] :minified whether to use the minified version.
+    def bootstrap_theme_css(options = {})
+      bootstrap_asset options.merge(name: 'bootstrap-theme', extension: 'css')
+    end
+
+    # @return [String] the URL of the Bootstrap JS file
+    # @param [Hash] options the options for which JS file to retrieve.
+    # @option options [String] :version the version of Bootstrap.
+    # @option options [String] :scheme the URI scheme to use.
+    # @option options [Boolean] :minified whether to use the minified version.
+    def bootstrap_js(options = {})
+      bootstrap_asset options.merge(name: 'bootstrap', extension: 'js')
+    end
+
+  private
+
+    # @return [String] the version of Bootstrap assets to use if unspecified.
+    def bootstrap_version
+      '3.2.0'
+    end
+
+    def bootstrap_asset(options = {})
+      version = options.fetch :version, bootstrap_version
+      extension = options[:extension]
+      name = options[:name]
+      name = "#{name}.min" if options.fetch(:minified, true)
+      scheme = "#{options[:scheme]}:" if options[:scheme]
+      host = '//netdna.bootstrapcdn.com'
+      "#{scheme}#{host}/bootstrap/#{version}/#{extension}/#{name}.#{extension}"
+    end
+  end
+end

data/lib/bh/railtie.rb

@@ -1,10 +1,12 @@
 require 'bh/helpers/alert_helper'
+require 'bh/helpers/cdn_helper'
 require 'bh/helpers/url_helper'
 
 module Bh
   class Railtie < Rails::Railtie
     initializer 'bh.add_helpers' do
       ActionView::Base.send :include, AlertHelper
+      ActionView::Base.send :include, CdnHelper
       ActionView::Base.send :include, UrlHelper
     end
   end

data/lib/bh/version.rb

@@ -1,3 +1,3 @@
 module Bh
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'
 end

data/spec/helpers/alert_helper_spec.rb

@@ -1,3 +1,5 @@
+# encoding: UTF-8
+
 require 'spec_helper'
 require 'bh/helpers/alert_helper'
 require 'bh/helpers/url_helper'

data/spec/helpers/cdn_helper_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+require 'bh/helpers/cdn_helper'
+require 'open-uri'
+include Bh::CdnHelper
+
+describe 'bootstrap_css' do
+  let(:file) { open bootstrap_css(options), ssl_verify_mode: OpenSSL::SSL::VERIFY_NONE }
+
+  describe 'with the HTTP scheme, links to an existing file' do
+    let(:options) { {scheme: :http} }
+    it{ expect(file).to be }
+  end
+
+  describe 'with the HTTPS scheme, links to an existing file' do
+    let(:options) { {scheme: :https} }
+    it{ expect(file).to be }
+  end
+
+  describe 'non-minified, links to an existing file' do
+    let(:options) { {scheme: :http, minified: false} }
+    it{ expect(file).to be }
+  end
+
+  describe 'given a legacy version, links to an existing file' do
+    let(:options) { {scheme: :https, version: '3.1.0'} }
+    it{ expect(file).to be }
+  end
+end
+
+describe 'bootstrap_theme_css' do
+  let(:file) { open bootstrap_theme_css(options), ssl_verify_mode: OpenSSL::SSL::VERIFY_NONE }
+
+  describe 'with the HTTP scheme, links to an existing file' do
+    let(:options) { {scheme: :http} }
+    it{ expect(file).to be }
+  end
+
+  describe 'with the HTTPS scheme, links to an existing file' do
+    let(:options) { {scheme: :https} }
+    it{ expect(file).to be }
+  end
+
+  describe 'non-minified, links to an existing file' do
+    let(:options) { {scheme: :http, minified: false} }
+    it{ expect(file).to be }
+  end
+
+  describe 'given a legacy version, links to an existing file' do
+    let(:options) { {scheme: :https, version: '3.1.0'} }
+    it{ expect(file).to be }
+  end
+end
+
+describe 'bootstrap_js' do
+  let(:file) { open bootstrap_js(options), ssl_verify_mode: OpenSSL::SSL::VERIFY_NONE }
+
+  describe 'with the HTTP scheme, links to an existing file' do
+    let(:options) { {scheme: :http} }
+    it{ expect(file).to be }
+  end
+
+  describe 'with the HTTPS scheme, links to an existing file' do
+    let(:options) { {scheme: :https} }
+    it{ expect(file).to be }
+  end
+
+  describe 'non-minified, links to an existing file' do
+    let(:options) { {scheme: :http, minified: false} }
+    it{ expect(file).to be }
+  end
+
+  describe 'given a legacy version, links to an existing file' do
+    let(:options) { {scheme: :https, version: '3.1.0'} }
+    it{ expect(file).to be }
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bh
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-15 00:00:00.000000000 Z
+date: 2014-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -117,6 +117,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - MIT-LICENSE
@@ -124,12 +125,16 @@ files:
 - Rakefile
 - TODO.md
 - bh.gemspec
+- gemfiles/Gemfile.rails-3.x
+- gemfiles/Gemfile.rails-4.x
 - lib/bh.rb
 - lib/bh/helpers/alert_helper.rb
+- lib/bh/helpers/cdn_helper.rb
 - lib/bh/helpers/url_helper.rb
 - lib/bh/railtie.rb
 - lib/bh/version.rb
 - spec/helpers/alert_helper_spec.rb
+- spec/helpers/cdn_helper_spec.rb
 - spec/helpers/url_helper_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/Fullscreen/bh
@@ -159,6 +164,7 @@ summary: Bh provides a set of powerful helpers that streamlines the use of Boots
   components in Rails views.
 test_files:
 - spec/helpers/alert_helper_spec.rb
+- spec/helpers/cdn_helper_spec.rb
 - spec/helpers/url_helper_spec.rb
 - spec/spec_helper.rb
 has_rdoc: