module Sprockets::ManifestUtils

Public: Manifest utilities.

Constants

LEGACY_MANIFEST_RE
MANIFEST_RE

Public Instance Methods

find_directory_manifest(dirname) click to toggle source

Public: Find or pick a new manifest filename for target build directory.

dirname - String dirname

Examples

find_directory_manifest("/app/public/assets")
# => "/app/public/assets/.sprockets-manifest-abc123.json"

Returns String filename.

# File lib/sprockets/manifest_utils.rb, line 36
def find_directory_manifest(dirname)
  entries = File.directory?(dirname) ? Dir.entries(dirname) : []
  entry = entries.find { |e| e =~ MANIFEST_RE } ||
    # Deprecated: Will be removed in 4.x
    entries.find { |e| e =~ LEGACY_MANIFEST_RE } ||
    generate_manifest_path
  File.join(dirname, entry)
end
generate_manifest_path() click to toggle source

Public: Generate a new random manifest path.

Manifests are not intended to be accessed publicly, but typically live alongside public assets for convenience. To avoid being served, the filename is prefixed with a “.” which is usually hidden by web servers like Apache. To help in other environments that may not control this, a random hex string is appended to the filename to prevent people from guessing the location. If directory indexes are enabled on the server, all bets are off.

Return String path.

# File lib/sprockets/manifest_utils.rb, line 22
def generate_manifest_path
  ".sprockets-manifest-#{SecureRandom.hex(16)}.json"
end