fallback_assets 0.0.2

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YmEyOGFhM2ZmN2I5NjM2NGVlYjhmYTFhNTg2YmM1NzhmMzEzMzQ4MA==
+  data.tar.gz: !binary |-
+    MDY2NWJmMzJlYTJkMjc2NmUyNzA1MDQ2ZTVjNzQ3N2Q5NDM2ZTRlYg==
+SHA512:
+  metadata.gz: !binary |-
+    NWY0ZTAyODQ5ODFkODgwNjkzNTgxYWM4NDA0YzM4NjY5Mjg0OGQ0OTk2NDJj
+    MzAxN2EyMjEzYTJjNjMzZTViMWIyOGY5MGVhNmZlOGZmYmMyYjg4N2U2MWQ1
+    OTUwOWY1ZjM4YzI3MDIwMTM0OTkyNmRjNzA4NjQ1YWNlMDE5YzE=
+  data.tar.gz: !binary |-
+    NmE1YmEzZDIxMTY5MDgwYTcwM2ExYzYxYzIxZDdkNGE2NWUyYWE2ZmNmMDZm
+    MGQ2ODE0ODlhMjEwNGJjMGI3ODk4NzQyNGE1MWI5YWUwYjlhNzQ1MDJiMDZm
+    MTIyMzRlMjZjMjdhMWI5MmE1ODRjYWE5NjNhMTdhNTIxMTY4OGM=

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+.DS_Store

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format d

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,25 @@
+PATH
+  remote: .
+  specs:
+    fallback_assets (0.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.2.5)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  fallback_assets!
+  rspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 djalmaaraujo
+
+MIT License
+
+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.md

@@ -0,0 +1,41 @@
+# Fallback Asset Gem
+Create fallbacks to your assets. Helpful to work with development and cdn assets.
+
+## Installation
+In your Gemfile:
+```ruby
+gem 'fallback_assets'
+```
+
+## Features
+* Add assets (javascripts / stylesheets) to your codebase with fallback to local files
+* Great to use with CDN assets (first idea)
+* The local asset will be used if the CDN is not available
+* Easy to config
+
+## How to use
+
+### Single use
+```haml
+= fallback_javascript :underscore
+= fallback_stylesheet :normalize
+```
+
+### Configuration
+Create a file config/fallback_assets.yml under your rails app.
+
+```yaml
+fallbacks:
+  stylesheets:
+    normalize:
+      production: //cdn/normalize.min.css
+      development: normalize.css
+
+  javascripts:
+    jquery:
+      production: //cdn/jquery.min.js
+      development: jquery.js
+```
+
+## Copyright
+Copyright © 2014 Djalma Araújo. See LICENSE.txt for further details.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/fallback_assets.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fallback_assets/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "fallback_assets"
+  spec.version       = FallbackAssets::VERSION
+  spec.authors       = ["djalmaaraujo"]
+  spec.email         = ["djalma.araujo@gmail.com"]
+  spec.description   = %q{Easy to use helper to work with your assets}
+  spec.summary       = %q{Create fallbacks to your assets. Helpful to work with development and cdn assets.}
+  spec.homepage      = "https://github.com/djalmaaraujo/fallback_assets"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency 'rspec'
+end

data/lib/fallback_assets/helper.rb

@@ -0,0 +1,18 @@
+require 'fallback_assets'
+
+module FallbackAssets
+  module Helper
+    def fallback_stylesheet(name)
+      asset = FallbackAssets::load_stylesheet(name)
+
+      FallbackAssets::HtmlAsset.new(asset).create_link
+    end
+
+    def fallback_javascript(name)
+      asset = FallbackAssets::load_javascript(name)
+
+      FallbackAssets::HtmlAsset.new(asset).create_script
+    end
+
+  end
+end

data/lib/fallback_assets/html_asset.rb

@@ -0,0 +1,17 @@
+require "fallback_assets"
+
+module FallbackAssets
+  class HtmlAsset
+    def initialize(asset)
+      @asset = asset
+    end
+
+    def create_script
+      "<script src=\"#{@asset}\"></script>"
+    end
+
+    def create_link
+      "<link rel=\"stylesheet\" href=\"#{@asset}\" />"
+    end
+  end
+end

data/lib/fallback_assets/railtie.rb

@@ -0,0 +1,10 @@
+require 'fallback_assets'
+require 'fallback_assets/helper'
+
+module FallbackAssets
+  class FallbackAssetsRailtie < Rails::Railtie
+    ActiveSupport.on_load(:action_view) do
+      include FallbackAssets::Helper
+    end
+  end
+end

data/lib/fallback_assets/version.rb

@@ -0,0 +1,3 @@
+module FallbackAssets
+  VERSION = "0.0.2"
+end

data/lib/fallback_assets.rb

@@ -0,0 +1,46 @@
+require 'yaml'
+require "fallback_assets/version"
+require "fallback_assets/html_asset"
+require "fallback_assets/railtie"
+
+module FallbackAssets
+  def self.load(type, name)
+    return false unless available_assets.include?(type)
+    return false unless type.is_a?(Symbol)
+    return false unless name.is_a?(Symbol)
+
+    asset = {type: type.to_s, name: name.to_s}
+    asset_from_environment(asset) || asset_from_environment(asset, "development")
+  end
+
+  def self.asset_from_environment(asset, env = false)
+    config = settings
+    env = environment || "development"
+
+    return false unless config["fallbacks"][asset[:type]]
+    return false unless config["fallbacks"][asset[:type]][asset[:name]]
+    return false unless config["fallbacks"][asset[:type]][asset[:name]][env]
+
+    config["fallbacks"][asset[:type]][asset[:name]][env]
+  end
+
+  def self.settings
+    YAML.load_file("#{Rails.root}/config/fallback_assets.yml")
+  end
+
+  def self.environment
+    ENV['RAILS_ENV']
+  end
+
+  def self.available_assets
+    [:javascripts, :stylesheets]
+  end
+
+  def self.load_javascript(name)
+    load(:javascripts, name)
+  end
+
+  def self.load_stylesheet(name)
+    load(:stylesheets, name)
+  end
+end

data/spec/fixtures/config/fallback_assets.yml

@@ -0,0 +1,10 @@
+fallbacks:
+  stylesheets:
+    normalize:
+      production: //cdn/normalize.min.css
+      development: normalize.css
+
+  javascripts:
+    jquery:
+      production: //cdn/jquery.min.js
+      development: jquery.js

data/spec/lib/fallback_assets/fallback_assets_spec.rb

@@ -0,0 +1,90 @@
+require 'spec_helper'
+require 'yaml'
+
+describe FallbackAssets do
+  specify { FallbackAssets.should be_a(Module) }
+
+  let(:settings) { YAML.load_file("spec/fixtures/config/fallback_assets.yml") }
+
+  before(:each) do
+    stub_const "Rails", double(root: "spec/fixtures")
+    stub_const "ENV", {"RAILS_ENV" => "development"}
+  end
+
+  describe "Configuration File" do
+    before do
+      YAML.stub(:load_file).with("#{Rails.root}/config/fallback_assets.yml").and_return(settings)
+    end
+
+    it "loads the configuration file into settings" do
+      expect(FallbackAssets.settings).to equal settings
+    end
+
+  end
+
+  describe "Asset loader" do
+
+    describe "#load" do
+
+      it "loads an asset with different types" do
+        expect(FallbackAssets.load(:javascripts, :jquery)).to eq "jquery.js"
+        expect(FallbackAssets.load(:stylesheets, :normalize)).to eq "normalize.css"
+      end
+
+      it 'loads an asset from a different environment' do
+        stub_const "ENV", {"RAILS_ENV" => "production"}
+        expect(FallbackAssets.load(:javascripts, :jquery)).to eq "//cdn/jquery.min.js"
+      end
+
+      it 'loads an asset from development if environment is crazy' do
+        stub_const "RAILS_ENV", "crazyenv"
+        expect(FallbackAssets.load(:javascripts, :jquery)).to eq "jquery.js"
+      end
+
+      it 'returns false for a non-symbol type or name' do
+        expect(FallbackAssets.load(false, false)).to be_false
+        expect(FallbackAssets.load(:javascripts, false)).to be_false
+        expect(FallbackAssets.load(false, :jquery)).to be_false
+      end
+
+      it 'returns false for a non valid asset type' do
+        expect(FallbackAssets.load(:javascripts, :pretty)).to be_false
+      end
+
+    end
+
+  end
+
+  describe "#load_javascript" do
+    it "returns an javascript asset for default environment" do
+      expect(FallbackAssets.load_javascript(:jquery)).to eq "jquery.js"
+    end
+
+    it "returns an javascript asset for production environment" do
+      stub_const "ENV", {"RAILS_ENV" => "production"}
+      expect(FallbackAssets.load_javascript(:jquery)).to eq "//cdn/jquery.min.js"
+    end
+
+    it "returns false when trying to load a existing stylesheet in config file" do
+      expect(FallbackAssets.load_javascript(:normalize)).to be_false
+    end
+
+  end
+
+  describe "#load_stylesheet" do
+    it "returns an stylesheet asset for default environment" do
+      expect(FallbackAssets.load_stylesheet(:normalize)).to eq "normalize.css"
+    end
+
+    it "returns an stylesheet asset for production environment" do
+      stub_const "ENV", {"RAILS_ENV" => "production"}
+      expect(FallbackAssets.load_stylesheet(:normalize)).to eq "//cdn/normalize.min.css"
+    end
+
+    it "returns false when trying to load a existing javascript in config file" do
+      expect(FallbackAssets.load_stylesheet(:jquery)).to be_false
+    end
+
+  end
+
+end

data/spec/lib/fallback_assets/helper_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+require 'fallback_assets/helper'
+
+describe FallbackAssets::Helper do
+  let(:settings) { YAML.load_file("spec/fixtures/config/fallback_assets.yml") }
+
+  before(:each) do
+    stub_const "Rails", double(root: "spec/fixtures")
+    stub_const "ENV", {"RAILS_ENV" => "development"}
+  end
+
+  include FallbackAssets::Helper
+
+  describe "#fallback_stylesheet" do
+
+    it "returns an stylesheet link tag" do
+      expect(fallback_stylesheet(:normalize)).to eq "<link rel=\"stylesheet\" href=\"normalize.css\" />"
+    end
+
+  end
+
+  describe "#fallback_javascript" do
+
+    it "returns an script tag" do
+      expect(fallback_javascript(:jquery)).to eq "<script src=\"jquery.js\"></script>"
+    end
+
+  end
+
+end

data/spec/lib/fallback_assets/html_asset_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+require 'fallback_assets/html_asset'
+
+describe FallbackAssets::HtmlAsset do
+  describe "#create_tag" do
+    it "returns a javascript tag for an loaded javascript asset" do
+      expect(FallbackAssets::HtmlAsset.new("jquery.js").create_script).to eq "<script src=\"jquery.js\"></script>"
+    end
+
+    it "returns a link tag for an loaded stylesheet asset" do
+      expect(FallbackAssets::HtmlAsset.new("normalize.css").create_link).to eq "<link rel=\"stylesheet\" href=\"normalize.css\" />"
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'fallback_assets'

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: fallback_assets
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- djalmaaraujo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Easy to use helper to work with your assets
+email:
+- djalma.araujo@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- fallback_assets.gemspec
+- lib/fallback_assets.rb
+- lib/fallback_assets/helper.rb
+- lib/fallback_assets/html_asset.rb
+- lib/fallback_assets/railtie.rb
+- lib/fallback_assets/version.rb
+- spec/fixtures/config/fallback_assets.yml
+- spec/lib/fallback_assets/fallback_assets_spec.rb
+- spec/lib/fallback_assets/helper_spec.rb
+- spec/lib/fallback_assets/html_asset_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/djalmaaraujo/fallback_assets
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.11
+signing_key: 
+specification_version: 4
+summary: Create fallbacks to your assets. Helpful to work with development and cdn
+  assets.
+test_files:
+- spec/fixtures/config/fallback_assets.yml
+- spec/lib/fallback_assets/fallback_assets_spec.rb
+- spec/lib/fallback_assets/helper_spec.rb
+- spec/lib/fallback_assets/html_asset_spec.rb
+- spec/spec_helper.rb