brew/Library/Homebrew/services/system/systemctl.rb

# typed: strict
# frozen_string_literal: true

module Services
  module System
    module Systemctl
      sig { returns(T.nilable(Pathname)) }
      def self.executable
        @executable ||= T.let(which("systemctl"), T.nilable(Pathname))
      end

      sig { returns(String) }
      def self.scope
        System.root? ? "--system" : "--user"
      end

      sig { params(args: T.nilable(T.any(String, Pathname))).void }
      def self.run(*args)
        _run(*args, mode: :default)
      end

      sig { params(args: T.nilable(T.any(String, Pathname))).returns(T::Boolean) }
      def self.quiet_run(*args)
        _run(*args, mode: :quiet)
      end

      sig { params(args: T.nilable(T.any(String, Pathname))).returns(String) }
      def self.popen_read(*args)
        _run(*args, mode: :read)
      end

      sig { params(args: T.any(String, Pathname), mode: T.nilable(Symbol)).returns(T.untyped) }
      private_class_method def self._run(*args, mode:)
        require "system_command"
        result = SystemCommand.run(executable,
                                   args:         [scope, *args.map(&:to_s)],
                                   print_stdout: mode == :default,
                                   print_stderr: mode == :default,
                                   must_succeed: mode == :default,
                                   reset_uid:    true)
        if mode == :read
          result.stdout
        elsif mode == :quiet
          result.success?
        end
      end
    end
  end
end