PyPowerStore 1.9.0.0__tar.gz → 2.0.0.0__tar.gz

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 1.0
+Metadata-Version: 1.1
 Name: PyPowerStore
-Version: 1.9.0.0
+Version: 2.0.0.0
 Summary: Python Library for Dell PowerStore
 Home-page: https://github.com/dell/python-powerstore
 Author: Ansible Team at Dell
@@ -8,3 +8,4 @@ Author-email: ansible.team@dell.com
 License: UNKNOWN
 Description: UNKNOWN
 Platform: UNKNOWN
+Classifier: License :: OSI Approved :: Apache Software License

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore/__init__.py

@@ -2,6 +2,6 @@
 """__init__.py."""
 
 __title__ = 'PyPowerStore'
-__version__ = '1.9.0.0'
+__version__ = '2.0.0.0'
 __author__ = 'Dell Technologies or its subsidiaries'
 __copyright__ = 'Copyright 2019 Dell Technologies'

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore/client.py

@@ -247,7 +247,10 @@ class Client():
                 if self.is_valid_response(response):
                     response_json = None
                     if response.status_code != 204:
-                        response_json = response.json()
+                        if response.status_code == 201 and response.content == b'':
+                            pass
+                        else:
+                            response_json = response.json()
                     # check 'all_pages' required, response received is
                     # partial(code 206) and contains info about total size of
                     # the collection

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore/configuration.py

@@ -901,7 +901,6 @@ class Configuration:
     # IP ports operations end
 
     # vCenter operations start
-
     def get_vcenters(self, filter_dict=None, all_pages=False):
         """Get all vcenters.
         :param filter_dict: (optional) Filter details
@@ -916,11 +915,18 @@ class Configuration:
         querystring = helpers.prepare_querystring(
             constants.SELECT_ID, filter_dict)
         LOG.info("Querystring: '%s'" % querystring)
-        return self.config_client.request(
-            constants.GET,
-            constants.GET_VCENTER_LIST_URL.format(self.server_ip),
-            querystring=querystring, all_pages=all_pages
-        )
+        vcenter_list = self.config_client.\
+            request(constants.GET,
+                    constants.GET_VCENTER_LIST_URL.format(self.server_ip),
+                    querystring=querystring, all_pages=all_pages)
+
+        if vcenter_list:
+            resp_list = []
+            for vcenter in vcenter_list:
+                resp_dict = self.get_vcenter_details(vcenter['id'])
+                resp_list.append(resp_dict)
+            return resp_list
+        return vcenter_list
 
     def get_vcenter_details(self, vcenter_id):
         """Get vcenter details.
@@ -931,12 +937,11 @@ class Configuration:
         """
         LOG.info("Getting vcenter details by ID: '%s'" % vcenter_id)
         querystring = constants.VCENTER_DETAILS_QUERY
-        if helpers.is_foot_hill_or_higher():
-            querystring = {
-                'select': 'id,instance_uuid,address,username,'
-                          'vendor_provider_status,'
-                          'vendor_provider_status_l10n'
-            }
+        if helpers.is_foot_hill_prime_or_higher():
+            querystring = constants.FHP_VCENTER_QUERY
+        elif helpers.is_foot_hill_or_higher():
+            querystring = constants.FHC_MALKA_VCENTER_QUERY
+
         return self.config_client.request(
             constants.GET,
             constants.GET_VCENTER_DETAILS_URL.format(self.server_ip,
@@ -945,20 +950,66 @@ class Configuration:
         )
 
     def modify_vcenter(self, vcenter_id, modify_param_dict):
-        """Register VASA provider.
+        """Modify vcenter attributes.
         :param vcenter_id: ID of the vcenter
         :type vcenter_id: str
-        :param modify_param_dict: Dict containing VASA provider credentials
+        :param modify_param_dict: Dict containing parameters for modification
         :type modify_param_dict: dict
         :return: Details of vcenter
         :rtype: dict
         """
-        LOG.info("Registering VASA provider: '%s'" % vcenter_id)
+        LOG.info("Modifying vCenter attributes: '%s'" % vcenter_id)
         self.config_client.request(constants.PATCH,
                                    constants.MODIFY_VCENTER_URL.format(
                                        self.server_ip, vcenter_id),
                                    payload=modify_param_dict)
         return self.get_vcenter_details(vcenter_id)
+
+    def add_vcenter(self, add_params):
+        """
+        Add a vcenter to the unified PowerStore model.
+        vcenter can not be added to unified+ deployment
+        :param add_params: the parameters to add vcenter
+        :type add_params:dict
+        :return: ID of the vcenter if addition is successful
+        :rtype: dict
+        """
+        LOG.info("Adding a vcenter.")
+
+        payload = dict()
+        if add_params:
+            for key, values in add_params.items():
+                payload[key] = values
+
+        return self.config_client.\
+            request(constants.POST,
+                    constants.ADD_VCENTER_URL.format(self.server_ip),
+                    payload=payload)
+
+    def remove_vcenter(self, vcenter_id, delete_vasa_provider=None):
+        """
+        Remove vcenter from Unified PowerStore model.
+        vcenter can not be removed from unified+ deployment
+        :param vcenter_id: ID of the vcenter
+        :type vcenter_id: str
+        :param delete_vasa_provider: whether to remove a VASA provider.
+                                     Removal will only happen if the provider
+                                     is not connected to any other PowerStore
+                                     system
+        :type delete_vasa_provider: bool
+        :return: None if success
+        :rtype: None
+        """
+        LOG.info("Removing vcenter: {0}.".format(vcenter_id))
+        payload = dict()
+        if delete_vasa_provider is not None:
+            payload['delete_vendor_provider'] = delete_vasa_provider
+
+        return self.config_client.\
+            request(constants.DELETE,
+                    constants.REMOVE_VCENTER_URL.format(self.server_ip,
+                                                        vcenter_id),
+                    payload=payload)
     # vCenter operations end
 
     # Appliance operations start
@@ -1761,7 +1812,6 @@ class Configuration:
         """
         LOG.info("Modifying remote support contact : '%s' with params '%s'" % (
             remote_support_contact_id, modify_parameters))
-        print(remote_support_contact_id)
         if helpers.is_foot_hill_or_higher():
             remote_support_contact_url = constants.MODIFY_REMOTE_SUPPORT_CONTACT_URL
             return self.config_client.request(
@@ -1843,10 +1893,10 @@ class Configuration:
         resp = self.config_client.request(
             constants.GET,
             constants.GET_LDAP_DOMAIN_LIST_URL.format(
-                self.server_ip, ldap_domain_name),
+                self.server_ip),
             querystring=helpers.prepare_querystring(
                 constants.LDAP_DOMAIN_DETAILS_QUERY,
-                name=constants.EQUALS + ldap_domain_name)
+                domain_name=constants.EQUALS + ldap_domain_name)
         )
 
         filterable_keys = ['domain_name', 'id', 'protocol', 'ldap_server_type']
@@ -2044,7 +2094,209 @@ class Configuration:
                 self.server_ip, ldap_account_id))
 
 
-    # LDAP Account operations end    
+    # LDAP Account operations end
+
+    # Virtual volume operations begin
+
+    def get_virtual_volume_list(self, filter_dict=None, all_pages=None):
+        """Get all virtual volumes available on array.
+        :param filter_dict: (optional) Filter details
+        :type filter_dict: dict
+        :param all_pages: (optional) Indicates whether to return all
+                          virtual volumes or not
+        :type all_pages: bool
+        :return: List of virtual volumes on array
+        :rtype: list[dict]
+        """
+        LOG.info("Getting volumes with filter: '%s' and all_pages: %s"
+                 % (filter_dict, all_pages))
+        querystring = helpers.prepare_querystring(
+            constants.VIRTUAL_VOLUME_DETAILS_QUERY,
+            filter_dict)
+        if helpers.is_foot_hill_prime_or_higher():
+            querystring = helpers.prepare_querystring(
+            constants.VIRTUAL_VOLUME_FHP_DETAILS_QUERY,
+            filter_dict)
+        LOG.info("Querystring: '%s'" % querystring)
+        return self.config_client.request(constants.GET,
+                                   constants.GET_VIRTUAL_VOLUME_LIST_URL.format
+                                   (self.server_ip), payload=None,
+                                   querystring=querystring,
+                                   all_pages=all_pages)
+
+    # Virtual volume operations end
+
+    # Storage container operations begin
+
+    def get_storage_container_list(self, filter_dict=None, all_pages=None):
+        """Get all storage container available on array.
+        :param filter_dict: (optional) Filter details
+        :type filter_dict: dict
+        :param all_pages: (optional) Indicates whether to return all
+                          Storage containers or not
+        :type all_pages: bool
+        :return: List of storage containers on array
+        :rtype: list[dict]
+        """
+        LOG.info("Getting storage containers with filter: '%s' and all_pages: %s"
+                 % (filter_dict, all_pages))
+        querystring = helpers.prepare_querystring(
+            constants.STORAGE_CONTAINER_DETAILS_QUERY,
+            filter_dict)
+        LOG.info("Querystring: '%s'" % querystring)
+        return self.config_client.request(constants.GET,
+                                   constants.GET_STORAGE_CONTAINER_LIST_URL.format
+                                   (self.server_ip), payload=None,
+                                   querystring=querystring,
+                                   all_pages=all_pages)
+
+    def get_storage_container_details(self, storage_container_id):
+        """ Get details of a storage container instance.
+
+        :param storage_container_id: Unique identifier of the storage_container
+        :type storage_container_id: str
+        :return: storage container details
+        :rtype: dict
+        """
+        LOG.info("Getting storage container details by ID: '%s'" % storage_container_id)
+
+        return self.config_client.request(
+            constants.GET,
+            constants.GET_STORAGE_CONTAINER_DETAILS_URL.format(
+                self.server_ip, storage_container_id),
+            querystring=constants.STORAGE_CONTAINER_DETAILS_QUERY)
+
+    def get_storage_container_details_by_name(self, storage_container_name):
+        """ Get details of a storage container instance.
+
+        :param storage_container_name: storage container name
+        :type storage_container_name: str
+        :return: storage container details
+        :rtype: dict
+        """
+        LOG.info("Getting storage container details by name: '%s'" % storage_container_name)
+        resp = self.get_storage_container_list()
+
+        for container in resp:
+            if container['name'] == storage_container_name:
+                return self.get_storage_container_details(container['id'])
+
+    def create_storage_container(self, create_parameters):
+        """ Create a storage_container.
+
+        :param create_parameters: Parameters for creating a storage_container
+        :type create_parameters: dict
+        :return: Unique identifier of the new storage container instance created
+        :rtype: dict
+        """
+        LOG.info("creating storage container")
+
+        return self.config_client.request(
+            constants.POST,
+            constants.CREATE_STORAGE_CONTAINER_URL.format(
+                self.server_ip), payload=create_parameters)
+
+    def modify_storage_container_details(self, storage_container_id, modify_parameters):
+        """ Modifying storage container configuration.
+
+        :param storage_container_id: Unique ID of the storage container instance
+        :type storage_container_id: str
+        :param modify_parameters: Parameters for modifying storage container
+        :type modify_parameters: dict
+        :return: None
+        :rtype: None
+        """
+        LOG.info("Modifying storage containert id: '%s'" % storage_container_id)
+
+        return self.config_client.request(
+            constants.PATCH,
+            constants.MODIFY_STORAGE_CONTAINER_URL.format(
+                self.server_ip, storage_container_id), payload=modify_parameters)
+
+    def delete_storage_container(self, storage_container_id, delete_parameters):
+        """ Delete a storage container.
+
+        :param storage_container_id: Unique ID of the storage container instance
+        :type storage_container_id: str
+        :return: None
+        :rtype: None
+        """
+        LOG.info("Deleting storage container with id: '%s'" % storage_container_id)
+
+        return self.config_client.request(
+            constants.DELETE,
+            constants.DELETE_STORAGE_CONTAINER_URL.format(
+                self.server_ip, storage_container_id), payload=delete_parameters)
+    # Storage container operations end
+
+    # Storage container destination operations start
+    def get_storage_container_destination_list(self, filter_dict=None, all_pages=None):
+        """Get all storage container destination.
+        :param filter_dict: (optional) Filter details
+        :type filter_dict: dict
+        :param all_pages: (optional) Indicates whether to return all
+                          Storage containers destination or not
+        :type all_pages: bool
+        :return: List of storage containers destination
+        :rtype: list[dict]
+        """
+        LOG.info("Getting storage containers destination with filter: '%s' "
+                 "and all_pages: %s" % (filter_dict, all_pages))
+        querystring = helpers.prepare_querystring(
+            constants.STORAGE_CONTAINER_DETAILS_DESTINATION_QUERY, filter_dict)
+        LOG.info("Querystring: '%s'" % querystring)
+        return self.config_client.request(
+            constants.GET,
+            constants.GET_STORAGE_CONTAINER_DESTINATION_LIST_URL.format(
+                self.server_ip),
+            payload=None, querystring=querystring, all_pages=all_pages)
+
+    def get_storage_container_destination_details(self, storage_container_destination_id):
+        """ Get details of a storage container destination instance.
+
+        :param storage_container_destination_id: Unique identifier of the
+                                                 storage container destination
+        :type storage_container_destination_id: str
+        :return: storage container destination details
+        :rtype: dict
+        """
+        LOG.info("Getting storage container destination details by "
+                 "ID: '%s'" % storage_container_destination_id)
+
+        return self.config_client.request(
+            constants.GET,
+            constants.GET_STORAGE_CONTAINER_DESTINATION_DETAILS_URL.format(
+                self.server_ip, storage_container_destination_id),
+            querystring=constants.STORAGE_CONTAINER_DETAILS_DESTINATION_QUERY)
+
+    def create_storage_container_destination(self, create_destination_params):
+        """Create a Storage Container Destination
+        :param create_destination_params: parameter to create storage container
+                                          destination
+        :type create_destination_params: dict
+        :return: Unique identifier of newly created storage container destination
+        :rtype: dict
+        """
+        LOG.info("Creating storage container destination.")
+        return self.config_client.request(
+            constants.POST,
+            constants.CREATE_STORAGE_CONTAINER_DESTINATION_URL.format(
+                self.server_ip), payload=create_destination_params)
+
+    def delete_storage_container_destination(self, storage_container_destination_id):
+        """Delete a storage container destination
+        :param storage_container_destination_id: ID of storage container destination
+        :type storage_container_destination_id: str
+        :rtype: None
+        """
+        LOG.info("Deleting storage container destination with "
+                 "id: '%s'" % storage_container_destination_id)
+        return self.config_client.request(
+            constants.DELETE,
+            constants.DELETE_STORAGE_CONTAINER_DESTINATION_URL.format(
+                self.server_ip, storage_container_destination_id))
+
+    # Storage container destination operations end
 
     @staticmethod
     def _prepare_local_user_payload(**kwargs):

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore/protection.py

@@ -1142,6 +1142,61 @@ class ProtectionFunctions:
 
     # Replication Session end
 
+    # Replication group start
+    def get_replication_groups(self, filter_dict=None, all_pages=False):
+        """Get all the replication groups
+        :param filter_dict: (optional) Filter details
+        :type filter_dict: dict
+        :param all_pages: (optional) Indicates whether to return all elements
+                          or not
+        :type all_pages: bool
+        :return: replication groups.
+        :rtype: list[dict]
+        """
+        LOG.info("Getting replication groups with filter: '%s' and "
+                 "all_pages: %s" % (filter_dict, all_pages))
+        querystring = helpers.prepare_querystring(
+            constants.REPLICATION_GROUP_QUERY, filter_dict)
+        LOG.info("Querystring: '%s'" % querystring)
+        return self.rest_client.request(
+            constants.GET, constants.REPLICATION_GROUP_DETAILS_LIST_URL.format(
+                self.server_ip), payload=None, querystring=querystring,
+            all_pages=all_pages)
+
+    def get_replication_group_details(self, replication_group_id):
+        """Getting the details of a replication group using ID
+        :param replication_group_id: ID of the replication group
+        :type replication_group_id: str
+        :return: replication session details
+        :rtype: dict
+        """
+        LOG.info("Getting replication session details by ID:"
+                 " '%s'" % replication_group_id)
+
+        return self.rest_client.request(
+            constants.GET,
+            constants.REPLICATION_GROUP_DETAILS_URL.format(
+                self.server_ip, replication_group_id),
+            querystring=constants.REPLICATION_GROUP_QUERY)
+
+    def get_replication_group_details_by_name(self, replication_group_name):
+        """Get details of the replication group details using name
+        :param replication_group_name: Name of the replication group
+        :type replication_group_name: str
+        :return: replication session details
+        :rtype: list of dict
+        """
+        LOG.info("Getting replication group details by name:"
+                 " '%s'" % replication_group_name)
+        return self.rest_client.request(
+            constants.GET,
+            constants.REPLICATION_GROUP_DETAILS_LIST_URL.format(
+                self.server_ip),
+            querystring=helpers.prepare_querystring(
+                constants.REPLICATION_GROUP_QUERY,
+                name=constants.EQUALS + replication_group_name))
+    # Replication group end
+
     # Remote System start
     def get_remote_systems(self, filter_dict=None, all_pages=False):
         """Get all remote systems.

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore/provisioning.py

@@ -64,7 +64,8 @@ class Provisioning:
 
     def create_volume(self, name, size, description=None,
                       volume_group_id=None, protection_policy_id=None,
-                      performance_policy_id=None):
+                      performance_policy_id=None, app_type=None,
+                      app_type_other=None, appliance_id=None):
         """Create a volume.
 
         :param name: The name of the volume
@@ -73,13 +74,24 @@ class Provisioning:
         :param volume_group_id: (optional) The volume group ID
         :param protection_policy_id: (optional) The protection policy ID
         :param performance_policy_id: (optional) The performance policy ID
+        :param app_type: (optional) The application type
+        :param app_type_other: (optional) Describes application type when
+            app_type is set to other
+        :param appliance_id: (optional) The appliance ID
         """
+        if app_type is not None and not helpers.is_malka_or_higher():
+            raise Exception("'app_type' parameter is supported only from "
+                            "Powerstore version 2.1.0.0 onwards")
+
         LOG.info("Creating volume: '%s'" % name)
         payload = self._prepare_create_volume_payload(name, size,
                                                       description,
                                                       volume_group_id,
                                                       protection_policy_id,
-                                                      performance_policy_id)
+                                                      performance_policy_id,
+                                                      app_type,
+                                                      app_type_other,
+                                                      appliance_id)
         self.client.request(constants.POST,
                             constants.VOLUME_CREATE_URL.format(
                                 self.server_ip), payload)
@@ -88,7 +100,10 @@ class Provisioning:
                                        description,
                                        volume_group_id,
                                        protection_policy_id,
-                                       performance_policy_id):
+                                       performance_policy_id,
+                                       app_type,
+                                       app_type_other,
+                                       appliance_id):
 
         create_volume_dict = dict()
         if name is not None:
@@ -104,6 +119,12 @@ class Provisioning:
         if performance_policy_id is not None:
             create_volume_dict['performance_policy_id'] = \
                 performance_policy_id
+        if app_type is not None:
+            create_volume_dict['app_type'] = app_type
+        if app_type_other is not None:
+            create_volume_dict['app_type_other'] = app_type_other
+        if appliance_id is not None:
+            create_volume_dict['appliance_id'] = appliance_id
 
         return create_volume_dict
 
@@ -122,8 +143,8 @@ class Provisioning:
             payload=None)
 
     def modify_volume(self, volume_id, name=None, description=None, size=None,
-                      protection_policy_id=None,
-                      performance_policy_id=None):
+                      protection_policy_id=None, performance_policy_id=None,
+                      app_type=None, app_type_other=None):
         """Modify a volume.
 
         :param volume_id: The volume ID
@@ -138,16 +159,26 @@ class Provisioning:
         :type protection_policy_id: str
         :param performance_policy_id: The performance policy ID
         :type performance_policy_id: str
+        :param app_type: The application type
+        :type app_type: str
+        :param app_type_other: Describes application type when
+            app_type is set to other
         :return: None if success else raise exception
         :rtype: None
         """
+        if app_type is not None and not helpers.is_malka_or_higher():
+            raise Exception("'app_type' parameter is supported only from "
+                            "Powerstore version 2.1.0.0 onwards")
+
         LOG.info("Modifying volume: '%s'" % volume_id)
         payload = self.\
             _prepare_modify_volume_payload(name,
                                            description,
                                            size,
                                            protection_policy_id,
-                                           performance_policy_id)
+                                           performance_policy_id,
+                                           app_type,
+                                           app_type_other)
         return self.client.request(
             constants.PATCH, constants.MODIFY_VOLUME_URL.format(
                 self.server_ip, volume_id),
@@ -156,7 +187,9 @@ class Provisioning:
     def _prepare_modify_volume_payload(self, name=None, description=None,
                                        size=None,
                                        protection_policy_id=None,
-                                       performance_policy_id=None):
+                                       performance_policy_id=None,
+                                       app_type=None,
+                                       app_type_other=None):
 
         modify_volume_dict = dict()
         if name is not None:
@@ -170,6 +203,10 @@ class Provisioning:
         if performance_policy_id is not None:
             modify_volume_dict['performance_policy_id'] = \
                 performance_policy_id
+        if app_type is not None:
+            modify_volume_dict['app_type'] = app_type
+        if app_type_other is not None:
+            modify_volume_dict['app_type_other'] = app_type_other
 
         return modify_volume_dict
 
@@ -238,7 +275,7 @@ class Provisioning:
                 performance_policy_id
 
         return clone_volume_dict
-    
+
     def refresh_volume(self, volume_id, volume_id_to_refresh_from=None,
                        create_backup_snap=None,
                        backup_snap_name=None,
@@ -303,7 +340,7 @@ class Provisioning:
                 backup_snap_performance_policy_id
 
         return refresh_volume_dict
-    
+
     def restore_volume(self, volume_id, snap_id_to_restore_from=None,
                        create_backup_snap=None,
                        backup_snap_name=None,
@@ -1163,7 +1200,7 @@ class Provisioning:
         :type name: str
         :param description: (optional) Description for the clone volume group.
         :type description: str
-        :param protection_policy_id: (optional) Unique identifier of the protection 
+        :param protection_policy_id: (optional) Unique identifier of the protection
                                      policy to assign to the clone volume group
         :type protection_policy_id: str
         :return: Unique identifier of the new instance created if success else raise exception
@@ -1493,7 +1530,7 @@ class Provisioning:
         )
 
     # NAS Server methods
- 
+
     def get_nas_servers(self, filter_dict=None, all_pages=False):
         """Get a list of nas servers.
 
@@ -1620,12 +1657,15 @@ class Provisioning:
         :rtype: dict
         """
         LOG.info("Getting filesystem details by ID: '%s'" % filesystem_id)
+        querystring=constants.SELECT_ALL_FILESYSTEM
+        if helpers.is_foot_hill_prime_or_higher():
+            querystring=constants.SELECT_ALL_FILESYSTEM_PRIME
         return self.client.request(
             constants.GET,
             constants.GET_FILESYSTEM_DETAILS_URL.format(self.server_ip,
                                                         filesystem_id),
             payload=None,
-            querystring=constants.SELECT_ALL_FILESYSTEM)
+            querystring=querystring)
 
     def get_filesystem_by_name(self, filesystem_name, nas_server_id):
         """Get details of a filesystem by name.
@@ -1637,12 +1677,15 @@ class Provisioning:
         """
         LOG.info("Getting filesystem details by name: '%s' and NAS Server: "
                  "'%s'" % (filesystem_name, nas_server_id))
+        querystring=constants.SELECT_ALL_FILESYSTEM
+        if helpers.is_foot_hill_prime_or_higher():
+            querystring=constants.SELECT_ALL_FILESYSTEM_PRIME
         return self.client.request(
             constants.GET,
             constants.GET_FILESYSTEM_DETAILS_BY_NAME_URL.format(
                 self.server_ip),
             payload=None, querystring=helpers.prepare_querystring(
-                constants.SELECT_ALL_FILESYSTEM,
+                querystring,
                 nas_server_id=constants.EQUALS + nas_server_id,
                 name=constants.EQUALS + filesystem_name
             )
@@ -1671,6 +1714,10 @@ class Provisioning:
 
         if advance_parameters:
             for key, value in advance_parameters.items():
+                if key in constants.FILESYSTEM_PRIME and \
+                        not helpers.is_foot_hill_prime_or_higher():
+                    raise Exception( key + " is supported for PowerStore" \
+                        " version 3.0.0.0 and above.")
                 payload[key] = value
         return self.client.request(constants.POST,
                                    constants.CREATE_FILESYSTEM_URL.format(
@@ -1722,6 +1769,10 @@ class Provisioning:
         if modify_parameters:
             payload = dict()
             for key, value in modify_parameters.items():
+                if key in constants.FILESYSTEM_PRIME and \
+                        not helpers.is_foot_hill_prime_or_higher():
+                    raise Exception( key + " is supported for PowerStore" \
+                        " version 3.0.0.0 and above.")
                 if value is not None:
                     payload[key] = value
 

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore/utils/constants.py

@@ -60,16 +60,19 @@ FHP_VOLUME_DETAILS_QUERY = {
 }
 
 # Host Query
-SELECT_ALL_HOST = {"select": "id,name,description,os_type,"
-                             "host_group_id,"
-                             "host_initiators,os_type_l10n,"
-                             "mapped_hosts(id,logical_unit_number,"
-                             "host_group(id,name),volume(id,name))"
+SELECT_ALL_HOST = {
+    "select": "id,name,description,os_type,"
+              "host_group_id,"
+              "host_initiators,os_type_l10n,"
+              "mapped_hosts(id,logical_unit_number,"
+              "host_group(id,name),volume(id,name)),"
+              "host_virtual_volume_mappings(id,host_id,host_group_id,virtual_volume_id)"
                    }
 FHC_HOST_DETAILS_QUERY = {
     "select": "id,name,description,os_type,host_group_id,host_initiators,"
               "os_type_l10n,mapped_hosts(id,logical_unit_number,"
-              "host_group(id,name),volume(id,name)),type,type_l10n"
+              "host_group(id,name),volume(id,name)),type,type_l10n,"
+              "host_virtual_volume_mappings(id,host_id,host_group_id,virtual_volume_id)"
 }
 FHP_HOST_DETAILS_QUERY = {
     "select": "id,name,description,type,os_type,host_group_id,"
@@ -77,11 +80,13 @@ FHP_HOST_DETAILS_QUERY = {
               "mapped_hosts(id,logical_unit_number,host_group(id,name),"
               "volume(id,name)),type_l10n,host_connectivity_l10n,"
               "initiators(id,port_name,port_type,chap_single_username,"
-              "chap_mutual_username,active_sessions),host_initiators"
+              "chap_mutual_username,active_sessions),host_initiators,"
+              "host_virtual_volume_mappings(id,host_id,host_group_id,virtual_volume_id)"
 }
 
 SELECT_ALL_HOST_GROUP = {"select": "name,id,description,hosts(id,name)"}
-FHP_HOST_GROUP_QUERY = {"select": "name,id,description,hosts(id,name),"
+FHP_HOST_GROUP_QUERY = {"select": "name,id,description,hosts(id,name,host_virtual_volume_mappings(id,"
+                                  "host_id,host_group_id,virtual_volume_id)),"
                                   "host_connectivity,host_connectivity_l10n,"
                                   "mapped_host_groups(id,volume_id,"
                                   "logical_unit_number)"}
@@ -136,6 +141,32 @@ SELECT_ALL_FILESYSTEM = {"select": "id,name, description,"
                          "creator_type_l10n,nas_server(name,id),"
                          "protection_policy(name,id)"}
 
+SELECT_ALL_FILESYSTEM_PRIME = {"select": "id,name, description,"
+                               "parent_id, filesystem_type, size_total,size_used,"
+                               "access_policy,locking_policy,"
+                               "folder_rename_policy, is_smb_sync_writes_enabled,"
+                               "is_smb_op_locks_enabled, is_smb_no_notify_enabled,"
+                               "is_smb_notify_on_access_enabled,"
+                               "is_smb_notify_on_write_enabled,"
+                               "smb_notify_on_change_dir_depth,"
+                               "is_async_MTime_enabled, is_quota_enabled,"
+                               "grace_period, default_hard_limit,"
+                               "default_soft_limit, creation_timestamp,"
+                               "expiration_timestamp, last_refresh_timestamp,"
+                               "last_writable_timestamp, is_modified,access_type,"
+                               "creator_type, filesystem_type_l10n,"
+                               "access_policy_l10n, locking_policy_l10n,"
+                               "folder_rename_policy_l10n, access_type_l10n,"
+                               "creator_type_l10n,nas_server(name,id),"
+                               "protection_policy(name,id),"
+                               "file_events_publishing_mode,"
+                               "file_events_publishing_mode_l10n,"
+                               "config_type, config_type_l10n,flr_attributes,"
+                               "host_io_size,host_io_size_l10n"}
+
+FILESYSTEM_PRIME = ['config_type', 'is_async_MTime_enabled',
+                    'file_events_publishing_mode', 'flr_attributes',
+                    'host_io_size']
 
 FHP_NAS_QUERYSTRING = {"select": "id,name, description, operational_status,"
                        "current_node_id,preferred_node_id,"
@@ -292,6 +323,20 @@ IP_PORT_DETAILS_QUERY = {
 VCENTER_DETAILS_QUERY = {
     'select': 'id,instance_uuid,address,username'
 }
+FHC_MALKA_VCENTER_QUERY = {
+    'select': 'id,instance_uuid,address,username,vendor_provider_status,'
+              'vendor_provider_status_l10n,'
+              'virtual_machines(id,name,instance_uuid,type,status,'
+              'virtual_volumes,protection_policy_id)'
+}
+FHP_VCENTER_QUERY = {
+    'select': 'id,instance_uuid,address,username,version,'
+              'vendor_provider_status,vendor_provider_status_l10n,'
+              'virtual_machines(id,name,instance_uuid,type,status,'
+              'virtual_volumes,protection_policy_id),'
+              'datastores(id,instance_uuid,name,type,'
+              'storage_container_id),vsphere_hosts(id,name,version)'
+}
 
 # Appliance details
 APPLIANCE_DETAILS_QUERY = {
@@ -322,16 +367,18 @@ REMOTE_SYSTEM_FHP_DETAILS_QUERY = {
               'state_l10n,data_connection_type_l10n,file_connection_state_l10n,'
               'data_connection_state_l10n,discovery_chap_mode_l10n,'
               'session_chap_mode_l10n,data_network_latency_l10n,'
-              'capabilities_l10n,storage_container_destinations'
+              'capabilities_l10n,storage_container_destinations(id,'
+              'storage_container_id,remote_system_id,remote_storage_container_id,'
+              'storage_container(id,name))'
 }
 
 # Certificate details
 CERTIFICATE_DETAILS_QUERY = {
     'select': 'id,type,type_l10n,service,service_l10n,scope,is_current,'
-               'is_valid,members(subject,serial_number,signature_algorithm,'
-               'issuer,valid_from,valid_to,public_key_algorithm,key_length,'
-               'thumbprint_algorithm,thumbprint_algorithm_l10n,thumbprint,'
-               'certificate,depth,subject_alternative_names)'
+              'is_valid,members(subject,serial_number,signature_algorithm,'
+              'issuer,valid_from,valid_to,public_key_algorithm,key_length,'
+              'thumbprint_algorithm,thumbprint_algorithm_l10n,thumbprint,'
+              'certificate,depth,subject_alternative_names)'
 }
 
 # Security config details
@@ -378,6 +425,42 @@ LDAP_DOMAIN_DETAILS_QUERY = {
               'group_name_attribute,group_member_attribute,group_object_class,'
               'group_search_path,group_search_level,ldap_server_type_l10n,protocol_l10n'
 }
+VIRTUAL_VOLUME_FHP_DETAILS_QUERY = {
+    'select': 'id,name,size,type,usage_type,appliance_id,storage_container_id,io_priority,profile_id,'
+              'replication_group_id,creator_type,is_readonly,migration_session_id,virtual_machine_uuid,'
+              'family_id,parent_id,source_id,source_timestamp,creation_timestamp,naa_name,'
+              'is_replication_destination,location_history,protection_policy_id,nsid,nguid,type_l10n,'
+              'usage_type_l10n,io_priority_l10n,creator_type_l10n,'
+              'host_virtual_volume_mappings(id,host_id,host_group_id,virtual_volume_id)'
+}
+VIRTUAL_VOLUME_DETAILS_QUERY = {
+    'select': 'id,name,size,type,usage_type,appliance_id,storage_container_id,io_priority,profile_id,'
+              'creator_type,is_readonly,migration_session_id,virtual_machine_uuid,'
+              'family_id,parent_id,source_id,source_timestamp,creation_timestamp,'
+              'location_history,type_l10n,usage_type_l10n,io_priority_l10n,creator_type_l10n,'
+              'host_virtual_volume_mappings(id,host_id,host_group_id,virtual_volume_id)'
+}
+
+STORAGE_CONTAINER_DETAILS_QUERY = {
+    'select': 'id,name,quota,storage_protocol,storage_protocol_l10n,'
+              'virtual_volumes(id,name),replication_groups(id,name),datastores(id,name),'
+              'destinations(id,remote_system_id,remote_storage_container_id)'
+}
+
+STORAGE_CONTAINER_DETAILS_DESTINATION_QUERY = {
+    'select': 'id,remote_system_id,storage_container_id,'
+              'storage_container(id,name),remote_storage_container_id,'
+              'remote_system(id,name,management_address)'
+}
+
+REPLICATION_GROUP_QUERY = {
+    'select': 'id,name,storage_container_id,description,creator_type,'
+              'creation_timestamp,is_replication_destination,creator_type_l10n'
+              ',virtual_volumes,storage_container,parent,source,'
+              'child_replication_groups,target_replication_groups,'
+              'virtual_machines'
+}
+
 # LDAP Account details
 LDAP_ACCOUNT_DETAILS_QUERY = {
     'select': 'id,role_id,domain_id,name,type,type_l10n,dn'
@@ -470,6 +553,10 @@ REPLICATION_SESSION_FAILOVER_URL = 'https://{0}/api/rest/replication_session/{1}
 REPLICATION_SESSION_REPROTECT_URL = 'https://{0}/api/rest/replication_session/{1}/reprotect'
 MODIFY_REPLICATION_SESSION_URL = REPLICATION_SESSION_OBJECT_URL
 
+# Replication Group endpoints
+REPLICATION_GROUP_DETAILS_LIST_URL = 'https://{0}/api/rest/replication_group'
+REPLICATION_GROUP_DETAILS_URL = 'https://{0}/api/rest/replication_group/{1}'
+
 # Remote system endpoints
 GET_REMOTE_SYSTEM_LIST_URL = 'https://{0}/api/rest/remote_system'
 GET_REMOTE_SYSTEM_DETAILS_URL = 'https://{0}/api/rest/remote_system/{1}'
@@ -592,7 +679,9 @@ GET_JOB_DETAILS_URL = 'https://{0}/api/rest/job/{1}'
 # vCenter endpoints
 GET_VCENTER_LIST_URL = 'https://{0}/api/rest/vcenter'
 GET_VCENTER_DETAILS_URL = 'https://{0}/api/rest/vcenter/{1}'
+ADD_VCENTER_URL = GET_VCENTER_LIST_URL
 MODIFY_VCENTER_URL = GET_VCENTER_DETAILS_URL
+REMOVE_VCENTER_URL = GET_VCENTER_DETAILS_URL
 
 # Appliance endpoints
 GET_APPLIANCE_LIST_URL = 'https://{0}/api/rest/appliance'
@@ -667,3 +756,20 @@ GET_LDAP_ACCOUNT_DETAILS_URL = 'https://{0}/api/rest/ldap_account/{1}'
 CREATE_LDAP_ACCOUNT_URL = GET_LDAP_ACCOUNT_LIST_URL
 MODIFY_LDAP_ACCOUNT_URL = GET_LDAP_ACCOUNT_DETAILS_URL
 DELETE_LDAP_ACCOUNT_URL = GET_LDAP_ACCOUNT_DETAILS_URL
+
+# virtual volume endpoints
+GET_VIRTUAL_VOLUME_LIST_URL = 'https://{0}/api/rest/virtual_volume'
+GET_VIRTUAL_VOLUME_DETAILS_URL = 'https://{0}/api/rest/virtual_volume/{1}'
+
+# Storage container endpoints
+GET_STORAGE_CONTAINER_LIST_URL = 'https://{0}/api/rest/storage_container'
+GET_STORAGE_CONTAINER_DETAILS_URL = 'https://{0}/api/rest/storage_container/{1}'
+CREATE_STORAGE_CONTAINER_URL = GET_STORAGE_CONTAINER_LIST_URL
+MODIFY_STORAGE_CONTAINER_URL = GET_STORAGE_CONTAINER_DETAILS_URL
+DELETE_STORAGE_CONTAINER_URL = GET_STORAGE_CONTAINER_DETAILS_URL
+
+# Storage container Destination endpoints
+GET_STORAGE_CONTAINER_DESTINATION_LIST_URL = "https://{0}/api/rest/storage_container_destination"
+GET_STORAGE_CONTAINER_DESTINATION_DETAILS_URL = "https://{0}/api/rest/storage_container_destination/{1}"
+CREATE_STORAGE_CONTAINER_DESTINATION_URL = GET_STORAGE_CONTAINER_DESTINATION_LIST_URL
+DELETE_STORAGE_CONTAINER_DESTINATION_URL = GET_STORAGE_CONTAINER_DESTINATION_DETAILS_URL

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore/utils/helpers.py

@@ -48,7 +48,7 @@ def get_logger(module_name, enable_log=False):
 
 
 def is_foot_hill_or_higher():
-    """Return a true if the array version is foot hill or higher.
+    """Returns true if the array version is foot hill or higher.
 
     :return: True if foot hill or higher
     :rtype: bool
@@ -60,9 +60,21 @@ def is_foot_hill_or_higher():
         return True
     return False
 
+def is_malka_or_higher():
+    """Returns true if the array version is Malka or higher.
+
+    :return: True if array version is Malka or higher
+    :rtype: bool
+    """
+    malka_version = '2.1.0.0'
+    array_version = provisioning_obj.get_array_version()
+    if array_version and (
+            parse_version(array_version[0:7]) >= parse_version(malka_version)):
+        return True
+    return False
 
 def is_foot_hill_prime_or_higher():
-    """Return a true if the array version is foothill prime or higher.
+    """Returns true if the array version is foothill prime or higher.
 
     :return: True if foothill prime or higher
     :rtype: bool

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 1.0
+Metadata-Version: 1.1
 Name: PyPowerStore
-Version: 1.9.0.0
+Version: 2.0.0.0
 Summary: Python Library for Dell PowerStore
 Home-page: https://github.com/dell/python-powerstore
 Author: Ansible Team at Dell
@@ -8,3 +8,4 @@ Author-email: ansible.team@dell.com
 License: UNKNOWN
 Description: UNKNOWN
 Platform: UNKNOWN
+Classifier: License :: OSI Approved :: Apache Software License

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/PyPowerStore.egg-info/SOURCES.txt

@@ -1,4 +1,3 @@
-LICENSE
 README.md
 setup.py
 PyPowerStore/__init__.py

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/README.md

@@ -46,7 +46,7 @@ The library docs are available under 'docs' folder.
 
 This library uses python's "requests" library.
 
-PyPowerStore officially supports Python 3.8, 3.9 and 3.10.
+PyPowerStore officially supports Python 3.9, 3.10 and 3.11.
 
 
 ## Support

{PyPowerStore-1.9.0.0 → PyPowerStore-2.0.0.0}/setup.py

@@ -10,7 +10,7 @@ except ImportError:
 
 
 setup(name='PyPowerStore',
-      version='1.9.0.0',
+      version='2.0.0.0',
       description='Python Library for Dell PowerStore',
       author='Ansible Team at Dell',
       author_email='ansible.team@dell.com',
@@ -18,6 +18,8 @@ setup(name='PyPowerStore',
         'urllib3>=1.26.7',
         'requests>=2.23.0'
       ],
+      license_files = ('LICENSE',),
+      classifiers=['License :: OSI Approved :: Apache Software License'],
       url='https://github.com/dell/python-powerstore',
       packages=['PyPowerStore', 'PyPowerStore.utils'],
       )

PyPowerStore-1.9.0.0/LICENSE

@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.