feat: allow users to specify "never minification"

Author: flavorjones

README.md

@@ -55,6 +55,11 @@ If you want unminified assets, you can pass a `debug` argument to the rake task,
 Note that you can combine task options, e.g. `rails tailwindcss:watch[debug,poll]`.
 
 
+### Never minify assets
+
+If you _always_ want unminified assets, you can set the environment variable `TAILWINDCSS_RAILS_NO_MINIFY` to something that [looks truthy](https://api.rubyonrails.org/classes/ActiveModel/Type/Boolean.html) (hint: "t" or "1" will work).
+
+
 ### Custom inputs or outputs
 
 If you need to use a custom input or output file, you can run `bundle exec tailwindcss` to access the platform-specific executable, and give it your own build options.

lib/tailwindcss/commands.rb

@@ -74,12 +74,21 @@ def watch_command(poll: false, **kwargs)
       end
 
       def debug_option(rake_task_args_extras)
-        rake_task_args_extras.include?("debug")
+        rake_task_args_extras.include?("debug") || truthy_string_value(ENV['TAILWINDCSS_RAILS_NO_MINIFY'])
       end
 
       def poll_option(rake_task_args_extras)
         rake_task_args_extras.include?("poll")
       end
+
+      def truthy_string_value(value)
+        if !value.present? ||
+           ["f", "F", "false", "FALSE", "off", "OFF", "0"].include?(value)
+          false
+        else
+          true
+        end
+      end
     end
   end
 end

test/lib/tailwindcss/commands_test.rb

@@ -18,6 +18,14 @@ def mock_exe_directory(platform)
     end
   end
 
+  def with_env(env)
+    before = ENV.to_h.dup
+    env.each { |k, v| ENV[k] = v }
+    yield
+  ensure
+    ENV.replace(before)
+  end
+
   test ".executable returns the absolute path to the binary" do
     mock_exe_directory("sparc-solaris2.8") do |dir, executable|
       expected = File.expand_path(File.join(dir, "sparc-solaris2.8", "tailwindcss"))
@@ -89,11 +97,48 @@ def mock_exe_directory(platform)
     refute(Tailwindcss::Commands.debug_option([]))
     assert(Tailwindcss::Commands.debug_option(["debug"]))
     refute(Tailwindcss::Commands.debug_option(["poll"]))
+
+    with_env({"TAILWINDCSS_RAILS_NO_MINIFY" => "f"}) do
+      refute(Tailwindcss::Commands.debug_option([]))
+    end
+
+    with_env({"TAILWINDCSS_RAILS_NO_MINIFY" => "t"}) do
+      assert(Tailwindcss::Commands.debug_option([]))
+    end
   end
 
   test ".poll_option" do
     refute(Tailwindcss::Commands.poll_option([]))
     refute(Tailwindcss::Commands.poll_option(["debug"]))
     assert(Tailwindcss::Commands.poll_option(["poll"]))
   end
+
+  test ".truthy_string_value" do
+    [
+      nil,
+      "",
+      "F", "FALSE",
+      "f", "false",
+      "off", "OFF",
+      "0",
+    ].each do |value|
+      refute(
+        Tailwindcss::Commands.truthy_string_value(value),
+        "#{value.inspect} should be falsey",
+      )
+    end
+
+    [
+      "T", "TRUE",
+      "t", "true",
+      "on", "ON",
+      "1",
+      "anything not falsey really",
+    ].each do |value|
+      assert(
+        Tailwindcss::Commands.truthy_string_value(value),
+        "#{value.inspect} should be truthy",
+      )
+    end
+  end
 end