chef 18.10.17 → 19.1.164

data/lib/chef/provider/windows_script.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");
@@ -94,7 +94,7 @@ class Chef
         acl = Chef::ReservedNames::Win32::Security::ACL.create(aces)
 
         # This actually applies the modified DACL to the file
-        # Use parentheses to bypass RuboCop / Cookstyle warning
+        # Use parentheses to bypass RuboCop / ChefStyle warning
         # about useless setter
         (securable_object.dacl = acl)
       end

data/lib/chef/provider/yum_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");
@@ -25,9 +25,7 @@ class Chef
     class YumRepository < Chef::Provider
       extend Chef::Mixin::Which
 
-      provides :yum_repository do
-        which "yum"
-      end
+      provides(:yum_repository, target_mode: true) { which "yum" }
 
       def load_current_resource; end
 

data/lib/chef/provider/zypper_repository.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");
@@ -25,7 +25,7 @@ require "chef-utils/dist" unless defined?(ChefUtils::Dist)
 class Chef
   class Provider
     class ZypperRepository < Chef::Provider
-      provides :zypper_repository, platform_family: "suse"
+      provides :zypper_repository, platform_family: "suse", target_mode: true
 
       def load_current_resource; end
 

data/lib/chef/provider.rb

@@ -1,7 +1,7 @@
 #
 # Author:: Adam Jacob (<adam@chef.io>)
 # Author:: Christopher Walters (<cw@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/providers.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Daniel DeLeo (<dan@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");
@@ -66,6 +66,7 @@ require_relative "provider/package/paludis"
 require_relative "provider/package/rpm"
 require_relative "provider/package/rubygems"
 require_relative "provider/package/yum"
+require_relative "provider/package/yum_tm"
 require_relative "provider/package/zypper"
 require_relative "provider/package/solaris"
 require_relative "provider/package/smartos"
@@ -74,6 +75,7 @@ require_relative "provider/package/cab"
 require_relative "provider/package/powershell"
 require_relative "provider/package/msu"
 require_relative "provider/package/snap"
+require_relative "provider/package/snap_tm"
 require_relative "provider/package/habitat"
 
 require_relative "provider/service/arch"

data/lib/chef/pwsh.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Matt Wrock (<mwrock@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/recipe.rb

@@ -1,7 +1,7 @@
 #--
 # Author:: Adam Jacob (<adam@chef.io>)
 # Author:: Christopher Walters (<cw@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");
@@ -97,8 +97,8 @@ class Chef
 
     def from_yaml(string)
       res = ::YAML.safe_load(string, permitted_classes: [Date])
-      unless res.is_a?(Hash) && res.key?("resources")
-        raise ArgumentError, "YAML recipe '#{source_file}' must contain a top-level 'resources' hash (YAML sequence), i.e. 'resources:'"
+      unless res.is_a?(Hash) && (res.key?("resources") || res.key?("include_recipes"))
+        raise ArgumentError, "YAML recipe '#{source_file}' must contain a top-level 'resources' or 'include_recipes' hash (YAML sequence), i.e. 'resources:'"
       end
 
       from_hash(res)
@@ -116,15 +116,15 @@ class Chef
 
     def from_json(string)
       res = JSONCompat.from_json(string)
-      unless res.is_a?(Hash) && res.key?("resources")
-        raise ArgumentError, "JSON recipe '#{source_file}' must contain a top-level 'resources' hash"
+      unless res.is_a?(Hash) && (res.key?("resources") || res.key?("include_recipes"))
+        raise ArgumentError, "JSON recipe '#{source_file}' must contain a top-level 'resources' or 'include_recipes' hash key"
       end
 
       from_hash(res)
     end
 
     def from_hash(hash)
-      hash["resources"].each do |rhash|
+      hash["resources"]&.each do |rhash|
         type = rhash.delete("type").to_sym
         name = rhash.delete("name")
         res = declare_resource(type, name)
@@ -133,6 +133,9 @@ class Chef
           res.send(key, value)
         end
       end
+      hash["include_recipes"]&.each do |recipe|
+        run_context.include_recipe recipe
+      end
     end
 
     def to_s

data/lib/chef/request_id.rb

@@ -1,5 +1,5 @@
 # Author:: Prajakta Purohit (<prajakta@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/_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,24 +174,36 @@ 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
     end
   else
     logger.debug format("REST resource %<name>s of type %<type>s does not exist. Skipping.",
-      type: new_resource.name, name: id_property)
+                        type: new_resource.name, name: id_property)
   end
 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)
 
@@ -198,9 +328,9 @@ action_class do
       end
 
       message = format("Setting property :%<property>s requires properties :%<properties>s to be set as well on resource %<resource_name>s",
-        property: property,
-        properties: dependent_properties.join(", :"),
-        resource_name: current_resource.to_s)
+                       property: property,
+                       properties: dependent_properties.join(", :"),
+                       resource_name: current_resource.to_s)
 
       a.failure_message message
     end
@@ -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,15 +501,20 @@ 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)
 

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,59 +23,60 @@ 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"
       examples <<~DOC
-        **Install an alternative**:
-
-        ```ruby
-        alternatives 'python install 2' do
-          link_name 'python'
-          path '/usr/bin/python2.7'
-          priority 100
-          action :install
-        end
-        ```
+      **Install an alternative**:
+
+      ```ruby
+      alternatives 'python install 2' do
+        link_name 'python'
+        path '/usr/bin/python2.7'
+        priority 100
+        action :install
+      end
+      ```
 
-        **Set an alternative**:
+      **Set an alternative**:
 
-        ```ruby
-        alternatives 'python set version 3' do
-          link_name 'python'
-          path '/usr/bin/python3'
-          action :set
-        end
-        ```
+      ```ruby
+      alternatives 'python set version 3' do
+        link_name 'python'
+        path '/usr/bin/python3'
+        action :set
+      end
+      ```
 
-        **Set the automatic alternative state**:
+      **Set the automatic alternative state**:
 
-        ```ruby
-        alternatives 'python auto' do
-          link_name 'python'
-          action :auto
-        end
-        ```
+      ```ruby
+      alternatives 'python auto' do
+        link_name 'python'
+        action :auto
+      end
+      ```
 
-        **Refresh an alternative**:
+      **Refresh an alternative**:
 
-        ```ruby
-        alternatives 'python refresh' do
-          link_name 'python'
-          action :refresh
-        end
-        ```
+      ```ruby
+      alternatives 'python refresh' do
+        link_name 'python'
+        action :refresh
+      end
+      ```
 
-        **Remove an alternative**:
+      **Remove an alternative**:
 
-        ```ruby
-        alternatives 'python remove' do
-          link_name 'python'
-          path '/usr/bin/python3'
-          action :remove
-        end
-        ```
+      ```ruby
+      alternatives 'python remove' do
+        link_name 'python'
+        path '/usr/bin/python3'
+        action :remove
+      end
+      ```
       DOC
 
       property :link_name, String,
@@ -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")