nanoc-webpack.rb 0.5.5 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3e798ff00aa45852e59880aac435054ddf29b3682655e8a9935de50300cfc72
-  data.tar.gz: 1acef686fc1ff408aa5681d307c7879a9c1aada3a85c51912a6adc25a4fd5480
+  metadata.gz: 22ee6ae13d75181d02e95948c6f00446a7f92effe96fcc87c8e017f95c707a3e
+  data.tar.gz: bccc782d822fe1b6f843204a45b6eff75f677979bc7f4c68c853a71351f649ce
 SHA512:
-  metadata.gz: c47e5a09a5a71e485eedb9a9a6e781d89067c3b86d7128fcb3b8a08ec51cfbb0c851c61b6709b1e7ec332573ea8209a467b2f64eb1d84082562def20920ec3b1
-  data.tar.gz: c3cd143a1b31f035c30339d5c434b1859a4d450a313879a517c843009f9f109419b5632d87650070c20be2c971234ed8820be52213fe1f5f418377fc76d575c7
+  metadata.gz: 6dc66a6c40e1cadcdd50de9acd480ec69d80364bcd1b61e31345fdf4ab817fa7bb51c31fdd0790971b6915cbcce80c372b600b932cb450fac4caf947aa113579
+  data.tar.gz: 6509714bfa75b8d55b7030736a94f8ea66226bd7a86ceecc958c1749d08abc58618940a4cb1c009924bc76a172dedab0ccb6956facfb9e77145c222c6de73211

data/.rubocop.yml

@@ -45,6 +45,10 @@ RSpec/DescribeClass:
   Enabled: false
 RSpec/ImplicitSubject:
   Enabled: false
+RSpec/MessageSpies:
+  Enabled: false
+RSpec/MultipleMemoizedHelpers:
+  Enabled: false
 Style/LambdaCall:
   Enabled: false
 Layout/MultilineMethodCallIndentation:

data/README.md

@@ -10,21 +10,27 @@ connects nanoc, and the JavaScript, TypeScript, and nodejs ecosystems.
 
 ## Examples
 
-__app.ts__
+### Defaults
 
-The following example forwards the entry point `app.ts` to webpack, and
-then writes the result of the webpack compilation to `app.js`:
+#### /js/main/App.tsx
+
+The following example forwards the entry point `/js/main/App.tsx` to webpack,
+and then writes the result to `/js/app.js`. This example and all the other
+examples assume that the files `webpack.config.js`, `tsconfig.json`, and
+`package.json` already exist at the root of the project:
 
 ``` ruby
 # Rules
 require "nanoc-webpack"
-compile "/js/app.ts" do
+compile "/js/main/App.tsx" do
   filter(:webpack)
   write("/js/app.js")
 end
 ```
 
-__Option: "depend_on"__
+### Options
+
+#### Option: "depend_on"
 
 The `depend_on` option tells nanoc what files an entry point imports or requires.
 When a file being tracked by the `depend_on` option undergoes a change, nanoc
@@ -33,13 +39,13 @@ will initiate a recompilation of the entry point:
 ```ruby
 # Rules
 require "nanoc-webpack"
-compile "/js/ReactApp.jsx" do
+compile "/js/main/App.tsx" do
   filter(:webpack, depend_on: ["/js/lib", "/js/components", "/js/hooks"])
   write("/js/app.js")
 end
 ```
 
-__Option: "reject"__
+#### Option: "reject"
 
 The `depend_on` option can be combined with the `reject` option to exclude
 certain files or directories from being tracked. For example, maybe you want
@@ -48,7 +54,7 @@ to track `/js/lib/` but not `/js/lib/foo/`:
 ```ruby
 # Rules
 require "nanoc-webpack"
-compile "/js/ReactApp.jsx" do
+compile "/js/main/App.tsx" do
   filter :webpack,
          depend_on: ["/js/lib", "/js/components", "/js/hooks"],
          reject: proc { |path| path.start_with?("/js/lib/foo/") }
@@ -56,16 +62,20 @@ compile "/js/ReactApp.jsx" do
 end
 ```
 
-__Option: "args"__
+#### Option: "args"
 
 The `args` option can be used to forward command-line options directly
-to the webpack executable. See `$ webpack build --help` for the list of
-options that are available:
+to the webpack executable.
+<br>
+`$ webpack build --help verbose` provides a list of all available options,
+and
+[Nanoc::Webpack.default_options](https://0x1eef.github.io/x/nanoc-webpack.rb/Nanoc/Webpack.html#default_options-class_method)
+returns the default options nanoc-webpack.rb will forward to webpack:
 
 ```ruby
 # Rules
 require "nanoc-webpack"
-compile "/js/ReactApp.jsx" do
+compile "/js/main/App.tsx" do
   filter :webpack, args: {"--no-stats" => true}
   write("/js/app.js")
 end
@@ -77,8 +87,6 @@ end
 nanoc-webpack.rb assumes that:
 
 * A "node" executable is available in $PATH.
-* [npm](https://www.npmjs.com) or [yarn](https://yarnpkg.com/) are used for
-  package management.
 * "webpack" / "webpack-cli" exist as dependencies in package.json.
 
 ## Sources
@@ -98,7 +106,7 @@ are available as sources.
 
 ```ruby
 # Gemfile
-gem "nanoc-webpack.rb", github: "0x1eef/nanoc-webpack.rb", tag: "v0.5.4"
+gem "nanoc-webpack.rb", github: "0x1eef/nanoc-webpack.rb", tag: "v0.5.6"
 ```
 
 **Rubygems.org**

data/lib/nanoc/webpack/filter.rb

@@ -12,18 +12,23 @@ class Nanoc::Webpack::Filter < Nanoc::Filter
   type :text
 
   ##
+  # @example
+  #   Nanoc::Webpack.default_options.merge!(
+  #     "--cache-type" => "memory"
+  #   )
+  #
   # @return [Hash]
-  #  Returns the default command-line options given
-  #  to the webpack executable.
+  #  Returns the default command-line options given to webpack.
   def self.default_options
-    @default_options ||= {}
+    @default_options ||= {"--cache-type" => "filesystem"}
   end
 
   def run(content, options = {})
+    args = options[:args] || options["args"] || {}
     depend_on dependable(paths: options[:depend_on], reject: options[:reject])
               .map { items[_1] }
     webpack temporary_file_for(content),
-            args: self.class.default_options.merge(options[:args] || {})
+            args: self.class.default_options.merge(args)
   end
 
   private
@@ -57,7 +62,7 @@ class Nanoc::Webpack::Filter < Nanoc::Filter
   def temporary_file_for(content)
     dir = File.join(Dir.getwd, "tmp", "nanoc-webpack.rb")
     mkdir_p(dir) unless Dir.exist?(dir)
-    file = Tempfile.new(File.basename(item.identifier.to_s), dir)
+    file = Tempfile.new(File.basename(@item.identifier.to_s), dir)
     file.write(content)
     file.tap(&:flush)
   end

data/lib/nanoc/webpack/version.rb

@@ -2,6 +2,6 @@
 
 module Nanoc
   module Webpack
-    VERSION = "0.5.5"
+    VERSION = "0.5.6"
   end
 end

data/lib/nanoc/webpack.rb

@@ -1,7 +1,13 @@
 # frozen_string_literal: true
 
 require "nanoc"
-require "ryo"
 module Nanoc::Webpack
+  require "ryo"
   require_relative "webpack/filter"
+  ##
+  # @example (see Nanoc::Webpack::Filter.default_options)
+  # @return (see Nanoc::Webpack::Filter.default_options)
+  def self.default_options
+    Nanoc::Webpack::Filter.default_options
+  end
 end

data/spec/filter_spec.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+require_relative "setup"
+RSpec.describe Nanoc::Webpack::Filter do
+  let(:paths) { ["/1", "/1/1.txt", "/1/2", "/1/2/1.txt"] }
+  let(:root) { File.join("spec", "fakefs", "content") }
+  let(:reject) { nil }
+  let(:item) do
+    Ryo.from(
+      identifier: {to_s: "test.ts"},
+      attributes: {content_filename: "test.ts"}
+    )
+  end
+  let(:items) do
+    paths.each_with_object({}) { _2[_1] = _1 }
+  end
+  let(:config) do
+    Ryo.from(
+      each: {to_h: {data_sources: [{content_dir: root}]}},
+      data_sources: [{content_dir: root}]
+    )
+  end
+  let(:filter) do
+    Nanoc::Filter
+      .named!(:webpack)
+      .new(item:, items:, config:)
+  end
+  include FileUtils
+
+  context "when given dependables" do
+    subject { filter.dependable(paths: target, reject:) }
+
+    before do
+      mkdir_p(root)
+      paths.each do
+        path = File.join(root, _1)
+        File.extname(path).empty? ? mkdir_p(path) : touch(path)
+      end
+    end
+
+    after { rm_rf(root) }
+
+    context "when the directory depth is 2" do
+      context "when given /1 as a path" do
+        let(:target) { "/1" }
+        it { is_expected.to contain_exactly("/1/1.txt", "/1/2/1.txt") }
+      end
+
+      context "when given /1/2 as a path" do
+        let(:target) { "/1/2" }
+        it { is_expected.to contain_exactly("/1/2/1.txt") }
+      end
+    end
+
+    context "when the directory depth is 5" do
+      let(:paths) { super().concat(["/1/2/3/4/5", "/1/2/3/4/5/1.txt"]) }
+
+      context "when given /1 as a path" do
+        let(:target) { "/1" }
+        it do
+          is_expected.to contain_exactly(
+                           "/1/1.txt",
+                           "/1/2/1.txt",
+                           "/1/2/3/4/5/1.txt"
+                         )
+        end
+      end
+
+      context "when given /1/2 as a path" do
+        let(:target) { "/1/2" }
+        it { is_expected.to contain_exactly("/1/2/1.txt", "/1/2/3/4/5/1.txt") }
+      end
+
+      context "when given /1/2/3 as a path" do
+        let(:target) { "/1/2/3" }
+        it { is_expected.to contain_exactly("/1/2/3/4/5/1.txt") }
+      end
+
+      context "when depth 5 has descendant directories" do
+        let(:paths) do
+          super().concat([
+                           "/1/2/3/4/5/a", "/1/2/3/4/5/a/a.txt",
+                           "/1/2/3/4/5/b", "/1/2/3/4/5/b/b.txt",
+                           "/1/2/3/4/5/c", "/1/2/3/4/5/c/c.txt"
+                         ])
+        end
+
+        context "when given /1 as a path" do
+          let(:target) { "/1" }
+          it do
+            is_expected.to contain_exactly(
+                             "/1/1.txt", "/1/2/1.txt", "/1/2/3/4/5/1.txt",
+                             "/1/2/3/4/5/a/a.txt", "/1/2/3/4/5/b/b.txt",
+                             "/1/2/3/4/5/c/c.txt"
+                           )
+          end
+        end
+      end
+    end
+
+    context "when one or more directories are excluded" do
+      let(:paths) { super().concat(["/2/3", "/2/3/1.txt", "/3/4", "/3/4/1.txt"]) }
+
+      context "when the target is [!12]" do
+        let(:target) { "/[!12]/" }
+        it { is_expected.to contain_exactly("/3/4/1.txt") }
+      end
+
+      context "when the reject filter is used" do
+        let(:paths) do
+          ["/lib/WebPackage/", "/lib/WebPackage/foo.ts",
+           "/lib/Web/", "/lib/Web/foo.ts",
+           "/lib/foo/", "/lib/foo/foo.ts"]
+        end
+        let(:target) { "/lib/" }
+        let(:reject) { proc { |path| path.include?("WebPackage") } }
+
+        it do
+          is_expected.to contain_exactly("/lib/Web/foo.ts", "/lib/foo/foo.ts")
+        end
+      end
+    end
+  end
+
+  context "when nodejs is executed" do
+    let(:cmdline) do
+      [
+        "node",
+        "./node_modules/webpack/bin/webpack.js",
+        "--entry", File.join(Dir.getwd, "test.ts"),
+        "--output-path", instance_of(String),
+        "--output-filename", instance_of(String),
+        "--cache-type", "filesystem"
+      ]
+    end
+
+    context "with default arguments" do
+      it "executes nodejs" do
+        expect(filter).to receive(:system).with(*cmdline)
+        filter.run(item)
+      end
+    end
+
+    context "with --no-cache" do
+      let(:cmdline) { super().concat(["--no-cache"]) }
+
+      it "executes nodejs with an argument" do
+        expect(filter).to receive(:system).with(*cmdline)
+        filter.run(item, args: {"--no-cache" => true})
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nanoc-webpack.rb
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.5.6
 platform: ruby
 authors:
 - '0x1eef'
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-11 00:00:00.000000000 Z
+date: 2024-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ryo.rb
@@ -116,7 +116,7 @@ files:
 - lib/nanoc/webpack/filter/dependable.rb
 - lib/nanoc/webpack/version.rb
 - nanoc-webpack.rb.gemspec
-- spec/dependable_spec.rb
+- spec/filter_spec.rb
 - spec/setup.rb
 homepage: https://github.com/0x1eef/nanoc-webpack.rb#readme
 licenses:

data/spec/dependable_spec.rb

@@ -1,110 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "setup"
-
-RSpec.describe Nanoc::Webpack::Filter::Dependable do
-  subject { filter.dependable(paths: target, reject:) }
-  let(:paths) { ["/1", "/1/1.txt", "/1/2", "/1/2/1.txt"] }
-  let(:root) { File.join("spec", "fakefs", "content") }
-  let(:reject) { nil }
-  let(:filter) do
-    Object.new.instance_exec(root, paths) do |root, paths|
-      extend Nanoc::Webpack::Filter::Dependable
-      define_singleton_method(:items) { paths.each_with_object({}) { _2[_1] = _1 } }
-      define_singleton_method(:root) { root }
-      self
-    end
-  end
-  include FileUtils
-
-  before do
-    mkdir_p(root)
-    paths.each do
-      path = File.join(root, _1)
-      File.extname(path).empty? ? mkdir_p(path) : touch(path)
-    end
-  end
-
-  after { rm_rf(root) }
-
-  context "when the directory depth is 2" do
-    context "when given /1 as a path" do
-      let(:target) { "/1" }
-      it { is_expected.to contain_exactly("/1/1.txt", "/1/2/1.txt") }
-    end
-
-    context "when given /1/2 as a path" do
-      let(:target) { "/1/2" }
-      it { is_expected.to contain_exactly("/1/2/1.txt") }
-    end
-  end
-
-  context "when the directory depth is 5" do
-    let(:paths) { super().concat(["/1/2/3/4/5", "/1/2/3/4/5/1.txt"]) }
-
-    context "when given /1 as a path" do
-      let(:target) { "/1" }
-      it do
-        is_expected.to contain_exactly(
-          "/1/1.txt",
-          "/1/2/1.txt",
-          "/1/2/3/4/5/1.txt"
-        )
-      end
-    end
-
-    context "when given /1/2 as a path" do
-      let(:target) { "/1/2" }
-      it { is_expected.to contain_exactly("/1/2/1.txt", "/1/2/3/4/5/1.txt") }
-    end
-
-    context "when given /1/2/3 as a path" do
-      let(:target) { "/1/2/3" }
-      it { is_expected.to contain_exactly("/1/2/3/4/5/1.txt") }
-    end
-
-    context "when depth 5 has descendant directories" do
-      let(:paths) do
-        super().concat([
-          "/1/2/3/4/5/a", "/1/2/3/4/5/a/a.txt",
-          "/1/2/3/4/5/b", "/1/2/3/4/5/b/b.txt",
-          "/1/2/3/4/5/c", "/1/2/3/4/5/c/c.txt"
-        ])
-      end
-
-      context "when given /1 as a path" do
-        let(:target) { "/1" }
-        it do
-          is_expected.to contain_exactly(
-            "/1/1.txt", "/1/2/1.txt", "/1/2/3/4/5/1.txt",
-            "/1/2/3/4/5/a/a.txt", "/1/2/3/4/5/b/b.txt",
-            "/1/2/3/4/5/c/c.txt"
-          )
-        end
-      end
-    end
-  end
-
-  context "when one or more directories are excluded" do
-    let(:paths) { super().concat(["/2/3", "/2/3/1.txt", "/3/4", "/3/4/1.txt"]) }
-
-    context "when the target is [!12]" do
-      let(:target) { "/[!12]/" }
-      it { is_expected.to contain_exactly("/3/4/1.txt") }
-    end
-
-    context "when the reject filter is used" do
-      let(:paths) do
-        ["/lib/WebPackage/", "/lib/WebPackage/foo.ts",
-         "/lib/Web/", "/lib/Web/foo.ts",
-         "/lib/foo/", "/lib/foo/foo.ts"]
-      end
-      let(:target) { "/lib/" }
-      let(:reject) { proc { |path| path.include?("WebPackage") } }
-
-      it do
-        is_expected.to contain_exactly("/lib/Web/foo.ts", "/lib/foo/foo.ts")
-      end
-    end
-  end
-end