text: 
  import logging
  from pyvisdk.exceptions import InvalidArgumentError
  
  ########################################
  # Automatically generated, do not edit.
  ########################################
  
  log = logging.getLogger(__name__)
  
  def HostPlugStoreTopology(vim, *args, **kwargs):
      '''This data object represents the plug-store topology on a host system. Through
      this data object, the storage structure of a system that utilizes the plug-
      store architecture can be presented.The object entity-relationship diagram is
      modeled below:Description and reasoning behind the relationships:When a storage
      device driver is loaded, it claims a PCI device as a host bus adapter. This
      host bus adapter is represented as an Adapter. The PCI device identifier is a
      property on the HostBusAdapter in the Adapter.Once the host bus adapter is on
      the system, the hardware bus is scanned. If a storage Device is found on the
      bus, the communication path to the Device from the the host bus adapter is
      represented by a Path. A Device may have more than one Path. How those Paths
      are composed to create a Device is determined by a storage Plugin.When a
      storage Plugin is loaded, it claims a set of Paths. It groups these Paths into
      a set of Devices. Devices are hence associated with a set of Paths that might
      be used to provide a single logical device such as in the case of multipathing.
      Devices may be also composed of zero Paths meaning that they do not directly
      use a host bus adapter for communication with underlying storage.The purpose of
      this data object is to represent the topology of storage as seen by the base
      plug-store system. There is some overlap with information in other objects such
      as ScsiTopology which is only applicable when a particular "native
      multipathing" plugin is used. This data object provides the complete inventory
      of Devices and Paths. Hence it provides a superset of Device mappings over data
      object such as ScsiTopology and MultipaThe use cases that this data object
      accommodates includes the following non-exhaustive list:'''
  
      obj = vim.client.factory.create('{urn:vim25}HostPlugStoreTopology')
  
      # do some validation checking...
      if (len(args) + len(kwargs)) < 0:
          raise IndexError('Expected at least 1 arguments got: %d' % len(args))
  
      required = [  ]
      optional = [ 'adapter', 'device', 'path', 'plugin', 'target', 'dynamicProperty',
          'dynamicType' ]
  
      for name, arg in zip(required+optional, args):
          setattr(obj, name, arg)
  
      for name, value in kwargs.items():
          if name in required + optional:
              setattr(obj, name, value)
          else:
              raise InvalidArgumentError("Invalid argument: %s.  Expected one of %s" % (name, ", ".join(required + optional)))
  
      return obj
  