Class: Rake::SprocketsTask

Inherits:
TaskLib
  • Object
show all
Defined in:
lib/rake/sprocketstask.rb

Overview

Simple Sprockets compilation Rake task macro.

Rake::SprocketsTask.new do |t|
  t.environment = Sprockets::Environment.new
  t.output      = "./public/assets"
  t.assets      = %w( application.js application.css )
end

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name = :assets) {|_self| ... } ⇒ SprocketsTask

Returns a new instance of SprocketsTask.

Yields:

  • (_self)

Yield Parameters:



79
80
81
82
83
84
85
86
87
88
89
# File 'lib/rake/sprocketstask.rb', line 79

def initialize(name = :assets)
  @name         = name
  @environment  = lambda { Sprockets::Environment.new(Dir.pwd) }
  @logger       = Logger.new($stderr)
  @logger.level = Logger::INFO
  @keep         = 2

  yield self if block_given?

  define
end

Instance Attribute Details

#assetsObject

Array of asset logical paths to compile.

t.assets = %w( application.js jquery.js application.css )


50
51
52
# File 'lib/rake/sprocketstask.rb', line 50

def assets
  @assets
end

#environmentObject

‘Environment` instance used for finding assets.

You’ll most likely want to reassign ‘environment` to your own.

Rake::SprocketsTask.new do |t|
  t.environment = Foo::Assets
end


31
32
33
34
35
36
37
# File 'lib/rake/sprocketstask.rb', line 31

def environment
  if !@environment.is_a?(Sprockets::Base) && @environment.respond_to?(:call)
    @environment = @environment.call
  else
    @environment
  end
end

#keepObject

Number of old assets to keep.



53
54
55
# File 'lib/rake/sprocketstask.rb', line 53

def keep
  @keep
end

#loggerObject

Logger to use during rake tasks. Defaults to using stderr.

t.logger = Logger.new($stdout)


59
60
61
# File 'lib/rake/sprocketstask.rb', line 59

def logger
  @logger
end

#nameObject

Name of the task. Defaults to “assets”.

The name will also be used to suffix the clean and clobber tasks, “clean_assets” and “clobber_assets”.



21
22
23
# File 'lib/rake/sprocketstask.rb', line 21

def name
  @name
end

#outputObject

Directory to write compiled assets too. As well as the manifest file.

t.output = "./public/assets"


44
45
46
# File 'lib/rake/sprocketstask.rb', line 44

def output
  @output
end

Instance Method Details

#defineObject

Define tasks



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
# File 'lib/rake/sprocketstask.rb', line 92

def define
  desc name == :assets ? "Compile assets" : "Compile #{name} assets"
  task name do
    with_logger do
      manifest.compile(assets)
    end
  end

  desc name == :assets ? "Remove all assets" : "Remove all #{name} assets"
  task "clobber_#{name}" do
    with_logger do
      manifest.clobber
    end
  end

  task :clobber => ["clobber_#{name}"]

  desc name == :assets ? "Clean old assets" : "Clean old #{name} assets"
  task "clean_#{name}" do
    with_logger do
      manifest.clean(keep)
    end
  end

  task :clean => ["clean_#{name}"]
end

#log_levelObject

Returns logger level Integer.



62
63
64
# File 'lib/rake/sprocketstask.rb', line 62

def log_level
  @logger.level
end

#log_level=(level) ⇒ Object

Set logger level with constant or symbol.

t.log_level = Logger::INFO
t.log_level = :debug


71
72
73
74
75
76
77
# File 'lib/rake/sprocketstask.rb', line 71

def log_level=(level)
  if level.is_a?(Integer)
    @logger.level = level
  else
    @logger.level = Logger.const_get(level.to_s.upcase)
  end
end