chef 18.9.4 → 19.1.164

data/lib/chef/resource/_rest_resource.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright 2008-2016, Chef, Inc.
+# Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -15,6 +15,101 @@
 # limitations under the License.
 #
 
+unified_mode true
+
+provides :rest_resource
+
+description "Base resource for interacting with REST APIs. Extend this resource to create custom resources that manage REST API endpoints."
+
+introduced "18.0"
+
+examples <<~'DOC'
+  **Create a custom REST resource for managing users in an API**
+
+  ```ruby
+  class Chef::Resource::ApiUser < Chef::Resource::RestResource
+    resource_name :api_user
+    provides :api_user
+
+    rest_api_endpoint "https://api.example.com"
+    rest_api_collection "/api/v1/users"
+    rest_identity_property :username
+
+    property :username, String, name_property: true
+    property :email, String
+    property :full_name, String
+    property :active, [true, false], default: true
+
+    rest_property_map({
+      username: "username",
+      email: "email",
+      full_name: "profile.fullName",
+      active: "status.active"
+    })
+
+    rest_post_only_properties [:username]
+  end
+  ```
+
+  **Use the custom resource to create a user**
+
+  ```ruby
+  api_user "testuser" do
+    email "testuser@example.com"
+    full_name "Test User"
+    active true
+    action :configure
+  end
+  ```
+
+  **Delete a user via the API**
+
+  ```ruby
+  api_user "testuser" do
+    action :delete
+  end
+  ```
+
+  **Use JMESPath for complex JSON mapping**
+
+  ```ruby
+  class Chef::Resource::ApiProject < Chef::Resource::RestResource
+    resource_name :api_project
+
+    rest_api_endpoint "https://api.example.com"
+    rest_api_collection "/projects"
+    rest_identity_property :project_id
+
+    property :project_id, String, name_property: true
+    property :member_emails, Array
+
+    # Extract email addresses from nested members array
+    rest_property_map({
+      project_id: "id",
+      member_emails: "members[*].email"
+    })
+  end
+  ```
+
+  **Configure authentication with custom headers**
+
+  ```ruby
+  class Chef::Resource::ApiResource < Chef::Resource::RestResource
+    rest_api_endpoint "https://api.example.com"
+    rest_api_collection "/resources"
+
+    action_class do
+      def rest_headers
+        {
+          "Authorization" => "Bearer #{node['api_token']}",
+          "X-API-Version" => "2024-01-01"
+        }
+      end
+    end
+  end
+  ```
+DOC
+
 require "addressable/template" unless defined?(Addressable::Template)
 require "rest-client" unless defined?(RestClient)
 require "jmespath" unless defined?(JMESPath)
@@ -48,7 +143,7 @@ action_class do
   end
 end
 
-action :configure do
+action :configure, description: "Create or update the resource via the REST API. If the resource doesn't exist, this performs a POST to create it. If the resource exists and properties changed, this performs a PATCH to update it." do
   if resource_exists?
     converge_if_changed do
       data = {}
@@ -79,7 +174,7 @@ action :configure do
   end
 end
 
-action :delete do
+action :delete, description: "Delete the resource via the REST API. If the resource doesn't exist, this action takes no action." do
   if resource_exists?
     converge_by "deleting resource" do
       rest_delete
@@ -91,12 +186,24 @@ action :delete do
 end
 
 action_class do
-  # Override this for postprocessing device-specifics (paging, data conversion)
+  #
+  # Postprocess API responses. Override in custom resources to transform
+  # or extract data from responses, handle pagination, etc.
+  #
+  # @param response [RestClient::Response] The API response object
+  # @return [RestClient::Response] The processed response
+  #
   def rest_postprocess(response)
     response
   end
 
-  # Override this for error handling of device-specifics (readable error messages)
+  #
+  # Handle REST API errors. Override in custom resources to provide
+  # user-friendly error messages or handle specific error codes.
+  #
+  # @param error_obj [RestClient::Exception] The exception object
+  # @return [RestClient::Exception] The processed error
+  #
   def rest_errorhandler(error_obj)
     error_obj
   end
@@ -111,7 +218,9 @@ action_class do
     current_resource.class.properties.select { |_, v| v.required? }.except(:name).keys
   end
 
+  #
   # Return changed value or nil for delta current->new
+  #
   def changed_value(property)
     new_value = new_resource.send(property)
     return new_value if current_resource.nil?
@@ -127,7 +236,9 @@ action_class do
     current_resource.class.identity_attr
   end
 
+  #
   # Map properties to their current values
+  #
   def property_map
     map = {}
 
@@ -142,7 +253,15 @@ action_class do
     map
   end
 
-  # Map part of a JSON (Hash) to resource property via JMESPath or user-supplied function
+  #
+  # Convert JSON API response to a resource property value.
+  # Supports JMESPath expressions (String) or custom functions (Symbol).
+  #
+  # @param match_instruction [String, Symbol] How to extract the value
+  # @param property [Symbol] The property name
+  # @param resource_data [Hash] The JSON response data
+  # @return [Object] The extracted property value
+  #
   def json_to_property(match_instruction, property, resource_data)
     case match_instruction
     when String
@@ -157,7 +276,14 @@ action_class do
     end
   end
 
-  # Map resource contents into a JSON (Hash) via JMESPath-like syntax or user-supplied function
+  #
+  # Convert a resource property value to JSON for API request.
+  # Supports JMESPath-like notation (String) or custom functions (Symbol).
+  #
+  # @param property [Symbol] The property name
+  # @param match_instruction [String, Symbol] How to structure the value
+  # @return [Hash] A hash representing the JSON structure
+  #
   def property_to_json(property, match_instruction)
     case match_instruction
     when String
@@ -177,13 +303,17 @@ action_class do
     current_resource.class.rest_api_collection
   end
 
+  #
   # Resource document URL after RFC 6570 template evaluation via properties substitution
+  #
   def rest_url_document
     template = ::Addressable::Template.new(current_resource.class.rest_api_document)
     template.expand(property_map).to_s
   end
 
+  #
   # Convenience method for conditional requires
+  #
   def conditionally_require_on_setting(property, dependent_properties)
     dependent_properties = Array(dependent_properties)
 
@@ -267,12 +397,16 @@ action_class do
 
   # REST parameter mapping
 
+  #
   # Return number of parameters needed to identify a resource (pre- and post-creation)
+  #
   def rest_arity
     rest_identity_map.keys.count
   end
 
+  #
   # Return mapping of template placeholders to property value of identity parameters
+  #
   def rest_identity_values
     data = {}
 
@@ -288,11 +422,14 @@ action_class do
     rest_identity_explicit || rest_identity_implicit
   end
 
+  #
   # Accept direct mapping like { "svm.name" => :name } for specifying the x-ary identity of a resource
+  #
   def rest_identity_explicit
     current_resource.class.rest_identity_map
   end
 
+  #
   # Parse document URL for RFC 6570 templates and map them to resource properties.
   #
   # Examples:
@@ -351,8 +488,11 @@ action_class do
     Chef.run_context.transport.connection
   end
 
+  #
   # Remove all empty keys (recursively) from Hash.
+  #
   # @see https://stackoverflow.com/questions/56457020/#answer-56458673
+  #
   def deep_compact!(hsh)
     raise TypeError unless hsh.is_a? Hash
 
@@ -361,22 +501,27 @@ action_class do
     end.reject! { |_, v| v.nil? || (v.respond_to?(:empty?) && v.empty?) }
   end
 
+  #
   # Deep merge two hashes
+  #
   # @see https://stackoverflow.com/questions/41109599#answer-41109737
+  #
   def deep_merge!(hsh1, hsh2)
     raise TypeError unless hsh1.is_a?(Hash) && hsh2.is_a?(Hash)
 
     hsh1.merge!(hsh2) { |_, v1, v2| deep_merge!(v1, v2) }
   end
 
+  #
   # Create nested hashes from JMESPath syntax.
+  #
   def bury(path, value)
     raise TypeError unless path.is_a?(String)
 
     arr = path.split(".")
     ret = {}
 
-    if arr.count == 1
+    if arr.one?
       ret[arr.first] = value
 
       ret

data/lib/chef/resource/action_class.rb

@@ -1,6 +1,6 @@
 #
 # Author:: John Keiser (<jkeiser@chef.io)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

data/lib/chef/resource/alternatives.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # Copyright:: 2016-2020, Virender Khatri
 #
 # License:: Apache License, Version 2.0
@@ -23,7 +23,8 @@ class Chef
   class Resource
     class Alternatives < Chef::Resource
 
-      provides(:alternatives) { true }
+      provides(:alternatives, target_mode: true) { true }
+      target_mode support: :full
 
       description "Use the **alternatives** resource to configure command alternatives in Linux using the alternatives or update-alternatives packages."
       introduced "16.0"
@@ -91,7 +92,7 @@ class Chef
         description: "The absolute path to the original application binary such as `/usr/bin/ruby27`."
 
       property :priority, [String, Integer],
-        coerce: proc { |n| n.to_i },
+        coerce: proc(&:to_i),
         description: "The priority of the alternative."
 
       def define_resource_requirements
@@ -113,7 +114,7 @@ class Chef
 
         requirements.assert(:install, :set, :remove) do |a|
           a.assertion do
-            ::File.exist?(new_resource.path)
+            ::TargetIO::File.exist?(new_resource.path)
           end
 
           a.whyrun("Assuming file #{new_resource.path} already exists or was created already")

data/lib/chef/resource/apt_package.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Adam Jacob (<adam@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -24,6 +24,11 @@ class Chef
 
       provides :apt_package, target_mode: true
       provides :package, platform_family: "debian", target_mode: true
+      target_mode support: :full,
+        introduced: "15.1",
+        updated: "19.0",
+        description: "Does not support the `response_file` property in Target Mode."
+
       examples <<~DOC
       **Install a package using package manager**:
 
@@ -96,7 +101,7 @@ class Chef
         default: false
 
       property :environment, Hash,
-        introduced: "18.8",
+        introduced: "19.0",
         description: "A Hash of environment variables in the form of {'ENV_VARIABLE' => 'VALUE'} to be set before running the command.",
         default: {}, desired_state: false
     end

data/lib/chef/resource/apt_preference.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Tim Smith (<tsmith@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +22,8 @@ class Chef
   class Resource
     class AptPreference < Chef::Resource
 
-      provides(:apt_preference) { true }
+      provides(:apt_preference, target_mode: true) { true }
+      target_mode support: :full
 
       description "Use the **apt_preference** resource to create APT [preference files](https://wiki.debian.org/AptPreferences). Preference files are used to control which package versions and sources are prioritized during installation."
       introduced "13.3"

data/lib/chef/resource/apt_repository.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Thom May (<thom@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -17,7 +17,6 @@
 #
 
 require_relative "../resource"
-require_relative "../http/simple"
 require "tmpdir" unless defined?(Dir.mktmpdir)
 module Addressable
   autoload :URI, "addressable/uri"
@@ -27,7 +26,8 @@ class Chef
   class Resource
     class AptRepository < Chef::Resource
 
-      provides(:apt_repository) { true }
+      provides(:apt_repository, target_mode: true) { true }
+      target_mode support: :full
 
       description "Use the **apt_repository** resource to specify additional APT repositories. Adding a new repository will update the APT package cache immediately."
       introduced "12.9"
@@ -99,7 +99,6 @@ class Chef
         ```
 
         **Add repository that needs custom options**:
-
         ```ruby
         apt_repository 'corretto' do
           uri          'https://apt.corretto.aws'
@@ -127,6 +126,7 @@ class Chef
       # to allow that so don't refactor this however tempting it is
       property :repo_name, String,
         regex: [%r{^[^/]+$}],
+        coerce: proc { |x| x.gsub(" ", "-") },
         description: "An optional property to set the repository name if it differs from the resource block's name. The value of this setting must not contain spaces.",
         validation_message: "repo_name property cannot contain a forward slash '/'",
         introduced: "14.1", name_property: true
@@ -177,7 +177,7 @@ class Chef
         default: true, desired_state: false
 
       property :options, [String, Array],
-        description: "Additional options to set for the repository.",
+        description: "Additional options to set for the repository",
         default: [], coerce: proc { |x| Array(x) }
 
       default_action :add
@@ -201,7 +201,7 @@ class Chef
         # @return [Array] an array of fingerprints
         def extract_fingerprints_from_cmd(*cmd)
           so = shell_out(*cmd)
-          so.stdout.split(/\n/).map do |t|
+          so.stdout.split("\n").map do |t|
             if z = t.match(/^fpr:+([0-9A-F]+):/)
               z[1].split.join
             end
@@ -218,7 +218,7 @@ class Chef
           so = shell_out(*cmd)
           # Sample output
           # pub:-:4096:1:D94AA3F0EFE21092:1336774248:::-:::scSC::::::23::0:
-          so.stdout.split(/\n/).map do |t|
+          so.stdout.split("\n").map do |t|
             if t.match(/^pub:/)
               f = t.split(":")
               f.slice(0, 6).join(":")
@@ -330,8 +330,8 @@ class Chef
           keyfile_tmp_path = ::File.join(Chef::Config[:file_cache_path], key_name)
           keyfile_path = keyring_path
           gpg_keyring_prefix = apt_version > 2 ? "gnupg-ring:" : ""
-          tmp_dir = Dir.mktmpdir(".gpg")
-          at_exit { FileUtils.remove_entry(tmp_dir) }
+          tmp_dir = TargetIO::Dir.mktmpdir(".gpg")
+          at_exit { TargetIO::FileUtils.remove_entry(tmp_dir) }
 
           if new_resource.signed_by
             directory "/etc/apt/keyrings" do
@@ -456,7 +456,7 @@ class Chef
         # @return [void]
         def install_ppa_key(owner, repo)
           url = "https://launchpad.net/api/1.0/~#{owner}/+archive/#{repo}"
-          key_id = Chef::HTTP::Simple.new(url, {}).get("signing_key_fingerprint").delete('"')
+          key_id = TargetIO::HTTP.new(url).get("signing_key_fingerprint").delete('"')
           install_key_from_keyserver(key_id, "keyserver.ubuntu.com")
         rescue Net::HTTPClientException => e
           raise "Could not access Launchpad ppa API: #{e.message}"
@@ -532,7 +532,7 @@ class Chef
         # @return [void]
         def cleanup_legacy_file!
           legacy_path = "/etc/apt/sources.list.d/#{new_resource.name}.list"
-          if new_resource.name != new_resource.repo_name && ::File.exist?(legacy_path)
+          if new_resource.name != new_resource.repo_name && ::TargetIO::File.exist?(legacy_path)
             converge_by "Cleaning up legacy #{legacy_path} repo file" do
               file legacy_path do
                 action :delete
@@ -574,7 +574,12 @@ class Chef
 
         signed_by = new_resource.signed_by
         if signed_by == true
-          signed_by = keyring_path
+          if new_resource.key || ::File.exist?(keyring_path)
+            signed_by = keyring_path
+          else
+            # There isn't a key to use, so don't set the signed-by attribute
+            signed_by = false
+          end
         end
 
         repo = build_repo(
@@ -604,7 +609,7 @@ class Chef
         return unless debian?
 
         cleanup_legacy_file!
-        if ::File.exist?("/etc/apt/sources.list.d/#{new_resource.repo_name}.list")
+        if ::TargetIO::File.exist?("/etc/apt/sources.list.d/#{new_resource.repo_name}.list")
           converge_by "Removing #{new_resource.repo_name} repository from /etc/apt/sources.list.d/" do
             apt_update new_resource.name do
               ignore_failure true

data/lib/chef/resource/apt_update.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Thom May (<thom@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -23,7 +23,8 @@ class Chef
   class Resource
     class AptUpdate < Chef::Resource
 
-      provides(:apt_update) { true }
+      provides(:apt_update, target_mode: true) { true }
+      target_mode support: :full
 
       description "Use the **apt_update** resource to manage APT repository updates on Debian and Ubuntu platforms."
       introduced "12.7"
@@ -62,8 +63,8 @@ class Chef
         #
         # @return [Boolean]
         def apt_up_to_date?
-          ::File.exist?("#{STAMP_DIR}/update-success-stamp") &&
-            ::File.mtime("#{STAMP_DIR}/update-success-stamp") > Time.now - new_resource.frequency
+          ::TargetIO::File.exist?("#{STAMP_DIR}/update-success-stamp") &&
+            ::TargetIO::File.mtime("#{STAMP_DIR}/update-success-stamp") > Time.now - new_resource.frequency
         end
 
         def do_update

data/lib/chef/resource/archive_file.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # Author:: Jamie Winsor (<jamie@vialstudios.com>)
 # Author:: Tim Smith (<tsmith@chef.io>)
 #
@@ -70,8 +70,7 @@ begin
   # ffi-libarchive must be eager loaded see: https://github.com/chef/chef/issues/12228
   require "ffi-libarchive" unless defined?(Archive::Reader)
 rescue LoadError => e
-  STDERR.puts "ffi-libarchive could not be loaded: #{e.message}"
-  STDERR.puts "libarchive is probably not installed on system, archive_file will not be available"
+  STDERR.puts "ffi-libarchive could not be loaded. libarchive is probably not installed on system, archive_file will not be available"
 end
 
 class Chef
@@ -172,9 +171,10 @@ class Chef
 
         if new_resource.owner || new_resource.group
           converge_by("set owner of files extracted in #{new_resource.destination} to #{new_resource.owner}:#{new_resource.group}") do
-            archive = Archive::Reader.open_filename(new_resource.path, nil, strip_components: new_resource.strip_components)
-            archive.each_entry do |e|
-              FileUtils.chown(new_resource.owner, new_resource.group, "#{new_resource.destination}/#{e.pathname}")
+            Archive::Reader.open_filename(new_resource.path, nil, strip_components: new_resource.strip_components) do |archive|
+              archive.each_entry do |e|
+                FileUtils.chown(new_resource.owner, new_resource.group, "#{new_resource.destination}/#{e.pathname}")
+              end
             end
           end
         end
@@ -211,16 +211,17 @@ class Chef
         # @return [Boolean]
         def archive_differs_from_disk?(src, dest)
           modified = false
-          archive = Archive::Reader.open_filename(src, nil, strip_components: new_resource.strip_components)
-          Chef::Log.trace("Beginning the comparison of file mtime between contents of #{src} and #{dest}")
-          archive.each_entry do |e|
-            pathname = ::File.expand_path(e.pathname, dest)
-            if ::File.exist?(pathname)
-              Chef::Log.trace("#{pathname} mtime is #{::File.mtime(pathname)} and archive is #{e.mtime}")
-              modified = true unless ::File.mtime(pathname) == e.mtime
-            else
-              Chef::Log.trace("#{pathname} doesn't exist on disk, but exists in the archive")
-              modified = true
+          Archive::Reader.open_filename(src, nil, strip_components: new_resource.strip_components) do |archive|
+            Chef::Log.trace("Beginning the comparison of file mtime between contents of #{src} and #{dest}")
+            archive.each_entry do |e|
+              pathname = ::File.expand_path(e.pathname, dest)
+              if ::File.exist?(pathname)
+                Chef::Log.trace("#{pathname} mtime is #{::File.mtime(pathname)} and archive is #{e.mtime}")
+                modified = true unless ::File.mtime(pathname) == e.mtime
+              else
+                Chef::Log.trace("#{pathname} doesn't exist on disk, but exists in the archive")
+                modified = true
+              end
             end
           end
           modified
@@ -238,12 +239,11 @@ class Chef
             flags = [options].flatten.map { |option| extract_option_map[option] }.compact.reduce(:|)
 
             Dir.chdir(dest) do
-              archive = Archive::Reader.open_filename(src, nil, strip_components: new_resource.strip_components)
-
-              archive.each_entry do |e|
-                archive.extract(e, flags.to_i)
+              Archive::Reader.open_filename(src, nil, strip_components: new_resource.strip_components) do |archive|
+                archive.each_entry do |e|
+                  archive.extract(e, flags.to_i)
+                end
               end
-              archive.close
             end
           end
         end

data/lib/chef/resource/bash.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Adam Jacob (<adam@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +22,8 @@ class Chef
   class Resource
     class Bash < Chef::Resource::Script
 
-      provides :bash
+      provides :bash, target_mode: true
+      target_mode support: :full
 
       description "Use the **bash** resource to execute scripts using the Bash interpreter. This resource may also use any of the actions and properties that are available to the **execute** resource. Commands that are executed with this resource are (by their nature) not idempotent, as they are typically unique to the environment in which they are run. Use `not_if` and `only_if` to guard this resource for idempotence."
       examples <<~'DOC'

data/lib/chef/resource/batch.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Adam Edwards (<adamed@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

data/lib/chef/resource/bff_package.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Deepali Jagtap (<deepali.jagtap@clogeny.com>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -23,7 +23,8 @@ class Chef
   class Resource
     class BffPackage < Chef::Resource::Package
 
-      provides :bff_package
+      provides :bff_package, target_mode: true
+      target_mode support: :full
 
       description "Use the **bff_package** resource to manage packages for the AIX platform using the installp utility. When a package is installed from a local file, it must be added to the node using the **remote_file** or **cookbook_file** resources."
       introduced "12.0"

data/lib/chef/resource/breakpoint.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Daniel DeLeo (<dan@kallistec.com>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -24,6 +24,7 @@ class Chef
     class Breakpoint < Chef::Resource
 
       provides :breakpoint, target_mode: true
+      target_mode support: :full, introduced: "15.1"
 
       description "Use the **breakpoint** resource to add breakpoints to recipes. Run the #{ChefUtils::Dist::Infra::SHELL} in #{ChefUtils::Dist::Infra::PRODUCT} mode, and then use those breakpoints to debug recipes. Breakpoints are ignored by the #{ChefUtils::Dist::Infra::CLIENT} during an actual #{ChefUtils::Dist::Infra::CLIENT} run. That said, breakpoints are typically used to debug recipes only when running them in a non-production environment, after which they are removed from those recipes before the parent cookbook is uploaded to the Chef server."
       introduced "12.0"

data/lib/chef/resource/build_essential.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.