Module: ReactOnRails::PackerUtils

Defined in:
lib/react_on_rails/packer_utils.rb

Class Method Summary collapse

Class Method Details

.bundle_js_uri_from_packer(bundle_name) ⇒ Object

This returns either a URL for the webpack-dev-server, non-server bundle or the hashed server bundle if using the same bundle for the client. Otherwise returns a file path.



70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/react_on_rails/packer_utils.rb', line 70

def self.bundle_js_uri_from_packer(bundle_name)
  hashed_bundle_name = packer.manifest.lookup!(bundle_name)

  # Support for hashing the server-bundle and having that built
  # the webpack-dev-server is provided by the config value
  # "same_bundle_for_client_and_server" where a value of true
  # would mean that the bundle is created by the webpack-dev-server
  is_server_bundle = bundle_name == ReactOnRails.configuration.server_bundle_js_file

  if packer.dev_server.running? && (!is_server_bundle ||
    ReactOnRails.configuration.same_bundle_for_client_and_server)
    "#{packer.dev_server.protocol}://#{packer.dev_server.host_with_port}#{hashed_bundle_name}"
  else
    File.expand_path(File.join("public", hashed_bundle_name)).to_s
  end
end

.check_manifest_not_cached ⇒ Object 



118
119
120
121
122
123
124
125
126
127
128
 
# File 'lib/react_on_rails/packer_utils.rb', line 118

def self.check_manifest_not_cached
  return unless using_packer? && packer.config.cache_manifest?

  msg = <<-MSG.strip_heredoc
      ERROR: you have enabled cache_manifest in the #{Rails.env} env when using the
      ReactOnRails::TestHelper.configure_rspec_to_compile_assets helper
      To fix this: edit your config/#{packer_type}.yml file and set cache_manifest to false for test.
  MSG
  puts wrap_message(msg)
  exit!
end

.dev_server_running? ⇒ Boolean

Returns:

  • (Boolean) 


42
43
44
45
46
 
# File 'lib/react_on_rails/packer_utils.rb', line 42

def self.dev_server_running?
  return false unless using_packer?

  packer.dev_server.running?
end

.manifest_exists? ⇒ Boolean

Returns:

  • (Boolean) 


110
111
112
 
# File 'lib/react_on_rails/packer_utils.rb', line 110

def self.manifest_exists?
  packer.config.public_manifest_path.exist?
end

.nested_entries? ⇒ Boolean

Returns:

  • (Boolean) 


102
103
104
 
# File 'lib/react_on_rails/packer_utils.rb', line 102

def self.nested_entries?
  packer.config.nested_entries?
end

.packer ⇒ Object 



31
32
33
34
35
36
37
38
39
40
 
# File 'lib/react_on_rails/packer_utils.rb', line 31

def self.packer
  return nil unless using_packer?

  if using_shakapacker_const?
    require "shakapacker"
    return ::Shakapacker
  end
  require "webpacker"
  ::Webpacker
end

.packer_public_output_path ⇒ Object 



106
107
108
 
# File 'lib/react_on_rails/packer_utils.rb', line 106

def self.packer_public_output_path
  packer.config.public_output_path.to_s
end

.packer_source_entry_path ⇒ Object 



98
99
100
 
# File 'lib/react_on_rails/packer_utils.rb', line 98

def self.packer_source_entry_path
  packer.config.source_entry_path
end

.packer_source_path ⇒ Object 



94
95
96
 
# File 'lib/react_on_rails/packer_utils.rb', line 94

def self.packer_source_path
  packer.config.source_path
end

.packer_source_path_explicit? ⇒ Boolean

Returns:

  • (Boolean) 


114
115
116
 
# File 'lib/react_on_rails/packer_utils.rb', line 114

def self.packer_source_path_explicit?
  packer.config.send(:data)[:source_path].present?
end

.packer_type ⇒ Object 



24
25
26
27
28
29
 
# File 'lib/react_on_rails/packer_utils.rb', line 24

def self.packer_type
  return "shakapacker" if using_shakapacker_const?
  return "webpacker" if using_webpacker_const?

  nil
end

.precompile? ⇒ Boolean

Returns:

  • (Boolean) 


87
88
89
90
91
92
 
# File 'lib/react_on_rails/packer_utils.rb', line 87

def self.precompile?
  return ::Webpacker.config.webpacker_precompile? if using_webpacker_const?
  return ::Shakapacker.config.shakapacker_precompile? if using_shakapacker_const?

  false
end

.raise_nested_entries_disabled ⇒ Object

Raises:



142
143
144
145
146
147
148
149
150
 
# File 'lib/react_on_rails/packer_utils.rb', line 142

def self.raise_nested_entries_disabled
  msg = <<~MSG
    **ERROR** ReactOnRails: `nested_entries` is configured to be disabled in shakapacker. Please update \
    config/#{packer_type}.yml to enable nested entries. for more information read
    https://www.shakacode.com/react-on-rails/docs/guides/file-system-based-automated-bundle-generation.md#enable-nested_entries-for-shakapacker
  MSG

  raise ReactOnRails::Error, msg
end

.raise_shakapacker_not_installed ⇒ Object

Raises:



162
163
164
165
166
167
168
169
170
 
# File 'lib/react_on_rails/packer_utils.rb', line 162

def self.raise_shakapacker_not_installed
  msg = <<~MSG
    **ERROR** ReactOnRails: Missing Shakapacker gem. Please upgrade to use Shakapacker \
    #{semver_to_string(ReactOnRails::PacksGenerator::MINIMUM_SHAKAPACKER_VERSION)} or above to use the \
    automated bundle generation feature.
  MSG

  raise ReactOnRails::Error, msg
end

.raise_shakapacker_version_incompatible_for_autobundling ⇒ Object

Raises:



152
153
154
155
156
157
158
159
160
 
# File 'lib/react_on_rails/packer_utils.rb', line 152

def self.raise_shakapacker_version_incompatible_for_autobundling
  msg = <<~MSG
    **ERROR** ReactOnRails: Please upgrade Shakapacker to version #{semver_to_string(ReactOnRails::PacksGenerator::MINIMUM_SHAKAPACKER_VERSION)} or \
    above to use the automated bundle generation feature. The currently installed version is \
    #{semver_to_string(ReactOnRails::PackerUtils.shakapacker_version_as_array)}.
  MSG

  raise ReactOnRails::Error, msg
end

.semver_to_string(ary) ⇒ Object 



172
173
174
 
# File 'lib/react_on_rails/packer_utils.rb', line 172

def self.semver_to_string(ary)
  "#{ary[0]}.#{ary[1]}.#{ary[2]}"
end

.shakapacker_version ⇒ Object 



48
49
50
51
52
53
 
# File 'lib/react_on_rails/packer_utils.rb', line 48

def self.shakapacker_version
  return @shakapacker_version if defined?(@shakapacker_version)
  return nil unless ReactOnRails::Utils.gem_available?("shakapacker")

  @shakapacker_version = Gem.loaded_specs["shakapacker"].version.to_s
end

.shakapacker_version_as_array ⇒ Object 



55
56
57
58
59
 
# File 'lib/react_on_rails/packer_utils.rb', line 55

def self.shakapacker_version_as_array
  match = shakapacker_version.match(ReactOnRails::VersionChecker::MAJOR_MINOR_PATCH_VERSION_REGEX)

  @shakapacker_version_as_array = [match[1].to_i, match[2].to_i, match[3].to_i]
end

.shakapacker_version_requirement_met?(required_version) ⇒ Boolean

Returns:

  • (Boolean) 


61
62
63
64
65
 
# File 'lib/react_on_rails/packer_utils.rb', line 61

def self.shakapacker_version_requirement_met?(required_version)
  req_ver = semver_to_string(required_version)

  Gem::Version.new(shakapacker_version) >= Gem::Version.new(req_ver)
end

.using_packer? ⇒ Boolean

Returns:

  • (Boolean) 


5
6
7
 
# File 'lib/react_on_rails/packer_utils.rb', line 5

def self.using_packer?
  using_shakapacker_const? || using_webpacker_const?
end

.using_shakapacker_const? ⇒ Boolean

Returns:

  • (Boolean) 


9
10
11
12
13
14
 
# File 'lib/react_on_rails/packer_utils.rb', line 9

def self.using_shakapacker_const?
  return @using_shakapacker_const if defined?(@using_shakapacker_const)

  @using_shakapacker_const = ReactOnRails::Utils.gem_available?("shakapacker") &&
                             shakapacker_version_requirement_met?([7, 0, 0])
end

.using_webpacker_const? ⇒ Boolean

Returns:

  • (Boolean) 


16
17
18
19
20
21
22
 
# File 'lib/react_on_rails/packer_utils.rb', line 16

def self.using_webpacker_const?
  return @using_webpacker_const if defined?(@using_webpacker_const)

  @using_webpacker_const = (ReactOnRails::Utils.gem_available?("shakapacker") &&
                      shakapacker_version_as_array[0] <= 6) ||
                           ReactOnRails::Utils.gem_available?("webpacker")
end

.webpack_assets_status_checker ⇒ Object 



130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/react_on_rails/packer_utils.rb', line 130

def self.webpack_assets_status_checker
  source_path = ReactOnRails::Utils.source_path
  generated_assets_full_path = ReactOnRails::Utils.generated_assets_full_path
  webpack_generated_files = ReactOnRails.configuration.webpack_generated_files

  @webpack_assets_status_checker ||= ReactOnRails::TestHelper::WebpackAssetsStatusChecker.new(
    source_path: source_path,
    generated_assets_full_path: generated_assets_full_path,
    webpack_generated_files: webpack_generated_files
  )
end