shakapacker 6.6.0 → 7.0.0.rc.0

data/spec/backward_compatibility_specs/dev_server_spec_bc.rb

@@ -0,0 +1,47 @@
+require_relative "spec_helper_initializer"
+
+describe "DevServer" do
+  it "doesn't run by default" do
+    expect(Webpacker.dev_server.running?).to be_falsy
+  end
+
+  it "uses localhost as host in development environment" do
+    with_rails_env("development") do
+      expect(Webpacker.dev_server.host).to eq "localhost"
+    end
+  end
+
+  it "uses port 3035 in development environment" do
+    with_rails_env("development") do
+      expect(Webpacker.dev_server.port).to eq 3035
+    end
+  end
+
+  it "doesn't use https in development environment" do
+    with_rails_env("development") do
+      expect(Webpacker.dev_server.https?).to be false
+    end
+  end
+
+  it "uses http protocol in development environment" do
+    with_rails_env("development") do
+      expect(Webpacker.dev_server.protocol).to eq "http"
+    end
+  end
+
+  it "sets host_with_port to localhost:3035 in development environment" do
+    with_rails_env("development") do
+      expect(Webpacker.dev_server.host_with_port).to eq "localhost:3035"
+    end
+  end
+
+  it "doesn't use pretty in development environment" do
+    with_rails_env("development") do
+      expect(Webpacker.dev_server.pretty?).to be false
+    end
+  end
+
+  it "users SHAKAPACKER_DEV_SERVER for DEFAULT_ENV_PREFIX" do
+    expect(Webpacker::DevServer::DEFAULT_ENV_PREFIX).to eq "SHAKAPACKER_DEV_SERVER"
+  end
+end

data/spec/backward_compatibility_specs/digest_strategy_spec_bc.rb

@@ -0,0 +1,35 @@
+require_relative "spec_helper_initializer"
+
+describe "DigestStrategy" do
+  def remove_compilation_digest_path
+    @digest_strategy.send(:compilation_digest_path).tap do |path|
+      path.delete if path.exist?
+    end
+  end
+
+  before :all do
+    @digest_strategy = Webpacker::DigestStrategy.new
+    remove_compilation_digest_path
+  end
+
+  after :all do
+    remove_compilation_digest_path
+  end
+
+  it "is not fresh before compilation" do
+    expect(@digest_strategy.stale?).to be true
+    expect(@digest_strategy.fresh?).to be_falsy
+  end
+
+  it "is fresh after compilation" do
+    @digest_strategy.after_compile_hook
+    expect(@digest_strategy.stale?).to be false
+    expect(@digest_strategy.fresh?).to be true
+  end
+
+  it "generates correct compilation_digest_path" do
+    actual_path = @digest_strategy.send(:compilation_digest_path).basename.to_s
+    expected_path = "last-compilation-digest-#{Webpacker.env}"
+    expect(actual_path).to eq expected_path
+  end
+end

data/spec/backward_compatibility_specs/engine_rake_tasks_spec_bc.rb

@@ -0,0 +1,44 @@
+require_relative "spec_helper_initializer"
+
+describe "EngineRakeTasks" do
+  before :context do
+    remove_webpack_binstubs
+  end
+
+  after :context do
+    remove_webpack_binstubs
+  end
+
+  it "mounts app:webpacker task successfully" do
+    output = Dir.chdir(mounted_app_path) { `rake -T` }
+    expect(output).to match /app:webpacker.+DEPRECATED/
+    expect(output).to match /app:webpacker:binstubs.+DEPRECATED/
+  end
+
+  it "binstubs adds only expected files to bin directory" do
+    Dir.chdir(mounted_app_path) { `bundle exec rake app:webpacker:binstubs` }
+    expected_binstub_paths.each { |path| expect(File.exist?(path)).to be true }
+  end
+
+  private
+    def mounted_app_path
+      File.expand_path("../mounted_app", __dir__)
+    end
+
+    def current_files_in_bin
+      Dir.glob("#{mounted_app_path}/test/dummy/bin/*")
+    end
+
+    def expected_binstub_paths
+      gem_path = File.expand_path("../..", __dir__)
+      Dir.chdir("#{gem_path}/lib/install/bin") do
+        Dir.glob("*").map { |file| "#{mounted_app_path}/test/dummy/bin/#{file}" }
+      end
+    end
+
+    def remove_webpack_binstubs
+      expected_binstub_paths.each do |path|
+        File.delete(path) if File.exist?(path)
+      end
+    end
+end

data/spec/backward_compatibility_specs/env_spec_bc.rb

@@ -0,0 +1,23 @@
+require_relative "spec_helper_initializer"
+
+RSpec.describe "Webpacker.env" do
+  it "uses the same env for Rails and Webpacker" do
+    expect(Webpacker.env).to eq Rails.env
+  end
+
+  it "uses production env without config" do
+    with_rails_env("foo") do
+      expect(Webpacker.env).to eq "production"
+    end
+  end
+
+  it "uses the given env in custom config" do
+    with_rails_env("staging") do
+      expect(Webpacker.env).to eq "staging"
+    end
+  end
+
+  it "uses 'production' as default env" do
+    expect(Webpacker::DEFAULT_ENV).to eq "production"
+  end
+end

data/spec/backward_compatibility_specs/helper_spec_bc.rb

@@ -0,0 +1,243 @@
+require_relative "spec_helper_initializer"
+
+module ActionView::TestCase::Behavior
+  attr_accessor :request
+
+  describe "Webpacker::Helper" do
+    let(:application_stylesheet_chunks) { %w[/packs/1-c20632e7baf2c81200d3.chunk.css /packs/application-k344a6d59eef8632c9d1.chunk.css] }
+    let(:hello_stimulus_stylesheet_chunks) { %w[/packs/1-c20632e7baf2c81200d3.chunk.css /packs/hello_stimulus-k344a6d59eef8632c9d1.chunk.css] }
+
+    before :each do
+      extend Webpacker::Helper
+      extend ActionView::Helpers
+      extend ActionView::Helpers::AssetTagHelper
+      extend ActionView::TestCase::Behavior
+
+      @request = Class.new do
+        def send_early_hints(links) end
+        def base_url
+          "https://example.com"
+        end
+      end.new
+      @javascript_pack_tag_loaded = nil
+    end
+
+    it "#asset_pack_path generates correct path" do
+      expect(asset_pack_path("bootstrap.js")).to eq "/packs/bootstrap-300631c4f0e0f9c865bc.js"
+      expect(asset_pack_path("bootstrap.css")).to eq "/packs/bootstrap-c38deda30895059837cf.css"
+    end
+
+    it "#asset_pack_url generates correct url" do
+      expect(asset_pack_url("bootstrap.js")).to eq "https://example.com/packs/bootstrap-300631c4f0e0f9c865bc.js"
+      expect(asset_pack_url("bootstrap.css")).to eq "https://example.com/packs/bootstrap-c38deda30895059837cf.css"
+    end
+
+    it "#image_pack_path generates correct path" do
+      expect(image_pack_path("application.png")).to eq "/packs/application-k344a6d59eef8632c9d1.png"
+      expect(image_pack_path("image.jpg")).to eq "/packs/static/image-c38deda30895059837cf.jpg"
+      expect(image_pack_path("static/image.jpg")).to eq "/packs/static/image-c38deda30895059837cf.jpg"
+      expect(image_pack_path("nested/image.jpg")).to eq "/packs/static/nested/image-c38deda30895059837cf.jpg"
+      expect(image_pack_path("static/nested/image.jpg")).to eq "/packs/static/nested/image-c38deda30895059837cf.jpg"
+    end
+
+    it "#image_pack_url generates correct path" do
+      expect(image_pack_url("application.png")).to eq "https://example.com/packs/application-k344a6d59eef8632c9d1.png"
+      expect(image_pack_url("image.jpg")).to eq "https://example.com/packs/static/image-c38deda30895059837cf.jpg"
+      expect(image_pack_url("static/image.jpg")).to eq "https://example.com/packs/static/image-c38deda30895059837cf.jpg"
+      expect(image_pack_url("nested/image.jpg")).to eq "https://example.com/packs/static/nested/image-c38deda30895059837cf.jpg"
+      expect(image_pack_url("static/nested/image.jpg")).to eq "https://example.com/packs/static/nested/image-c38deda30895059837cf.jpg"
+    end
+
+    it "#image_pack_tag generates correct tags" do
+      expect(image_pack_tag("application.png", size: "16x10", alt: "Edit Entry")).to eq "<img alt=\"Edit Entry\" src=\"/packs/application-k344a6d59eef8632c9d1.png\" width=\"16\" height=\"10\" />"
+      expect(image_pack_tag("image.jpg", size: "16x10", alt: "Edit Entry")).to eq "<img alt=\"Edit Entry\" src=\"/packs/static/image-c38deda30895059837cf.jpg\" width=\"16\" height=\"10\" />"
+      expect(image_pack_tag("static/image.jpg", size: "16x10", alt: "Edit Entry")).to eq "<img alt=\"Edit Entry\" src=\"/packs/static/image-c38deda30895059837cf.jpg\" width=\"16\" height=\"10\" />"
+      expect(image_pack_tag("nested/image.jpg", size: "16x10", alt: "Edit Entry")).to eq "<img alt=\"Edit Entry\" src=\"/packs/static/nested/image-c38deda30895059837cf.jpg\" width=\"16\" height=\"10\" />"
+      expect(image_pack_tag("static/nested/image.jpg", size: "16x10", alt: "Edit Entry")).to eq "<img alt=\"Edit Entry\" src=\"/packs/static/nested/image-c38deda30895059837cf.jpg\" width=\"16\" height=\"10\" />"
+      expect(image_pack_tag("static/image.jpg", srcset: { "static/image-2x.jpg" => "2x" })).to eq "<img srcset=\"/packs/static/image-2x-7cca48e6cae66ec07b8e.jpg 2x\" src=\"/packs/static/image-c38deda30895059837cf.jpg\" />"
+    end
+
+    it "#favicon_pack_tag generates correct tags" do
+      expect(favicon_pack_tag("application.png", rel: "apple-touch-icon", type: "image/png")).to eq "<link rel=\"apple-touch-icon\" type=\"image/png\" href=\"/packs/application-k344a6d59eef8632c9d1.png\" />"
+      expect(favicon_pack_tag("mb-icon.png", rel: "apple-touch-icon", type: "image/png")).to eq "<link rel=\"apple-touch-icon\" type=\"image/png\" href=\"/packs/static/mb-icon-c38deda30895059837cf.png\" />"
+      expect(favicon_pack_tag("static/mb-icon.png", rel: "apple-touch-icon", type: "image/png")).to eq "<link rel=\"apple-touch-icon\" type=\"image/png\" href=\"/packs/static/mb-icon-c38deda30895059837cf.png\" />"
+      expect(favicon_pack_tag("nested/mb-icon.png", rel: "apple-touch-icon", type: "image/png")).to eq "<link rel=\"apple-touch-icon\" type=\"image/png\" href=\"/packs/static/nested/mb-icon-c38deda30895059837cf.png\" />"
+      expect(favicon_pack_tag("static/nested/mb-icon.png", rel: "apple-touch-icon", type: "image/png")).to eq "<link rel=\"apple-touch-icon\" type=\"image/png\" href=\"/packs/static/nested/mb-icon-c38deda30895059837cf.png\" />"
+    end
+
+    it "#preload_pack_asset generates correct tag" do
+      if self.class.method_defined?(:preload_link_tag)
+        expect(preload_pack_asset("fonts/fa-regular-400.woff2")).to eq %(<link rel="preload" href="/packs/fonts/fa-regular-400-944fb546bd7018b07190a32244f67dc9.woff2" as="font" type="font/woff2" crossorigin="anonymous">)
+      else
+        expect { preload_pack_asset("fonts/fa-regular-400.woff2") }.to raise_error "You need Rails >= 5.2 to use this tag."
+      end
+    end
+
+    it "#javascript_pack_tag generates correct tags" do
+      expected = <<~HTML.chomp
+        <script src="/packs/vendors~application~bootstrap-c20632e7baf2c81200d3.chunk.js" defer="defer"></script>
+        <script src="/packs/vendors~application-e55f2aae30c07fb6d82a.chunk.js" defer="defer"></script>
+        <script src="/packs/application-k344a6d59eef8632c9d1.js" defer="defer"></script>
+        <script src="/packs/bootstrap-300631c4f0e0f9c865bc.js" defer="defer"></script>
+      HTML
+
+      expect(javascript_pack_tag("application", "bootstrap")).to eq expected
+    end
+
+    it "#javascript_pack_tag generates correct tags by passing `defer: false`" do
+      expected = <<~HTML.chomp
+        <script src="/packs/vendors~application~bootstrap-c20632e7baf2c81200d3.chunk.js"></script>
+        <script src="/packs/vendors~application-e55f2aae30c07fb6d82a.chunk.js"></script>
+        <script src="/packs/application-k344a6d59eef8632c9d1.js"></script>
+        <script src="/packs/bootstrap-300631c4f0e0f9c865bc.js"></script>
+      HTML
+
+      expect(javascript_pack_tag("application", "bootstrap", defer: false)).to eq expected
+    end
+
+    it "#javascript_pack_tag generates correct appended tag" do
+      append_javascript_pack_tag("bootstrap", defer: false)
+
+      expected = <<~HTML.chomp
+        <script src="/packs/vendors~application~bootstrap-c20632e7baf2c81200d3.chunk.js" defer="defer"></script>
+        <script src="/packs/vendors~application-e55f2aae30c07fb6d82a.chunk.js" defer="defer"></script>
+        <script src="/packs/application-k344a6d59eef8632c9d1.js" defer="defer"></script>
+        <script src="/packs/bootstrap-300631c4f0e0f9c865bc.js"></script>
+      HTML
+
+      expect(javascript_pack_tag("application")).to eq expected
+    end
+
+    it "#javascript_pack_tag generates correct prepended tag" do
+      append_javascript_pack_tag("bootstrap")
+      prepend_javascript_pack_tag("main")
+
+      expected = <<~HTML.chomp
+        <script src="/packs/main-e323a53c7f30f5d53cbb.js" defer="defer"></script>
+        <script src="/packs/bootstrap-300631c4f0e0f9c865bc.js" defer="defer"></script>
+        <script src="/packs/vendors~application~bootstrap-c20632e7baf2c81200d3.chunk.js" defer="defer"></script>
+        <script src="/packs/vendors~application-e55f2aae30c07fb6d82a.chunk.js" defer="defer"></script>
+        <script src="/packs/application-k344a6d59eef8632c9d1.js" defer="defer"></script>
+      HTML
+
+      expect(javascript_pack_tag("application")).to eq expected
+    end
+
+    it "#append_javascript_pack_tag raises error if called after calling #javascript_pack_tag" do
+      expected_error_message = \
+        "You can only call append_javascript_pack_tag before javascript_pack_tag helper. " +
+        "Please refer to https://github.com/shakacode/shakapacker/blob/master/README.md#view-helper-append_javascript_pack_tag-prepend_javascript_pack_tag-and-append_stylesheet_pack_tag for the usage guide"
+
+      expect {
+        javascript_pack_tag("application")
+        append_javascript_pack_tag("bootstrap", defer: false)
+      }.to raise_error(expected_error_message)
+    end
+
+    it "#prepend_javascript_pack_tag raises error if called after calling #javascript_pack_tag" do
+      expected_error_message = \
+        "You can only call prepend_javascript_pack_tag before javascript_pack_tag helper. " +
+        "Please refer to https://github.com/shakacode/shakapacker/blob/master/README.md#view-helper-append_javascript_pack_tag-prepend_javascript_pack_tag-and-append_stylesheet_pack_tag for the usage guide"
+
+      expect {
+        javascript_pack_tag("application")
+        prepend_javascript_pack_tag("bootstrap", defer: false)
+      }.to raise_error(expected_error_message)
+    end
+
+    it "#javascript_pack_tag generates correct tags by passing `defer: true`" do
+      expected = <<~HTML.chomp
+        <script src="/packs/vendors~application~bootstrap-c20632e7baf2c81200d3.chunk.js" defer="defer"></script>
+        <script src="/packs/vendors~application-e55f2aae30c07fb6d82a.chunk.js" defer="defer"></script>
+        <script src="/packs/application-k344a6d59eef8632c9d1.js" defer="defer"></script>
+      HTML
+
+      expect(javascript_pack_tag("application", defer: true)).to eq expected
+    end
+
+    it "#javascript_pack_tag generates correct tags by passing symbol" do
+      expected = <<~HTML.chomp
+        <script src="/packs/vendors~application~bootstrap-c20632e7baf2c81200d3.chunk.js" defer="defer"></script>
+        <script src="/packs/vendors~application-e55f2aae30c07fb6d82a.chunk.js" defer="defer"></script>
+        <script src="/packs/application-k344a6d59eef8632c9d1.js" defer="defer"></script>
+      HTML
+
+      expect(javascript_pack_tag(:application)).to eq expected
+    end
+
+    it "#javascript_pack_tag rases error on multiple invocations" do
+      expected_error_message = "To prevent duplicated chunks on the page, you should call javascript_pack_tag only once on the page. " +
+      "Please refer to https://github.com/shakacode/shakapacker/blob/master/README.md#view-helpers-javascript_pack_tag-and-stylesheet_pack_tag for the usage guide"
+
+      expect {
+        javascript_pack_tag(:application)
+        javascript_pack_tag(:bootstrap)
+      }.to raise_error(expected_error_message)
+    end
+
+    it "#stylesheet_pack_tag generates correct link tag with string arguments" do
+      expected = (application_stylesheet_chunks + hello_stimulus_stylesheet_chunks)
+        .uniq
+        .map { |chunk| stylesheet_link_tag(chunk) }
+        .join("\n")
+
+      expect(stylesheet_pack_tag("application", "hello_stimulus")).to eq expected
+    end
+
+    it "#stylesheet_pack_tag generates correct link tag with symbol arguments" do
+      expected = (application_stylesheet_chunks + hello_stimulus_stylesheet_chunks)
+        .uniq
+        .map { |chunk| stylesheet_link_tag(chunk) }
+        .join("\n")
+
+      expect(stylesheet_pack_tag(:application, :hello_stimulus)).to eq expected
+    end
+
+    it "#stylesheet_pack_tag generates correct link tag with mixed arguments" do
+      expected = (application_stylesheet_chunks)
+        .map { |chunk| stylesheet_link_tag(chunk, media: "all") }
+        .join("\n")
+
+      expect(stylesheet_pack_tag("application", media: "all")).to eq expected
+    end
+
+    it "#stylesheet_pack_tag allows multiple invocations" do
+      app_style = stylesheet_pack_tag(:application)
+      stimulus_style = stylesheet_pack_tag(:hello_stimulus)
+
+      expect(app_style).to eq application_stylesheet_chunks.map { |chunk| stylesheet_link_tag(chunk) }.join("\n")
+
+      expect(stimulus_style).to eq hello_stimulus_stylesheet_chunks.map { |chunk| stylesheet_link_tag(chunk) }.join("\n")
+
+      expect {
+        stylesheet_pack_tag(:application)
+        stylesheet_pack_tag(:hello_stimulus)
+      }.to_not raise_error
+    end
+
+    it "#stylesheet_pack_tag appends" do
+      append_stylesheet_pack_tag(:hello_stimulus)
+
+      expect(stylesheet_pack_tag(:application)).to eq \
+        (application_stylesheet_chunks + hello_stimulus_stylesheet_chunks).uniq.map { |chunk| stylesheet_link_tag(chunk) }.join("\n")
+    end
+
+    it "#stylesheet_pack_tag appends duplicate" do
+      append_stylesheet_pack_tag(:hello_stimulus)
+      append_stylesheet_pack_tag(:application)
+
+      expect(stylesheet_pack_tag(:application)).to eq \
+        (application_stylesheet_chunks + hello_stimulus_stylesheet_chunks).uniq.map { |chunk| stylesheet_link_tag(chunk) }.join("\n")
+    end
+
+    it "#stylesheet_pack_tag supports multiple invocations with different media attr" do
+      app_style = stylesheet_pack_tag(:application)
+      app_style_with_media = stylesheet_pack_tag(:application, media: "print")
+      hello_stimulus_style_with_media = stylesheet_pack_tag(:hello_stimulus, media: "all")
+
+      expect(app_style).to eq application_stylesheet_chunks.map { |chunk| stylesheet_link_tag(chunk) }.join("\n")
+      expect(app_style_with_media).to eq application_stylesheet_chunks.map { |chunk| stylesheet_link_tag(chunk, media: "print") }.join("\n")
+      expect(hello_stimulus_style_with_media).to eq hello_stimulus_stylesheet_chunks.map { |chunk| stylesheet_link_tag(chunk, media: "all") }.join("\n")
+    end
+  end
+end

data/spec/backward_compatibility_specs/instance_spec_bc.rb

@@ -0,0 +1,31 @@
+require_relative "spec_helper_initializer"
+
+describe "Webpacker::Instance" do
+  before :each do
+    ENV.delete("WEBPACKER_CONFIG")
+    ENV.delete("SHAKAPACKER_CONFIG")
+    Webpacker.instance = Webpacker::Instance.new
+  end
+
+  after :each do
+    ENV.delete("WEBPACKER_CONFIG")
+    ENV.delete("SHAKAPACKER_CONFIG")
+    Webpacker.instance = Webpacker::Instance.new
+  end
+
+  it "uses default config path if no env variable defined" do
+    actual_config_path = Rails.root.join("config/webpacker.yml")
+    expected_config_path = Webpacker.config.config_path
+
+    expect(expected_config_path).to eq(actual_config_path)
+  end
+
+  it "uses WEBPACKER_CONFIG env variable for config file" do
+    ENV["WEBPACKER_CONFIG"] = "/some/random/path.yml"
+
+    actual_config_path = "/some/random/path.yml"
+    expected_config_path = Webpacker.config.config_path.to_s
+
+    expect(Webpacker.config.config_path.to_s).to eq("/some/random/path.yml")
+  end
+end

data/spec/backward_compatibility_specs/manifest_spec_bc.rb

@@ -0,0 +1,100 @@
+require_relative "spec_helper_initializer"
+
+describe "Webpacker::Manifest" do
+  let(:manifest_path) { File.expand_path File.join(File.dirname(__FILE__), "webpacker_test_app/public/packs", "manifest.json").to_s }
+
+  it "#lookup! throws exception for a non-existing asset file" do
+    asset_file = "calendar.js"
+    expected_error_message = "Shakapacker can't find #{asset_file} in #{manifest_path}"
+
+    allow(Webpacker.config).to receive(:compile?).and_return(false)
+
+    expect {
+      Webpacker.manifest.lookup!(asset_file)
+    }.to raise_error(Webpacker::Manifest::MissingEntryError, /#{expected_error_message}/)
+  end
+
+  it "#lookup! throws exception for a non-existing asset file with type and without extension" do
+    asset_file = "calendar"
+    expected_error_message = "Shakapacker can't find #{asset_file}.js in #{manifest_path}"
+
+    allow(Webpacker.config).to receive(:compile?).and_return(false)
+
+    expect {
+      Webpacker.manifest.lookup!(asset_file, type: :javascript)
+    }.to raise_error(Webpacker::Manifest::MissingEntryError, /#{expected_error_message}/)
+  end
+
+  it "#lookup! returns path to bundled bootstrap.js" do
+    actual = Webpacker.manifest.lookup!("bootstrap.js")
+    expected = "/packs/bootstrap-300631c4f0e0f9c865bc.js"
+
+    expect(actual).to eq expected
+  end
+
+  it "#lookup_pack_with_chunks! returns array of path to bundled bootstrap with type of javascript" do
+    actual = Webpacker.manifest.lookup_pack_with_chunks!("bootstrap", type: :javascript)
+    expected = ["/packs/bootstrap-300631c4f0e0f9c865bc.js"]
+
+    expect(actual).to eq expected
+  end
+
+  it "#lookup_with_chunks! returns array of path to bundled bootstrap.js with type of javascript" do
+    actual = Webpacker.manifest.lookup_pack_with_chunks!("bootstrap.js", type: :javascript)
+    expected = ["/packs/bootstrap-300631c4f0e0f9c865bc.js"]
+
+    expect(actual).to eq expected
+  end
+
+  it "#lookup_with_chunks! returns array of path to bundled 'print/application' without extension and in a sub-directory" do
+    actual = Webpacker.manifest.lookup_pack_with_chunks!("print/application", type: :css)
+    expected = ["/packs/print/application-983b6c164a47f7ed49cd.css"]
+
+    expect(actual).to eq expected
+  end
+
+  it "#lookup_with_chunks! returns array of path to bundled 'print/application.css' in a sub-directory" do
+    actual = Webpacker.manifest.lookup_pack_with_chunks!("print/application.css", type: :css)
+    expected = ["/packs/print/application-983b6c164a47f7ed49cd.css"]
+
+    expect(actual).to eq expected
+  end
+
+  it "#lookup returns nil for non-existing asset file" do
+    expect(Webpacker.manifest.lookup("foo.js")).to be nil
+  end
+
+  it "#lookup_pack_with_chunks returns nil for non-existing asset file" do
+    expect(Webpacker.manifest.lookup_pack_with_chunks("foo.js")).to be nil
+  end
+
+  it "#lookup returns path for bootstrap.js" do
+    actual = Webpacker.manifest.lookup("bootstrap.js")
+    expected = "/packs/bootstrap-300631c4f0e0f9c865bc.js"
+
+    expect(actual).to eq expected
+  end
+
+  it "#lookup_pack_with_chunks! throws exception for a non-existing asset file" do
+    asset_file = "calendar"
+
+    expected_error_message = "Shakapacker can't find #{asset_file}.js in #{manifest_path}"
+
+    allow(Webpacker.config).to receive(:compile?).and_return(false)
+
+    expect {
+      Webpacker.manifest.lookup_pack_with_chunks!(asset_file, type: :javascript)
+    }.to raise_error(Shakapacker::Manifest::MissingEntryError, /#{expected_error_message}/)
+  end
+
+  it "#lookup_pack_with_chunks! returns array of paths to bundled js files with 'application' in their name" do
+    actual_application_entrypoints = Webpacker.manifest.lookup_pack_with_chunks!("application", type: :javascript)
+    expected_application_entrypoints = [
+      "/packs/vendors~application~bootstrap-c20632e7baf2c81200d3.chunk.js",
+      "/packs/vendors~application-e55f2aae30c07fb6d82a.chunk.js",
+      "/packs/application-k344a6d59eef8632c9d1.js"
+    ]
+
+    expect(actual_application_entrypoints).to eq expected_application_entrypoints
+  end
+end

data/spec/backward_compatibility_specs/mtime_strategy_spec_bc.rb

@@ -0,0 +1,55 @@
+require_relative "spec_helper_initializer"
+
+describe "Webpacker::MtimeStrategy" do
+  let(:mtime_strategy) { Webpacker::MtimeStrategy.new }
+  let(:manifest_timestamp) { Time.parse("2021-01-01 12:34:56 UTC") }
+
+  describe "#fresh?" do
+    it "returns false when manifest is missing" do
+      latest_timestamp = manifest_timestamp + 3600
+
+      with_stubs(latest_timestamp: latest_timestamp.to_i, manifest_exists: false) do
+        expect(mtime_strategy.fresh?).to be false
+      end
+    end
+
+    it "returns false when manifest is older" do
+      latest_timestamp = manifest_timestamp + 3600
+
+      with_stubs(latest_timestamp: latest_timestamp.to_i) do
+        expect(mtime_strategy.fresh?).to be false
+      end
+    end
+
+    it "returns true when manifest is new" do
+      latest_timestamp = manifest_timestamp - 3600
+
+      with_stubs(latest_timestamp: latest_timestamp.to_i) do
+        expect(mtime_strategy.fresh?).to be true
+      end
+    end
+  end
+
+  describe "#stale?" do
+    it "returns false when #fresh? is true" do
+      expect(mtime_strategy).to receive(:fresh?).and_return(true)
+
+      expect(mtime_strategy.stale?).to be false
+    end
+
+    it "returns true when #fresh? is false" do
+      expect(mtime_strategy).to receive(:fresh?).and_return(false)
+
+      expect(mtime_strategy.stale?).to be true
+    end
+  end
+
+  private
+
+    def with_stubs(latest_timestamp:, manifest_exists: true)
+      allow(mtime_strategy).to receive(:latest_modified_timestamp).and_return(latest_timestamp)
+      allow(FileTest).to receive(:exist?).and_return(manifest_exists)
+      allow(File).to receive(:mtime).and_return(manifest_timestamp)
+      yield
+    end
+end

data/spec/backward_compatibility_specs/rake_tasks_spec_bc.rb

@@ -0,0 +1,37 @@
+require_relative "spec_helper_initializer"
+
+describe "RakeTasks" do
+  let(:test_app_path) { File.expand_path("webpacker_test_app", __dir__) }
+
+  it "`rake -T` lists Webpacker tasks" do
+    output = Dir.chdir(test_app_path) { `rake -T` }
+    expect(output).to match /webpacker .+DEPRECATED/
+    expect(output).to match /webpacker:check_binstubs.+DEPRECATED/
+    expect(output).to match /webpacker:check_node.+DEPRECATED/
+    expect(output).to match /webpacker:check_yarn.+DEPRECATED/
+    expect(output).to match /webpacker:clean.+DEPRECATED/
+    expect(output).to match /webpacker:clobber.+DEPRECATED/
+    expect(output).to match /webpacker:compile.+DEPRECATED/
+    expect(output).to match /webpacker:install.+DEPRECATED/
+    expect(output).to match /webpacker:verify_install.+DEPRECATED/
+  end
+
+  it "`webpacker:check_binstubs` doesn't get 'webpack binstub not found' error" do
+    output = Dir.chdir(test_app_path) { `rake webpacker:check_binstubs 2>&1` }
+    expect(output).to_not include "webpack binstub not found."
+    expect(output).to include "DEPRECATION"
+  end
+
+  it "`webpacker:check_node` doesn't get 'webpacker requires Node.js' error" do
+    output = Dir.chdir(test_app_path) { `rake webpacker:check_node 2>&1` }
+    expect(output).to_not include "Shakapacker requires Node.js"
+    expect(output).to include "DEPRECATION"
+  end
+
+  it "`webpacker:check_yarn` doesn't get error related to yarn" do
+    output = Dir.chdir(test_app_path) { `rake webpacker:check_yarn 2>&1` }
+    expect(output).to_not include "Yarn not installed"
+    expect(output).to_not include "Shakapacker requires Yarn"
+    expect(output).to include "DEPRECATION"
+  end
+end

data/spec/backward_compatibility_specs/spec_helper_initializer.rb

@@ -0,0 +1,24 @@
+require_relative "webpacker_test_app/config/environment"
+
+Rails.env = "production"
+
+Webpacker.instance = ::Webpacker::Instance.new
+
+def reloaded_config
+  Webpacker.instance.instance_variable_set(:@env, nil)
+  Webpacker.instance.instance_variable_set(:@config, nil)
+  Webpacker.instance.instance_variable_set(:@dev_server, nil)
+  Webpacker.env
+  Webpacker.config
+  Webpacker.dev_server
+end
+
+def with_rails_env(env)
+  original = Rails.env
+  Rails.env = ActiveSupport::StringInquirer.new(env)
+  reloaded_config
+  yield
+ensure
+  Rails.env = ActiveSupport::StringInquirer.new(original)
+  reloaded_config
+end