def __init__(self, path, creds=None):
"""
Returns a new `UncDirectory` class.
`path` must be a UNC directory path. If `path` cannot be construed as a valid UNC path,
this will raise an `InvalidUncPathError`.
`creds` may be `None` or a `UncCrednetials` object. If `None`, then the UNC directory
must not require authentication to be connected. Otherwise, `creds` will be used
for authentication.
If only the first positional argument is provided and it is already an instance of the
`UncDirectory` class (either directly or by inheritance), this constructor will clone
it and create a new `UncDirectory` object with the same properties. Note that the clone
is a "shallow" clone. Both the original `UncDirectory` object and its clone will use the
same `UncCredentials` object if it was provided.
"""
if creds is None and isinstance(path, UncDirectory):
new_path = path._path
new_creds = path._creds
else:
new_path = path
new_creds = creds
cleaned_path = clean_unc_path(new_path)
if is_valid_unc_path(cleaned_path):
self._path = cleaned_path
self._creds = new_creds if new_creds and not new_creds.is_empty(
) else None
else:
raise InvalidUncPathError(new_path)
def __init__(self, path, creds=None):
"""
Returns a new `UncDirectory` class.
`path` must be a UNC directory path. If `path` cannot be construed as a valid UNC path,
this will raise an `InvalidUncPathError`.
`creds` may be `None` or a `UncCrednetials` object. If `None`, then the UNC directory
must not require authentication to be connected. Otherwise, `creds` will be used
for authentication.
If only the first positional argument is provided and it is already an instance of the
`UncDirectory` class (either directly or by inheritance), this constructor will clone
it and create a new `UncDirectory` object with the same properties. Note that the clone
is a "shallow" clone. Both the original `UncDirectory` object and its clone will use the
same `UncCredentials` object if it was provided.
"""
if creds is None and isinstance(path, UncDirectory):
new_path = path._path
new_creds = path._creds
else:
new_path = path
new_creds = creds
cleaned_path = clean_unc_path(new_path)
if is_valid_unc_path(cleaned_path):
self._path = cleaned_path
self._creds = new_creds if new_creds and not new_creds.is_empty() else None
else:
raise InvalidUncPathError(new_path)
def is_unc_directory_string(string):
"""
Returns `True` when `string` represents a `UncDirectory` as defined by `UncDirectory`'s
`get_auth_path` method or `False` otherwise.
"""
cleaned_string = clean_unc_path(string)
return (is_valid_unc_path(cleaned_string)
or ('@\\\\' in cleaned_string
and len(cleaned_string.partition('@\\\\')[2]) > 0))
def is_unc_directory_string(string):
"""
Returns `True` when `string` represents a `UncDirectory` as defined by `UncDirectory`'s
`get_auth_path` method or `False` otherwise.
"""
cleaned_string = clean_unc_path(string)
return (is_valid_unc_path(cleaned_string)
or ('@\\\\' in cleaned_string
and len(cleaned_string.partition('@\\\\')[2]) > 0))
def test_clean_unc_path(self):
self.assertEqual(C.clean_unc_path(r'\\path'), r'\\path')
self.assertEqual(C.clean_unc_path(r'\\path\B'), r'\\path\B')
self.assertEqual(C.clean_unc_path(r'\\path\IPC$'), r'\\path\IPC$')
self.assertEqual(C.clean_unc_path(r'\\path\\'), r'\\path')
self.assertEqual(C.clean_unc_path(r' \\path'), r'\\path')
self.assertEqual(C.clean_unc_path(r'\\path '), r'\\path')
self.assertEqual(C.clean_unc_path(r' \\path '), r'\\path')
