(FM-7700) Add a list operation returning registered transports

Author: DavidS

lib/puppet/resource_api/transport.rb

@@ -18,6 +18,16 @@ def register(schema)
   end
   module_function :register # rubocop:disable Style/AccessModifierDeclarations
 
+  # retrieve a Hash of transport schemas, keyed by their name.
+  def list
+    if @transports
+      Marshal.load(Marshal.dump(@transports))
+    else
+      {}
+    end
+  end
+  module_function :list # rubocop:disable Style/AccessModifierDeclarations
+
   def connect(name, connection_info)
     validate(name, connection_info)
     require "puppet/transport/#{name}"

spec/puppet/resource_api/transport_spec.rb

@@ -88,6 +88,38 @@
     end
   end
 
+  describe '#list' do
+    subject { described_class.list }
+
+    context 'with no transports registered' do
+      it { is_expected.to eq({}) }
+    end
+
+    context 'with a transport registered' do
+      let(:schema) do
+        {
+          name: 'test_target',
+          desc: 'a basic transport',
+          connection_info: {
+            host: {
+              type: 'String',
+              desc: 'the host ip address or hostname',
+            },
+          },
+        }
+      end
+
+      before(:each) do
+        described_class.register(schema)
+      end
+
+      it { expect(described_class.list['test_target'].definition).to eq schema }
+      it 'returns a new object' do
+        expect(described_class.list['test_target'].definition.object_id).not_to eq schema.object_id
+      end
+    end
+  end
+
   describe '#connect(name, connection_info)', agent_test: true do
     let(:name) { 'test_target' }
     let(:schema) do