Merge pull request #11298 from SMillerDev/feature/service/plist_options

services: replace plist_options :manual with service command

Library/Homebrew/caveats.rb

@@ -152,13 +152,19 @@ class Caveats
   end
 
   def plist_caveats
-    return unless f.plist_manual
+    return if !f.plist_manual && !f.service?
+
+    command = if f.service?
+      f.service.command.join(" ")
+    else
+      f.plist_manual
+    end
 
     # Default to brew services not being supported. macOS overrides this behavior.
     <<~EOS
       #{Formatter.warning("Warning:")} #{f.name} provides a launchd plist which can only be used on macOS!
       You can manually execute the service instead with:
-        #{f.plist_manual}
+        #{command}
     EOS
   end
 

Library/Homebrew/extend/os/mac/caveats.rb

@@ -6,14 +6,15 @@ class Caveats
 
   def plist_caveats
     s = []
-    if f.plist || keg&.plist_installed?
+    return if !f.plist && !f.service? && !keg&.plist_installed?
+
     plist_domain = f.plist_path.basename(".plist")
 
     # we readlink because this path probably doesn't exist since caveats
     # occurs before the link step of installation
     # Yosemite security measures mildly tighter rules:
     # https://github.com/Homebrew/legacy-homebrew/issues/33815
-      if !plist_path.file? || !plist_path.symlink?
+    if f.plist && (!plist_path.file? || !plist_path.symlink?)
       if f.plist_startup
         s << "To have launchd start #{f.full_name} now and restart at startup:"
         s << "  sudo brew services start #{f.full_name}"
@@ -34,9 +35,15 @@ class Caveats
       s << "  brew services start #{f.full_name}"
     end
 
-      if f.plist_manual
+    if f.plist_manual || f.service?
+      command = if f.service?
+        f.service.command.join(" ")
+      else
+        f.plist_manual
+      end
+
       s << "Or, if you don't want/need a background service you can just run:"
-        s << "  #{f.plist_manual}"
+      s << "  #{command}"
     end
 
     # pbpaste is the system clipboard tool on macOS and fails with `tmux` by default
@@ -44,7 +51,6 @@ class Caveats
     if ENV["TMUX"] && !quiet_system("/usr/bin/pbpaste")
       s << "" << "WARNING: brew services will fail when run under tmux."
     end
-    end
     "#{s.join("\n")}\n" unless s.empty?
   end
 end

Library/Homebrew/test/caveats_spec.rb

@@ -114,6 +114,20 @@ describe Caveats do
         expect(caveats).to include(f.plist_manual)
       end
 
+      it "gives information about service" do
+        f = formula do
+          url "foo-1.0"
+          service do
+            run [bin/"php", "test"]
+          end
+        end
+        caveats = described_class.new(f).caveats
+
+        expect(f.service?).to eq(true)
+        expect(caveats).to include("#{f.bin}/php test")
+        expect(caveats).to include("background service")
+      end
+
       it "warns about brew failing under tmux" do
         f = formula do
           url "foo-1.0"