From 13cd2f5cfebbf18bb6da4dbdd36dcfff5ea49dac Mon Sep 17 00:00:00 2001
From: Ewoud Kohl van Wijngaarden <ewoud@kohlvanwijngaarden.nl>
Date: Fri, 9 May 2025 15:52:18 +0200
Subject: [PATCH] Remove unused ContentsDescription class

This class has been unused for a long time and replaced with
metadata.json.

Fixes: efc18dd8fe9735e3f17a35f00eaa74424a849a66 ("(PUP-1976) Use metadata.json as canonical metadata source.")
---
 .../module_tool/contents_description.rb       | 89 -------------------
 1 file changed, 89 deletions(-)
 delete mode 100644 lib/puppet/module_tool/contents_description.rb

diff --git a/lib/puppet/module_tool/contents_description.rb b/lib/puppet/module_tool/contents_description.rb
deleted file mode 100644
index 694fc1d99f..0000000000
--- a/lib/puppet/module_tool/contents_description.rb
+++ /dev/null
@@ -1,89 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../puppet/module_tool'
-
-module Puppet::ModuleTool
-  # = ContentsDescription
-  #
-  # This class populates +Metadata+'s Puppet type information.
-  class ContentsDescription
-    # Instantiate object for string +module_path+.
-    def initialize(module_path)
-      @module_path = module_path
-    end
-
-    # Update +Metadata+'s Puppet type information.
-    def annotate(metadata)
-      metadata.types.replace data.clone
-    end
-
-    # Return types for this module. Result is an array of hashes, each of which
-    # describes a Puppet type. The type description hash structure is:
-    # * :name => Name of this Puppet type.
-    # * :doc => Documentation for this type.
-    # * :properties => Array of hashes representing the type's properties, each
-    #   containing :name and :doc.
-    # * :parameters => Array of hashes representing the type's parameters, each
-    #   containing :name and :doc.
-    # * :providers => Array of hashes representing the types providers, each
-    #   containing :name and :doc.
-    # TODO Write a TypeDescription to encapsulate these structures and logic?
-    def data
-      unless @data
-        @data = []
-        type_names = []
-        (Dir[File.join(@module_path, "lib/puppet/type/*.rb")]).each do |module_filename|
-          require module_filename
-          type_name = File.basename(module_filename, ".rb")
-          type_names << type_name
-
-          (Dir[File.join(@module_path, "lib/puppet/provider/#{type_name}/*.rb")]).each do |provider_filename|
-            require provider_filename
-          end
-        end
-
-        type_names.each do |name|
-          type = Puppet::Type.type(name.to_sym)
-          if type
-            type_hash = { :name => name, :doc => type.doc }
-            type_hash[:properties] = attr_doc(type, :property)
-            type_hash[:parameters] = attr_doc(type, :param)
-            if type.providers.size > 0
-              type_hash[:providers] = provider_doc(type)
-            end
-            @data << type_hash
-          else
-            Puppet.warning _("Could not find/load type: %{name}") % { name: name }
-          end
-        end
-      end
-      @data
-    end
-
-    # Return an array of hashes representing this +type+'s attrs of +kind+
-    # (e.g. :param or :property), each containing :name and :doc.
-    def attr_doc(type, kind)
-      attrs = []
-
-      type.allattrs.each do |name|
-        if type.attrtype(name) == kind && name != :provider
-          attrs.push(:name => name, :doc => type.attrclass(name).doc)
-        end
-      end
-
-      attrs
-    end
-
-    # Return an array of hashes representing this +type+'s providers, each
-    # containing :name and :doc.
-    def provider_doc(type)
-      providers = []
-
-      type.providers.sort.each do |prov|
-        providers.push(:name => prov, :doc => type.provider(prov).doc)
-      end
-
-      providers
-    end
-  end
-end