graspi 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 026da42ada36b8537b7fdbdcb3c2f5e3ab89b24d
+  data.tar.gz: 10c97444c4a5980027b698298eaf20a6b6ed0802
+SHA512:
+  metadata.gz: 1ad876869e47fe1ef3c070b3639c95f2c1e7f30c58b9ab770a1dd4eada04a89f708b24127a12bdf26697d27d93ae93650cb8512aec6a8f5a11d3090aff62619d
+  data.tar.gz: 93b3a6b844238164db0da4be96dc04068ef806c66a2db71d32319bcacc6de5b6e7e8de7ea462b8b3990adadd60867798f5fd3a6f09edc1ce77875c9d48d825ff

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 wonderweblabs / Sascha Hillig
+
+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,3 @@
+# graspi
+
+Grunt asset pipeline with additional helpers for rails and middleman

data/Rakefile

@@ -0,0 +1,31 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Graspi'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+
+load 'rails/tasks/engine.rake'
+load 'rails/tasks/statistics.rake'
+
+Bundler::GemHelper.install_tasks
+
+Dir[File.join(File.dirname(__FILE__), 'tasks/**/*.rake')].each {|f| load f }
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+desc "Run all specs in spec directory (excluding plugin specs)"
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+
+task default: :spec

data/lib/graspi.rb

@@ -0,0 +1,64 @@
+# for rails
+if defined?(Rails)
+  require 'rails/all'
+
+  require "graspi/engine"
+
+  require "graspi/helpers/assets_include_helper"
+end
+
+require 'yaml'
+require 'json'
+
+module Graspi
+
+  def self.root
+    File.expand_path '../..', __FILE__
+  end
+
+  def self.config_file
+    @@config_file ||= 'graspi.yml'
+  end
+
+  def self.config_file=(config)
+    @@config_file = config
+  end
+
+  def self.config(env = nil)
+    @@config ||= begin
+      config = {}
+      config_yaml = YAML.load_file(self.config_file)
+
+      config_yaml['environments'].each do |env_name|
+        config[env_name] = config_yaml[env_name].clone
+      end
+
+      config_yaml['environments'].each do |env_name|
+        config_yaml.delete(env_name)
+      end
+
+      config_yaml['environments'].each do |env_name|
+        config[env_name] = config_yaml.clone.merge(config[env_name])
+      end
+
+      config
+    end
+
+    if env.nil?
+      @@config
+    else
+      @@config[env]
+    end
+  end
+
+  def self.manifest_path(env)
+    File.join(Graspi.root, self.config(env)['manifest']['path'])
+  end
+
+  def self.manifest(env)
+    file = File.read(self.manifest_path(env))
+
+    JSON.parse(file)[env]
+  end
+
+end

data/lib/graspi/engine.rb

@@ -0,0 +1,14 @@
+module Graspi
+  class Engine < ::Rails::Engine
+    isolate_namespace Graspi
+    engine_name 'graspi'
+
+    # add graspi helpers to app
+    initializer 'graspi.add_helpers' do |app|
+      ActiveSupport.on_load(:action_view) do
+        include Graspi::AssetsIncludeHelper
+      end
+    end
+
+  end
+end

data/lib/graspi/helpers/assets_include_helper.rb

@@ -0,0 +1,45 @@
+module Graspi
+  module AssetsIncludeHelper
+
+    def graspi_stylesheet_link_tag(*sources)
+      options = sources.extract_options!.stringify_keys
+
+      sources.uniq.map { |source|
+        tag_options = {
+          "rel" => "stylesheet",
+          "media" => "screen",
+          "href" => graspi_file_path("#{source}.css")
+        }.merge!(options)
+        tag(:link, tag_options)
+      }.join("\n").html_safe
+    end
+
+    def graspi_javascript_include_tag(*sources)
+      options = sources.extract_options!.stringify_keys
+
+      sources.uniq.map { |source|
+        tag_options = {
+          "src" => graspi_file_path("#{source}.js")
+        }.merge!(options)
+        content_tag(:script, "", tag_options)
+      }.join("\n").html_safe
+    end
+
+    def graspi_image_url(path)
+      graspi_file_path(path)
+    end
+
+    def graspi_image_tag(path, options = {})
+      tag_options = options.merge({ src: graspi_file_path(path) })
+
+      tag(:img, tag_options)
+    end
+
+    def graspi_file_path(path)
+      mapping = Graspi.manifest(Rails.env)
+
+      mapping[path]
+    end
+
+  end
+end

data/lib/graspi/version.rb

@@ -0,0 +1,3 @@
+module Graspi
+  VERSION = "0.0.1"
+end

data/lib/grunt/graspi.coffee

@@ -0,0 +1,87 @@
+#
+# graspi       -> base module
+# task runner  -> task execution with some preparing mechanisms and
+#                 environment switches.
+# eac          -> "environment app config" the config for a specific environment
+#                 for a specific app. Values:
+#                   * eac.env_name  - Name of the environment
+#                   * eac.env       - Environment config hash
+#                   * eac.app_name  - Name of the app
+#                   * eac.app       - App config hash
+#                   * eac.appConfig - Merged config (base + env + app)
+# eai          -> "environment app iterator" utility to iterate over all combinations
+#                 of environments and apps. You can use "eachWithTargets" or "each" and
+#                 pass a callback function. The funcation will get an eac object
+#                 as parameter.
+#
+module.exports = (grunt, configPath) ->
+
+  require('./tasks/bower')(grunt, configPath)
+  require('./tasks/image_min')(grunt, configPath)
+  require('./tasks/css')(grunt, configPath)
+  require('./tasks/js')(grunt, configPath)
+  require('./tasks/filerev')(grunt, configPath)
+  require('./tasks/manifest')(grunt, configPath)
+  require('./tasks/browsersync')(grunt, configPath)
+  require('./tasks/watch')(grunt, configPath)
+
+  _           = require('./util/lodash_extensions')
+  taskRunner  = require('./util/task_runner')(grunt, configPath)
+
+  cfg =
+    taskRunner: taskRunner
+    eai: taskRunner.getEai()
+    config: taskRunner.getC()
+
+
+  # ----------------------------------------------------------------
+  # base tasks
+  # ----------------------------------------------------------------
+
+  grunt.registerTask 'graspi', (t1, t2) ->
+    taskRunner.runGruntTask 'graspi_bower', t1, t2
+    taskRunner.runGruntTask 'graspi_image_min', t1, t2
+    taskRunner.runGruntTask 'graspi_css', t1, t2
+    taskRunner.runGruntTask 'graspi_js', t1, t2
+    taskRunner.runGruntTask 'graspi_filerev', t1, t2
+    taskRunner.runGruntTask 'graspi_manifest', t1, t2
+    taskRunner.runGruntTask 'graspi_css_replace_urls', t1, t2
+
+  grunt.registerTask 'graspi_clean', (t1, t2) ->
+    taskRunner.runGruntTask 'graspi_bower_clean', t1, t2
+    taskRunner.runGruntTask 'graspi_image_min_clean', t1, t2
+    taskRunner.runGruntTask 'graspi_css_clean', t1, t2
+    taskRunner.runGruntTask 'graspi_js_clean', t1, t2
+    taskRunner.runGruntTask 'graspi_filerev_clean', t1, t2
+    taskRunner.runGruntTask 'graspi_manifest_clean', t1, t2
+
+  grunt.registerTask 'graspi_clean_full', (t1, t2) ->
+    taskRunner.runGruntTask 'graspi_bower_clean_full', t1, t2
+    taskRunner.runGruntTask 'graspi_image_min_clean_full', t1, t2
+    taskRunner.runGruntTask 'graspi_css_clean_full', t1, t2
+    taskRunner.runGruntTask 'graspi_js_clean_full', t1, t2
+    taskRunner.runGruntTask 'graspi_filerev_clean_full', t1, t2
+    taskRunner.runGruntTask 'graspi_manifest_clean_full', t1, t2
+
+
+  # ----------------------------------------------------------------
+  # build dynamic tasks
+  # ----------------------------------------------------------------
+
+  customTasks = []
+  taskRunner.getEai().each (eac) ->
+    customTasks = customTasks.concat(Object.keys(eac.appConfig.tasks || {}))
+  customTasks = _.uniq(customTasks)
+
+  _.each customTasks, (task) ->
+    grunt.registerTask task, (t1, t2) ->
+      taskRunner.runDynamicTask task, t1, t2
+
+  # ----------------------------------------------------------------
+  return cfg
+
+
+
+
+
+

data/lib/grunt/task_helpers/abstract.coffee

@@ -0,0 +1,47 @@
+module.exports = class AbstractTaskHelper
+
+  constructor: (grunt, config, eac) ->
+    @_   = require('../util/lodash_extensions')
+    @g   = grunt
+    @c   = config
+    @eac = eac
+
+  buildConfig: ->
+    @g.fail.fatal 'Implement buildConfig method.'
+
+  run: ->
+    return unless @isEnabled()
+
+    @g.config.set("#{@getGruntTask()}.#{@getGruntTaskTarget()}", @buildConfig())
+    @g.task.run "#{@getGruntTask()}:#{@getGruntTaskTarget()}"
+
+  isEnabled: ->
+    true
+
+  getCacheKey: ->
+    "#{@eac.env_name}-#{@eac.app_name}"
+
+  getGruntTaskTarget: ->
+    "#{@eac.env_name}-#{@eac.app_name}"
+
+  getGruntTask: ->
+    @g.fail.fatal 'Implement getGruntTask method.'
+
+  getFileCache: ->
+    @fileChangeTracker or= require('../util/file_change_tracker')(@g, @eac)
+
+  getConfig: ->
+    @eac.appConfig
+
+  getAppConfig: ->
+    @getConfig().config
+
+
+  fileCacheHasChanged: (path) ->
+    @getFileCache().hasChanged(path, @getCacheKey())
+
+  fileCacheUpdate: (path) ->
+    @getFileCache().update(path, @getCacheKey())
+
+  fileCacheClean: ->
+    @getFileCache().clean(@getCacheKey())

data/lib/grunt/task_helpers/bower/abstract.coffee

@@ -0,0 +1,8 @@
+module.exports = class AbstractTaskHelper extends require('../abstract')
+
+  getCacheKey: ->
+    "bower-#{@eac.env_name}-#{@eac.app_name}"
+
+  isEnabled: ->
+    @eac.appConfig.bowerConcat.enabled == true
+

data/lib/grunt/task_helpers/bower/clean.coffee

@@ -0,0 +1,6 @@
+module.exports = class TaskHelper extends require('./abstract')
+
+  run: ->
+    return unless @isEnabled()
+
+    @fileCacheClean()

data/lib/grunt/task_helpers/bower/clean_full.coffee

@@ -0,0 +1,19 @@
+module.exports = class TaskHelper extends require('./abstract')
+
+  getGruntTask: ->
+    'clean'
+
+  getGruntTaskTarget: ->
+    "graspi-bower-clean-#{super()}"
+
+  buildConfig: ->
+    cfg     = {}
+    cfg.src = []
+
+    if @_.isObject(@eac.appConfig.config.js)
+      cfg.src.push "#{@eac.appConfig.tmp.js}/#{@eac.appConfig.config.js.destFile}/1_bower.js"
+
+    if @_.isObject(@eac.appConfig.config.css)
+      cfg.src.push "#{@eac.appConfig.tmp.css}/#{@eac.appConfig.config.css.destFile}/1_bower.css"
+
+    cfg

data/lib/grunt/task_helpers/bower/concat.coffee

@@ -0,0 +1,37 @@
+module.exports = class TaskHelper extends require('./abstract')
+
+  getGruntTask: ->
+    'bower_concat'
+
+  getGruntTaskTarget: ->
+    "graspi-bower-concat-#{super()}"
+
+  isEnabled: ->
+    return false unless super() == true
+
+    @eac.appConfig.bowerConcat._tmp.compile == true
+
+  buildConfig: ->
+    cfg = {}
+
+    if @_.isObject(@eac.appConfig.config.js)
+      cfg.dest = "#{@eac.appConfig.tmp.js}/#{@eac.appConfig.config.js.destFile}/1_bower.js"
+
+    if @_.isObject(@eac.appConfig.config.css)
+      cfg.cssDest   = "#{@eac.appConfig.tmp.css}/#{@eac.appConfig.config.css.destFile}/1_bower.css"
+
+    if @_.isArray(@eac.appConfig.bowerConcat.include)
+      cfg.include = @eac.appConfig.bowerConcat.include
+    else if @_.isArray(@eac.appConfig.bowerConcat.exclude)
+      cfg.exclude = @eac.appConfig.bowerConcat.exclude
+
+    if @_.isObject(@eac.appConfig.bowerConcat.dependencies)
+      cfg.dependencies = @eac.appConfig.bowerConcat.dependencies
+
+    cfg.callback = (mainFiles, component) =>
+      @_.each mainFiles, (path) =>
+        @fileCacheUpdate(path)
+
+      mainFiles
+
+    cfg

data/lib/grunt/task_helpers/bower/concat_check.coffee

@@ -0,0 +1,40 @@
+module.exports = class TaskHelper extends require('./abstract')
+
+  getGruntTask: ->
+    'bower_concat'
+
+  getGruntTaskTarget: ->
+    "graspi-bower-concat-check-#{super()}"
+
+  buildConfig: ->
+    cfg = {}
+
+    @eac.appConfig.bowerConcat._tmp         = {}
+    @eac.appConfig.bowerConcat._tmp.compile = false
+
+    if @_.isObject(@eac.appConfig.config.js)
+      cfg.dest = "#{@eac.appConfig.tmp.js}/#{@eac.appConfig.config.js.destFile}/1_bower.js"
+
+    if @_.isObject(@eac.appConfig.config.css)
+      cfg.cssDest   = "#{@eac.appConfig.tmp.css}/#{@eac.appConfig.config.css.destFile}/1_bower.css"
+
+    if @_.isArray(@eac.appConfig.bowerConcat.include)
+      cfg.include = @eac.appConfig.bowerConcat.include
+    else if @_.isArray(@eac.appConfig.bowerConcat.exclude)
+      cfg.exclude = @eac.appConfig.bowerConcat.exclude
+
+    if @_.isObject(@eac.appConfig.bowerConcat.dependencies)
+      cfg.dependencies = @eac.appConfig.bowerConcat.dependencies
+
+    cfg.callback = (mainFiles, component) =>
+      return [] if @eac.appConfig.bowerConcat._tmp.compile == true
+
+      @_.each mainFiles, (path) =>
+        return if @eac.appConfig.bowerConcat._tmp.compile == true
+        return if @fileCacheHasChanged(path) == false
+
+        @eac.appConfig.bowerConcat._tmp.compile = true
+
+      []
+
+    cfg