tension 0.3

data/LICENSE

@@ -0,0 +1,23 @@
+LICENSE
+
+The MIT License
+
+Copyright (c) 2013 Piers Mainwaring
+
+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,6 @@
+Tension
+=======
+_Tighten up Rails's asset pipeline for CSS & JS._
+
+Rails's asset pipeline is smart and well–implemented under the hood, but it can
+be a challenge to organize your CSS and JavaScript so that 

data/lib/tension/application.rb

@@ -0,0 +1,62 @@
+module Tension
+  class Application
+
+    class << self
+
+      # This method collects all asset paths for the asset pipeline to
+      # precompile. It's called from `config/application.rb` when determining
+      # which additional assets to include in the pipeline's precompilation
+      # process. Tension will assume that any subdirectories in your assets
+      # directory are module scopes. You can also explicitly set module scopes:
+      #
+      #   Rails.application.config.tension_modules = %W( blog account )
+      #
+      # Tension::Application will then search for all javascripts and stylesheets
+      # one filesystem level deep in those scopes. The search paths become:
+      #
+      #   app/assets/{javascripts,stylesheets}/*.{js,css}
+      #   app/assets/{javascripts,stylesheets}/{blog,account}/**/*.{js,css}
+      # 
+      # Any assets in these paths will be added to the pipeline and compiled.
+
+      def collect_assets
+        assets = %W(stylesheets javascripts).map do |type|
+          glob_within_asset_path( type ) + module_scopes.map do |scope|
+            glob_within_asset_path( type, scope )
+          end
+        end
+
+        assets.flatten
+      end
+
+
+      private
+
+      def module_scopes
+        # find dirs in app/assets
+      end
+
+      # Loads the file paths within a given subdirectory of "app/assets/".
+      def glob_within_asset_path type, *path_parts
+        # Only recursively find children if a particular subdirectory of an
+        # asset `type` is given. That way we can specify WHICH subdirectories
+        # of a `type` have assets that matter.
+        path_parts << "**" if path_parts.present?
+
+        root_path = File.join(Rails.root, "app", "assets", type)
+        pattern   = File.expand_path( File.join(*path_parts, "*.*"), root_path )
+
+        paths = Dir.glob( pattern ).map do |file_path|
+          # Remove extra, pre-compilation file extensions and any part of the
+          # filepath at or above the asset `type`.
+          file_path.gsub( file_path.match(/(\.css|\.js)(.*)/)[2], '' )
+                   .gsub( root_path + "/", '' ) rescue nil
+        end
+
+        paths.compact
+      end
+
+    end
+
+  end
+end

data/lib/tension/railtie.rb

@@ -0,0 +1,17 @@
+require "tension"
+
+module Tension
+  require "rails"
+
+  class Railtie < Rails::Railtie
+
+    initializer "tension.asset_pipeline" do |app|
+      ActiveSupport.on_load :rails do
+        if !Rails.env.development? && !Rails.env.test?
+          Rails.application.config.assets.precompile += Tension::Collector.collect_assets
+        end
+      end
+    end
+
+  end
+end

data/lib/tension/tagger.rb

@@ -0,0 +1,82 @@
+module Pipeline
+  class Builder
+
+    GLOBAL_ASSET_NAME = "application".freeze
+    SHARED_SUFFIX     = "_common".freeze
+    ASSET_SPECIFICITY_ORDER = [ :action, :controller, :module ].freeze
+
+    # Determines which JS/CSS files should be included based on the current
+    # controller, action, and which files actually exist. If the current
+    # controller is "OrcaHealth::PagesController" and action is "products",
+    # this method (called with `type = :js`) will attempt to include
+    #
+    #   + orca_health/pages/products.js
+    #   + orca_health/pages_common.js
+    #   + orca_health.js
+    #
+    # in that order. ONLY THE FIRST ASSET LOCATED WILL BE INCLUDED. Hence,
+    # you should always use Sprockets directives to include dependencies.
+    #
+    # Any files that don't exist will not be included in the page. Pass
+    # `{ except: :application }` to exclude `application.{js,css}`.
+
+    def self.asset_paths type, controller_path, action_name, options = {}
+      options[:except] = [ options[:except] ] unless options[:except].is_a? Array
+
+      # Check if the best asset's already been loaded and stored.
+      asset = known_asset_paths[ controller_path ].try(:fetch, action_name, nil).try(:fetch, type, nil)
+
+      if asset.nil?
+        path_components = controller_path.split("/")
+        controller_name = path_components.pop
+        module_path     = path_components.join("/")
+
+        possible_paths = {
+          module:     module_path,
+          controller: [ module_path, controller_name + SHARED_SUFFIX ].join("/"),
+          action:     [ module_path, controller_name, action_name ].join("/")
+        }
+
+        # Find and store the best possible asset for this controller/action combo.
+        asset = most_specific_asset_path( type, possible_paths )
+
+        known_asset_paths[ controller_path ] ||= Hash.new
+        known_asset_paths[ controller_path ][ action_name ] ||= Hash.new
+        known_asset_paths[ controller_path ][ action_name ][ type ] = asset
+      end
+
+      assets = if options[:except].include? :application
+        [ asset ]
+      else
+        [ GLOBAL_ASSET_NAME, asset ]
+      end
+
+      assets.compact
+    end
+
+
+    private
+
+    def self.known_asset_paths
+      @known_asset_paths ||= Hash.new
+    end
+
+    def self.most_specific_asset_path filetype, paths
+      ASSET_SPECIFICITY_ORDER.each do |name|
+        path = paths[name]
+
+        # Using the Sprockets `#index` helps performance in production.
+        asset = if Rails.env.production?
+          Rails.application.assets.index.find_asset([ path, filetype ].join("."))
+        else
+          Rails.application.assets.find_asset([ path, filetype ].join("."))
+        end
+
+        # This loop is relatively expensive, so return the asset path as soon
+        # as possible rather than continue looping.
+        break path if asset.present?
+      end
+    end
+
+  end
+end

data/tension.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |s|
+  s.name = "tension"
+
+  s.version = "0.3"
+  s.date    = "2013-02-22"
+
+  s.summary     = "Tighten up Rails's asset pipeline for CSS & JS."
+  s.description = "Tension brings some sanity to CSS & JS organization for modern front–end development."
+
+  s.authors  = [ "Piers Mainwaring" ]
+  s.email    = "piers@impossibly.org"
+  s.files    = `git ls-files`.split("\n")
+  s.homepage = "https://github.com/piersadrian/tension"
+  s.require_paths = [ "lib" ]
+
+  s.add_dependency "activerecord",  "~> 3.2.0"
+  s.add_dependency "activesupport", "~> 3.2.0"
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: tension
+version: !ruby/object:Gem::Version
+  version: '0.3'
+  prerelease: 
+platform: ruby
+authors:
+- Piers Mainwaring
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+    none: false
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+    none: false
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+    none: false
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+    none: false
+description: Tension brings some sanity to CSS & JS organization for modern front–end
+  development.
+email: piers@impossibly.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/tension.rb
+- lib/tension/application.rb
+- lib/tension/railtie.rb
+- lib/tension/tagger.rb
+- tension.gemspec
+homepage: https://github.com/piersadrian/tension
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Tighten up Rails's asset pipeline for CSS & JS.
+test_files: []