\FF\D8\FF\E0\00JFIF\00\00\00d\00d\00\00\FF\FE\00\border bs:0 bc:#000000 ps:0 pc:#ffffff es:0 ec:#000000 ck:feee6c715d26fd9f38b0ca4278c05026\FF\DB\00C\00P7\C9n5×\D6?\BDê\9Ds\EBp\9F[`8m\B7)o\B5\E8\E6I\99\FE3]]A2\BA\8Cw\D6E\93\\DEv\C8\009\F2\F1NI?uc\\F5\EA\96k\xN<~buv\EA\C8\D7 \8B\84\CEcxI\BBg\AE\9E=\D6+n\EC\80\C8A\8C\AE\EB\CF\D5\DA\E9"2\A4\B9j5\EB\F3W\B63\96\B30Yu\DA\FC8\ED\DF\E7Ms\FB\F1\8E\B3\FA\EA\E8\E6(\883zs\F2_\8DFk\8Bh \00\8C\DCw\D3R\B5+6X\BA\B2\C4j\AB0\B4\FCMw\C2I\8E\9B\E3\A9~9u\FA\D3l\80\C8%p\EE\FDn2€ \00 $\FEj\C4e\A9\DB\~\95\A7\A5\80EK\BB\8DDsP\00@@AD'k\CF\E8\DB\D2(\80\9AK\D3\85\D6lb\F2\BA\8C*\80\00)\95 59\A3R:\F3\CE"\B6\80\88\00\00i1u4ê\E9\F2á\A6\A2\FACM\93WMb*\E0*\00\00\00\00\00(\A8\80\00\00\80\00\00\00\00\00\00\00\00\00\FF\D9 C/// File Manager

File Manager

Path: /opt/chef/embedded/lib/ruby/gems/2.7.0/gems/chef-utils-16.3.38/lib/chef-utils/dsl/

Viewing File: which.rb

#
# Copyright:: Copyright (c) Chef Software Inc.
# License:: Apache License, Version 2.0
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

require_relative "../internal"

module ChefUtils
  module DSL
    module Which
      include Internal

      # Lookup an executable through the systems search PATH.  Allows specifying an array
      # of executables to look for.  The first executable that is found, along any path entry,
      # will be the preferred one and returned first.  The extra_path will override any default
      # extra_paths which are added (allowing the user to pass an empty array to remove them).
      #
      # When passed a block the block will be called with the full pathname of any executables
      # which are found, and the block should return truthy or falsey values to further filter
      # the executable based on arbitrary criteria.
      #
      # This is syntactic sugar for `where(...).first`
      #
      # This helper can be used in target mode in chef or with train using the appropriate
      # wiring externally.
      #
      # @example Find the most appropriate python executable, searching through the system PATH
      #          plus additionally the "/usr/libexec" directory, which has the dnf libraries
      #          installed and available.
      #
      #   cmd = which("platform-python", "python", "python3", "python2", "python2.7", extra_path: "/usr/libexec") do |f|
      #     shell_out("#{f} -c 'import dnf'").exitstatus == 0
      #   end
      #
      # @param [Array<String>] list of commands to search for
      # @param [String,Array<String>] array of extra paths to search through
      # @return [String] the first match
      #
      def which(*cmds, extra_path: nil, &block)
        where(*cmds, extra_path: extra_path, &block).first || false
      end

      # Lookup all the instances of an an executable that can be found through the systems search PATH.
      # Allows specifying an array of executables to look for.  All the instances of the first executable
      # that is found will be returned first.  The extra_path will override any default extra_paths
      # which are added (allowing the user to pass an empty array to remove them).
      #
      # When passed a block the block will be called with the full pathname of any executables
      # which are found, and the block should return truthy or falsey values to further filter
      # the executable based on arbitrary criteria.
      #
      # This helper can be used in target mode in chef or with train using the appropriate
      # wiring externally.
      #
      # @example Find all the python executables, searching through the system PATH plus additionally
      #          the "/usr/libexec" directory, which have the dnf libraries installed and available.
      #
      #   cmds = where("platform-python", "python", "python3", "python2", "python2.7", extra_path: "/usr/libexec") do |f|
      #     shell_out("#{f} -c 'import dnf'").exitstatus == 0
      #   end
      #
      # @param [Array<String>] list of commands to search for
      # @param [String,Array<String>] array of extra paths to search through
      # @return [String] the first match
      #
      def where(*cmds, extra_path: nil, &block)
        extra_path ||= __extra_path
        paths = __env_path.split(File::PATH_SEPARATOR) + Array(extra_path)
        paths.uniq!
        cmds.map do |cmd|
          paths.map do |path|
            filename = File.join(path, cmd)
            filename if __valid_executable?(filename, &block)
          end.compact
        end.flatten
      end

      private

      # This is for injecting common extra_paths into the search PATH.  The chef-client codebase overrides this into its
      # own custom mixin to ensure that /usr/sbin, /sbin, etc are in the search PATH for chef-client.
      #
      # @api private
      def __extra_path
        nil
      end

      # Windows compatible and train/target-mode-enhanced helper to determine if an executable is valid.
      #
      # @api private
      def __valid_executable?(filename, &block)
        is_executable =
          if __transport_connection
            __transport_connection.file(filename).stat[:mode] & 1 && !__transport_connection.file(filename).directory?
          else
            File.executable?(filename) && !File.directory?(filename)
          end
        return false unless is_executable

        block ? yield(filename) : true
      end

      extend self
    end
  end
end