PyPowerStore 3.1.0.0__tar.gz → 3.3.0.0__tar.gz

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: PyPowerStore
-Version: 3.1.0.0
+Version: 3.3.0.0
 Summary: Python Library for Dell PowerStore
 Home-page: https://github.com/dell/python-powerstore
 Author: Ansible Team at Dell

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PyPowerStore/__init__.py

@@ -3,6 +3,6 @@
 """__init__.py."""
 
 __title__ = 'PyPowerStore'
-__version__ = '3.1.0.0'
+__version__ = '3.3.0.0'
 __author__ = 'Dell Technologies or its subsidiaries'
 __copyright__ = 'Copyright 2024 Dell Technologies'

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PyPowerStore/protection.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
-# Copyright: (c) 2019, Dell Technologies
-# Copyright: (c) 2019, Ivan Pchelintsev <Ivan.Pchelintsev@emc.com>
+# Copyright: (c) 2024, Dell Technologies
+# Copyright: (c) 2024, Ivan Pchelintsev <Ivan.Pchelintsev@emc.com>
 
 """Collection of protection related functions for PowerStore"""
 

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PyPowerStore/provisioning.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright: (c) 2019, Dell Technologies
+# Copyright: (c) 2024, Dell Technologies
 
 """Collection of provisioning related functions for PowerStore"""
 
@@ -642,7 +642,9 @@ class Provisioning:
         """
         LOG.info("Getting volume details by ID: '%s'" % volume_id)
         querystring = constants.SELECT_ALL_VOLUME
-        if helpers.is_foot_hill_prime_or_higher():
+        if helpers.is_victory_or_higher():
+            querystring = constants.VICTORY_VOLUME_DETAILS_QUERY
+        elif helpers.is_foot_hill_prime_or_higher():
             querystring = constants.FHP_VOLUME_DETAILS_QUERY
         elif helpers.is_foot_hill_or_higher():
             querystring = constants.FHC_VOLUME_DETAILS_QUERY
@@ -668,7 +670,9 @@ class Provisioning:
         """
         LOG.info("Getting volume details by name: '%s'" % volume_name)
         querystring = constants.SELECT_ALL_VOLUME
-        if helpers.is_foot_hill_prime_or_higher():
+        if helpers.is_victory_or_higher():
+            querystring = constants.VICTORY_VOLUME_DETAILS_QUERY
+        elif helpers.is_foot_hill_prime_or_higher():
             querystring = constants.FHP_VOLUME_DETAILS_QUERY
         elif helpers.is_foot_hill_or_higher():
             querystring = constants.FHC_VOLUME_DETAILS_QUERY
@@ -2006,7 +2010,7 @@ class Provisioning:
         LOG.info("Getting smbshares with filter: '%s' and all_pages: %s"
                  % (filter_dict, all_pages))
         querystring = helpers.prepare_querystring(
-            constants.SELECT_ID_AND_NAME, filter_dict)
+            constants.SELECT_ALL_SMB_SHARE, filter_dict)
         LOG.info("Querystring: '%s'" % querystring)
         return self.client.request(constants.GET,
                                    constants.GET_SMB_SHARE_LIST_URL.format
@@ -2105,6 +2109,47 @@ class Provisioning:
                                        self.server_ip, share_id))
     # SMB Share Methods End
 
+    # ACL Methods
+
+    def get_acl(self, share_id):
+        """
+        Retrieves the Access Control List (ACL) details for a given share ID.
+
+        :param share_id: The ID of the share for which to retrieve the ACL details.
+        :type share_id: str
+        :return: The response from the client's request to retrieve the ACL details.
+        :rtype: dict
+        """
+        LOG.info(f"Getting ACL details: '{share_id}'")
+        return self.client.request(
+            constants.POST,
+            constants.GET_ACL_DETAILS.format(self.server_ip, share_id),
+        )
+
+    def set_acl(self, share_id, add_aces=None, remove_aces=None):
+        """
+        Sets the access control list (ACL) for a given share.
+        Args:
+            share_id (str): The ID of the share.
+            add_aces (list, optional): A list of access control entries
+              (ACEs) to add to the ACL. Defaults to None.
+            remove_aces (list, optional): A list of access control entries
+              (ACEs) to remove from the ACL. Defaults to None.
+
+        Returns:
+            dict: The response from the server after setting the ACL.
+        """
+        payload = dict()
+        if add_aces:
+            payload["add_aces"] = add_aces
+        if remove_aces:
+            payload["remove_aces"] = remove_aces
+        return self.client.request(
+            constants.POST, constants.SET_ACL_DETAILS.format(
+                self.server_ip, share_id), payload=payload)
+
+    # ACL Methods End
+
     # FS Quota Methods
     def get_file_tree_quotas(self, filter_dict=None, all_pages=False):
         """Get a list of file tree quotas.

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PyPowerStore/utils/constants.py

@@ -22,8 +22,12 @@ OFFSET = 100
 # max number of items limit in a response
 MAX_LIMIT = 2000
 
-# Foot Hill Prime Plus Version
+# Platform Versions
+FOOTHILL_VERSION = '2.0.0.0'
+MALKA_VERSION = '2.1.0.0'
+FOOTHILL_PRIME_VERSION = '3.0.0.0'
 FOOTHILL_PRIME_PLUS_VERSION = '3.2.0.0'
+VICTORY_VERSION = '4.0.0.0'
 
 # Query params
 
@@ -64,6 +68,16 @@ FHP_VOLUME_DETAILS_QUERY = {
               "migration_session_id"
 }
 
+VICTORY_VOLUME_DETAILS_QUERY = {
+    "select": "id,name,description,type,wwn,nsid,nguid,appliance_id,state,"
+              "size,logical_used,node_affinity,creation_timestamp,"
+              "protection_policy_id,performance_policy_id,qos_performance_policy_id,"
+              "is_replication_destination,migration_session_id,metro_replication_session_id,"
+              "is_host_access_available,protection_data,location_history,"
+              "app_type,app_type_other,type_l10n,state_l10n,node_affinity_l10n,app_type_l10n,"
+              "volume_groups(name,id), protection_policy(name,id)"
+}
+
 # Host Query
 SELECT_ALL_HOST = {
     "select": "id,name,description,os_type,"
@@ -626,6 +640,10 @@ GET_SMB_SHARE_DETAILS_URL = 'https://{0}/api/rest/smb_share/{1}'
 MODIFY_SMB_SHARE_URL = GET_SMB_SHARE_DETAILS_URL
 DELETE_SMB_SHARE_URL = GET_SMB_SHARE_DETAILS_URL
 
+# SMB Share ACL endpoints
+GET_ACL_DETAILS = 'https://{0}/api/rest/smb_share/{1}/get_acl'
+SET_ACL_DETAILS = 'https://{0}/api/rest/smb_share/{1}/set_acl'
+
 # File Tree Quota endpoints
 GET_TREE_QUOTA_LIST_URL = 'https://{0}/api/rest/file_tree_quota'
 CREATE_TREE_QUOTA_URL = GET_TREE_QUOTA_LIST_URL

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PyPowerStore/utils/exception.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright: (c) 2019, Dell Technologies
+# Copyright: (c) 2024, Dell Technologies
 
 """PowerStore exceptions"""
 

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PyPowerStore/utils/helpers.py

@@ -1,9 +1,10 @@
 # -*- coding: utf-8 -*-
-# Copyright: (c) 2019, Dell Technologies
+# Copyright: (c) 2024, Dell Technologies
 
 """Helper module for PowerStore"""
 import logging
 from pkg_resources import parse_version
+from PyPowerStore.utils import constants
 
 provisioning_obj = None
 
@@ -52,10 +53,9 @@ def is_foot_hill_or_higher():
     :return: True if foot hill or higher
     :rtype: bool
     """
-    foot_hill_version = '2.0.0.0'
     array_version = provisioning_obj.get_array_version()
     if array_version and (
-            parse_version(array_version[0:7]) >= parse_version(foot_hill_version)):
+            parse_version(array_version[0:7]) >= parse_version(constants.FOOTHILL_VERSION)):
         return True
     return False
 
@@ -65,10 +65,9 @@ def 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)):
+            parse_version(array_version[0:7]) >= parse_version(constants.MALKA_VERSION)):
         return True
     return False
 
@@ -78,10 +77,21 @@ def is_foot_hill_prime_or_higher():
     :return: True if foothill prime or higher
     :rtype: bool
     """
-    foot_hill_prime_version = '3.0.0.0'
     array_version = provisioning_obj.get_array_version()
     if array_version and (
-            parse_version(array_version[0:7]) >= parse_version(foot_hill_prime_version)):
+            parse_version(array_version[0:7]) >= parse_version(constants.FOOTHILL_PRIME_VERSION)):
+        return True
+    return False
+
+def is_victory_or_higher():
+    """Returns true if the array version is victory or higher.
+
+    :return: True if victory or higher
+    :rtype: bool
+    """
+    array_version = provisioning_obj.get_array_version()
+    if array_version and (
+            parse_version(array_version[0:7]) >= parse_version(constants.VICTORY_VERSION)):
         return True
     return False
 

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/PyPowerStore.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: PyPowerStore
-Version: 3.1.0.0
+Version: 3.3.0.0
 Summary: Python Library for Dell PowerStore
 Home-page: https://github.com/dell/python-powerstore
 Author: Ansible Team at Dell

{PyPowerStore-3.1.0.0 → PyPowerStore-3.3.0.0}/setup.py

@@ -10,7 +10,7 @@ except ImportError:
 
 
 setup(name='PyPowerStore',
-      version='3.1.0.0',
+      version='3.3.0.0',
       description='Python Library for Dell PowerStore',
       author='Ansible Team at Dell',
       author_email='ansible.team@dell.com',