1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226
|
# coding: utf-8
# -------------------------------------------------------------------------
# Copyright (c) Microsoft Corporation. All rights reserved.
# Licensed under the MIT License. See License.txt in the project root for
# license information.
# --------------------------------------------------------------------------
import unittest
import pytest
from azure.core.exceptions import (
HttpResponseError,
ResourceNotFoundError,
ResourceExistsError)
from azure.storage.fileshare import (
ShareServiceClient,
ShareDirectoryClient,
ShareFileClient,
ShareClient
)
from devtools_testutils import ResourceGroupPreparer, StorageAccountPreparer
from _shared.testcase import (
StorageTestCase,
LogCaptured,
GlobalStorageAccountPreparer
)
# ------------------------------------------------------------------------------
TEST_SHARE_NAME = 'test'
TEST_SHARE_PREFIX = 'share'
# ------------------------------------------------------------------------------
class StorageHandleTest(StorageTestCase):
def _setup(self, storage_account, storage_account_key):
file_url = self.account_url(storage_account, "file")
credentials = storage_account_key
self.fsc = ShareServiceClient(account_url=file_url, credential=credentials)
self.test_shares = []
# --Helpers-----------------------------------------------------------------
def _get_share_reference(self, prefix=TEST_SHARE_PREFIX):
share_name = self.get_resource_name(prefix)
share = self.fsc.get_share_client(share_name)
self.test_shares.append(share)
return share
def _create_share(self, prefix=TEST_SHARE_PREFIX):
share_client = self._get_share_reference(prefix)
share = share_client.create_share()
return share_client
def _validate_handles(self, handles):
# Assert
self.assertIsNotNone(handles)
self.assertGreaterEqual(len(handles), 1)
self.assertIsNotNone(handles[0])
# verify basic fields
# path may or may not be present
# last_connect_time_string has been missing in the test
self.assertIsNotNone(handles[0].id)
self.assertIsNotNone(handles[0].file_id)
self.assertIsNotNone(handles[0].parent_id)
self.assertIsNotNone(handles[0].session_id)
self.assertIsNotNone(handles[0].client_ip)
self.assertIsNotNone(handles[0].open_time)
@GlobalStorageAccountPreparer()
def test_list_handles_on_share(self, resource_group, location, storage_account, storage_account_key):
# don't run live, since the test set up was highly manual
# only run when recording, or playing back in CI
if self.is_live:
pytest.skip("Cannot run in live without manual setup")
self._setup(storage_account, storage_account_key)
share = self.fsc.get_share_client(TEST_SHARE_NAME)
root = share.get_directory_client()
# Act
handles = list(root.list_handles(recursive=True))
# Assert
self._validate_handles(handles)
#
@GlobalStorageAccountPreparer()
def test_list_handles_on_share_snapshot(self, resource_group, location, storage_account, storage_account_key):
# don't run live, since the test set up was highly manual
# only run when recording, or playing back in CI
if self.is_live:
pytest.skip("Cannot run in live without manual setup")
self._setup(storage_account, storage_account_key)
share = self.fsc.get_share_client(TEST_SHARE_NAME, snapshot="2019-05-08T23:27:24.0000000Z")
root = share.get_directory_client()
# Act
handles = list(root.list_handles(recursive=True))
# Assert
self._validate_handles(handles)
@GlobalStorageAccountPreparer()
def test_list_handles_with_marker(self, resource_group, location, storage_account, storage_account_key):
# don't run live, since the test set up was highly manual
# only run when recording, or playing back in CI
if self.is_live:
pytest.skip("Cannot run in live without manual setup")
self._setup(storage_account, storage_account_key)
share = self.fsc.get_share_client(TEST_SHARE_NAME)
root = share.get_directory_client()
# Act
handle_generator = root.list_handles(recursive=True, results_per_page=1).by_page()
handles = list(next(handle_generator))
# Assert
self.assertIsNotNone(handle_generator.continuation_token)
self._validate_handles(handles)
# Note down a handle that we saw
old_handle = handles[0]
# Continue listing
remaining_handles = list(next(
root.list_handles(recursive=True).by_page(
continuation_token=handle_generator.continuation_token)
))
self._validate_handles(handles)
# Make sure the old handle did not appear
# In other words, the marker worked
old_handle_not_present = all([old_handle.id != handle.id for handle in remaining_handles])
self.assertTrue(old_handle_not_present)
@GlobalStorageAccountPreparer()
def test_list_handles_on_directory(self, resource_group, location, storage_account, storage_account_key):
# don't run live, since the test set up was highly manual
# only run when recording, or playing back in CI
if self.is_live:
pytest.skip("Cannot run in live without manual setup")
self._setup(storage_account, storage_account_key)
share = self.fsc.get_share_client(TEST_SHARE_NAME)
dir = share.get_directory_client('wut')
# Act
handles = list(dir.list_handles(recursive=True))
# Assert
self._validate_handles(handles)
# Act
handles = list(dir.list_handles(recursive=False))
# Assert recursive option is functioning when disabled
self.assertTrue(len(handles) == 0)
@GlobalStorageAccountPreparer()
def test_list_handles_on_file(self, resource_group, location, storage_account, storage_account_key):
# don't run live, since the test set up was highly manual
# only run when recording, or playing back in CI
if self.is_live:
pytest.skip("Cannot run in live without manual setup")
self._setup(storage_account, storage_account_key)
share = self.fsc.get_share_client(TEST_SHARE_NAME)
client = share.get_file_client('wut/bla.txt')
# Act
handles = list(client.list_handles())
# Assert
self._validate_handles(handles)
@GlobalStorageAccountPreparer()
def test_close_single_handle(self, resource_group, location, storage_account, storage_account_key):
# don't run live, since the test set up was highly manual
# only run when recording, or playing back in CI
if self.is_live:
pytest.skip("Cannot run in live without manual setup")
self._setup(storage_account, storage_account_key)
share = self.fsc.get_share_client(TEST_SHARE_NAME)
root = share.get_directory_client()
handles = list(root.list_handles(recursive=True))
self._validate_handles(handles)
# Act
with self.assertRaises(ValueError):
root.close_handle('*')
handles_info = root.close_handle(handles[0])
# Assert 1 handle has been closed
self.assertEqual(1, handles_info['closed_handles_count'])
self.assertEqual(handles_info['failed_handles_count'], 0)
@GlobalStorageAccountPreparer()
def test_close_all_handle(self, resource_group, location, storage_account, storage_account_key):
# don't run live, since the test set up was highly manual
# only run when recording, or playing back in CI
if self.is_live:
pytest.skip("Cannot run in live without manual setup")
self._setup(storage_account, storage_account_key)
share = self.fsc.get_share_client(TEST_SHARE_NAME)
root = share.get_directory_client()
handles = list(root.list_handles(recursive=True))
self._validate_handles(handles)
# Act
handles_info = root.close_all_handles(recursive=True)
# Assert at least 1 handle has been closed
self.assertTrue(handles_info['closed_handles_count'] > 1)
self.assertEqual(handles_info['failed_handles_count'], 0)
# ------------------------------------------------------------------------------
if __name__ == '__main__':
unittest.main()
|