class Webpacker::Manifest

Singleton registry for accessing the packs path using a generated manifest. This allows javascript_pack_tag, stylesheet_pack_tag, asset_pack_path to take a reference to, say, “calendar.js” or “calendar.css” and turn it into “/packs/calendar-1016838bab065ae1e314.js” or “/packs/calendar-1016838bab065ae1e314.css”.

When the configuration is set to on-demand compilation, with the `compile: true` option in the webpacker.yml file, any lookups will be preceded by a compilation if one is needed.

Public Class Methods

new(webpacker) click to toggle source
# File lib/webpacker/manifest.rb, line 13
def initialize(webpacker)
  @webpacker = webpacker
end

Public Instance Methods

lookup(name, pack_type = {}) click to toggle source

Computes the relative path for a given Webpacker asset using manifest.json. If no asset is found, returns nil.

Example:

Webpacker.manifest.lookup('calendar.js') # => "/packs/calendar-1016838bab065ae1e122.js"
# File lib/webpacker/manifest.rb, line 41
def lookup(name, pack_type = {})
  compile if compiling?

  find(full_pack_name(name, pack_type[:type]))
end
lookup!(name, pack_type = {}) click to toggle source

Like lookup, except that if no asset is found, raises a Webpacker::Manifest::MissingEntryError.

# File lib/webpacker/manifest.rb, line 48
def lookup!(name, pack_type = {})
  lookup(name, pack_type) || handle_missing_entry(name, pack_type)
end
lookup_pack_with_chunks(name, pack_type = {}) click to toggle source
# File lib/webpacker/manifest.rb, line 21
def lookup_pack_with_chunks(name, pack_type = {})
  compile if compiling?

  manifest_pack_type = manifest_type(pack_type[:type])
  manifest_pack_name = manifest_name(name, manifest_pack_type)
  find("entrypoints")[manifest_pack_name][manifest_pack_type]
rescue NoMethodError
  nil
end
lookup_pack_with_chunks!(name, pack_type = {}) click to toggle source
# File lib/webpacker/manifest.rb, line 31
def lookup_pack_with_chunks!(name, pack_type = {})
  lookup_pack_with_chunks(name, pack_type) || handle_missing_entry(name, pack_type)
end
refresh() click to toggle source
# File lib/webpacker/manifest.rb, line 17
def refresh
  @data = load
end

Private Instance Methods

compile() click to toggle source
# File lib/webpacker/manifest.rb, line 57
def compile
  Webpacker.logger.tagged("Webpacker") { compiler.compile }
end
compiling?() click to toggle source
# File lib/webpacker/manifest.rb, line 53
def compiling?
  config.compile? && !dev_server.running?
end
data() click to toggle source
# File lib/webpacker/manifest.rb, line 61
def data
  if config.cache_manifest?
    @data ||= load
  else
    refresh
  end
end
find(name) click to toggle source
# File lib/webpacker/manifest.rb, line 69
def find(name)
  data[name.to_s].presence
end
full_pack_name(name, pack_type) click to toggle source
# File lib/webpacker/manifest.rb, line 73
def full_pack_name(name, pack_type)
  return name unless File.extname(name.to_s).empty?
  "#{name}.#{manifest_type(pack_type)}"
end
handle_missing_entry(name, pack_type) click to toggle source
# File lib/webpacker/manifest.rb, line 78
def handle_missing_entry(name, pack_type)
  raise Webpacker::Manifest::MissingEntryError, missing_file_from_manifest_error(full_pack_name(name, pack_type[:type]))
end
load() click to toggle source
# File lib/webpacker/manifest.rb, line 82
def load
  if config.public_manifest_path.exist?
    JSON.parse config.public_manifest_path.read
  else
    {}
  end
end
manifest_name(name, pack_type) click to toggle source

The `manifest_name` method strips of the file extension of the name, because in the manifest hash the entrypoints are defined by their pack name without the extension. When the user provides a name with a file extension, we want to try to strip it off.

# File lib/webpacker/manifest.rb, line 93
def manifest_name(name, pack_type)
  return name if File.extname(name.to_s).empty?
  File.basename(name, pack_type)
end
manifest_type(pack_type) click to toggle source
# File lib/webpacker/manifest.rb, line 98
def manifest_type(pack_type)
  case pack_type
  when :javascript then "js"
  when :stylesheet then "css"
  else pack_type.to_s
  end
end
missing_file_from_manifest_error(bundle_name) click to toggle source
# File lib/webpacker/manifest.rb, line 106
    def missing_file_from_manifest_error(bundle_name)
      <<-MSG
Webpacker can't find #{bundle_name} in #{config.public_manifest_path}. Possible causes:
1. You want to set webpacker.yml value of compile to true for your environment
   unless you are using the `webpack -w` or the webpack-dev-server.
2. webpack has not yet re-run to reflect updates.
3. You have misconfigured Webpacker's config/webpacker.yml file.
4. Your webpack configuration is not creating a manifest.
Your manifest contains:
#{JSON.pretty_generate(@data)}
      MSG
    end