Class: Sprockets::BundledAsset

Inherits:
Asset
  • Object
show all
Defined in:
lib/sprockets/bundled_asset.rb

Overview

`BundledAsset`s are used for files that need to be processed and concatenated with other assets. Use for `.js` and `.css` files.

Instance Attribute Summary collapse

Attributes inherited from Asset

#content_type, #digest, #length, #logical_path, #mtime, #pathname

Instance Method Summary collapse

Methods inherited from Asset

#digest_path, #each, #eql?, from_hash, #hash, #inspect, #stale?, #to_s, #write_to

Constructor Details

#initialize(environment, logical_path, pathname) ⇒ BundledAsset

Returns a new instance of BundledAsset


13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# File 'lib/sprockets/bundled_asset.rb', line 13

def initialize(environment, logical_path, pathname)
  super(environment, logical_path, pathname)

  @processed_asset  = environment.find_asset(pathname, :bundle => false)
  @required_assets  = @processed_asset.required_assets
  @dependency_paths = @processed_asset.dependency_paths

  # Explode Asset into parts and gather the dependency bodies
  @source = to_a.map { |dependency| dependency.to_s }.join

  # Run bundle processors on concatenated source
  context = environment.context_class.new(environment, logical_path, pathname)
  @source = context.evaluate(pathname, :data => @source,
              :processors => environment.bundle_processors(content_type))

  @mtime  = (to_a + @dependency_paths).map(&:mtime).max
  @length = Rack::Utils.bytesize(source)
  @digest = environment.digest.update(source).hexdigest
end

Instance Attribute Details

#sourceObject (readonly)

Returns the value of attribute source


11
12
13
# File 'lib/sprockets/bundled_asset.rb', line 11

def source
  @source
end

Instance Method Details

#bodyObject

Get asset's own processed contents. Excludes any of its required dependencies but does run any processors or engines on the original file.


58
59
60
# File 'lib/sprockets/bundled_asset.rb', line 58

def body
  @processed_asset.source
end

#dependenciesObject

Return an `Array` of `Asset` files that are declared dependencies.


63
64
65
# File 'lib/sprockets/bundled_asset.rb', line 63

def dependencies
  to_a.reject { |a| a.eql?(@processed_asset) }
end

#encode_with(coder) ⇒ Object

Serialize custom attributes in `BundledAsset`.


48
49
50
51
52
53
# File 'lib/sprockets/bundled_asset.rb', line 48

def encode_with(coder)
  super

  coder['source'] = source
  coder['required_assets_digest'] = @processed_asset.dependency_digest
end

#fresh?(environment) ⇒ Boolean

Checks if Asset is stale by comparing the actual mtime and digest to the inmemory model.

Returns:

  • (Boolean)

74
75
76
# File 'lib/sprockets/bundled_asset.rb', line 74

def fresh?(environment)
  @processed_asset.fresh?(environment)
end

#init_with(environment, coder) ⇒ Object

Initialize `BundledAsset` from serialized `Hash`.


34
35
36
37
38
39
40
41
42
43
44
45
# File 'lib/sprockets/bundled_asset.rb', line 34

def init_with(environment, coder)
  super

  @processed_asset = environment.find_asset(pathname, :bundle => false)
  @required_assets = @processed_asset.required_assets

  if @processed_asset.dependency_digest != coder['required_assets_digest']
    raise UnserializeError, "processed asset belongs to a stale environment"
  end

  @source = coder['source']
end

#to_aObject

Expand asset into an `Array` of parts.


68
69
70
# File 'lib/sprockets/bundled_asset.rb', line 68

def to_a
  required_assets
end