feat: allow users to specify "never minification"

Author: flavorjones

Gemfile.lock

@@ -2,6 +2,7 @@ PATH
   remote: .
   specs:
     tailwindcss-rails (2.0.22)
+      activemodel (>= 6.0.0)
       railties (>= 6.0.0)
 
 GEM
@@ -33,6 +34,8 @@ GEM
     activejob (7.0.4.2)
       activesupport (= 7.0.4.2)
       globalid (>= 0.3.6)
+    activemodel (7.0.4.2)
+      activesupport (= 7.0.4.2)
     activesupport (7.0.4.2)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)

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]`.
 
 
+### Always avoid minification 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

@@ -1,4 +1,5 @@
 require_relative "upstream"
+require "active_model/type"
 
 module Tailwindcss
   module Commands
@@ -74,12 +75,16 @@ 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)
+        ActiveModel::Type::Boolean.new.cast(value)
+      end
     end
   end
 end

tailwindcss-rails.gemspec

@@ -19,4 +19,5 @@ Gem::Specification.new do |spec|
   spec.executables << "tailwindcss"
 
   spec.add_dependency "railties", ">= 6.0.0"
+  spec.add_dependency "activemodel", ">= 6.0.0"
 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,6 +97,14 @@ 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