cloudpathlib.exceptions

This module contains all custom exceptions in the cloudpathlib library. All exceptions subclass the CloudPathException base exception to facilitate catching any exception from this library.

Classes

AnyPathTypeError

Bases: CloudPathException, TypeError

Source code in cloudpathlib/exceptions.py

class AnyPathTypeError(CloudPathException, TypeError):
    pass

ClientMismatchError

Bases: CloudPathException, ValueError

Source code in cloudpathlib/exceptions.py

class ClientMismatchError(CloudPathException, ValueError):
    pass

CloudPathException

Bases: Exception

Base exception for all cloudpathlib custom exceptions.

Source code in cloudpathlib/exceptions.py

class CloudPathException(Exception):
    """Base exception for all cloudpathlib custom exceptions."""

CloudPathFileExistsError

Bases: CloudPathException, FileExistsError

Source code in cloudpathlib/exceptions.py

class CloudPathFileExistsError(CloudPathException, FileExistsError):
    pass

CloudPathFileNotFoundError

Bases: CloudPathException, FileNotFoundError

Source code in cloudpathlib/exceptions.py

class CloudPathFileNotFoundError(CloudPathException, FileNotFoundError):
    pass

CloudPathIsADirectoryError

Bases: CloudPathException, IsADirectoryError

Source code in cloudpathlib/exceptions.py

class CloudPathIsADirectoryError(CloudPathException, IsADirectoryError):
    pass

CloudPathLocalPathTraversalError

Bases: CloudPathException, ValueError

Raised when a cloud object key contains .. (parent-directory) segments that would map the cloud path to a local path outside its intended base directory — i.e. outside the local cache directory or the download destination. Blocked to prevent path traversal.

Source code in cloudpathlib/exceptions.py

class CloudPathLocalPathTraversalError(CloudPathException, ValueError):
    """Raised when a cloud object key contains ``..`` (parent-directory) segments that would map
    the cloud path to a local path outside its intended base directory — i.e. outside the local
    cache directory or the download destination. Blocked to prevent path traversal."""

CloudPathNotADirectoryError

Bases: CloudPathException, NotADirectoryError

Source code in cloudpathlib/exceptions.py

class CloudPathNotADirectoryError(CloudPathException, NotADirectoryError):
    pass

CloudPathNotExistsError

Bases: CloudPathException

Source code in cloudpathlib/exceptions.py

class CloudPathNotExistsError(CloudPathException):
    pass

CloudPathNotImplementedError

Bases: CloudPathException, NotImplementedError

Source code in cloudpathlib/exceptions.py

class CloudPathNotImplementedError(CloudPathException, NotImplementedError):
    pass

DirectoryNotEmptyError

Bases: CloudPathException

Source code in cloudpathlib/exceptions.py

class DirectoryNotEmptyError(CloudPathException):
    pass

IncompleteImplementationError

Bases: CloudPathException, NotImplementedError

Source code in cloudpathlib/exceptions.py

class IncompleteImplementationError(CloudPathException, NotImplementedError):
    pass

InvalidConfigurationException

Bases: CloudPathException, ValueError

Source code in cloudpathlib/exceptions.py

class InvalidConfigurationException(CloudPathException, ValueError):
    pass

InvalidGlobArgumentsError

Bases: CloudPathException

Source code in cloudpathlib/exceptions.py

class InvalidGlobArgumentsError(CloudPathException):
    pass

InvalidPrefixError

Bases: CloudPathException, ValueError

Source code in cloudpathlib/exceptions.py

class InvalidPrefixError(CloudPathException, ValueError):
    pass

MissingCredentialsError

Bases: CloudPathException

Source code in cloudpathlib/exceptions.py

class MissingCredentialsError(CloudPathException):
    pass

MissingDependenciesError

Bases: CloudPathException, ModuleNotFoundError

Source code in cloudpathlib/exceptions.py

class MissingDependenciesError(CloudPathException, ModuleNotFoundError):
    pass

NoStatError

Bases: CloudPathException

Used if stats cannot be retrieved; e.g., file does not exist or for some backends path is a directory (which doesn't have stats available).

Source code in cloudpathlib/exceptions.py

class NoStatError(CloudPathException):
    """Used if stats cannot be retrieved; e.g., file does not exist
    or for some backends path is a directory (which doesn't have
    stats available).
    """

OverwriteDirtyFileError

Bases: CloudPathException

Source code in cloudpathlib/exceptions.py

class OverwriteDirtyFileError(CloudPathException):
    pass

OverwriteNewerCloudError

Bases: CloudPathException

Source code in cloudpathlib/exceptions.py

class OverwriteNewerCloudError(CloudPathException):
    pass

OverwriteNewerLocalError

Bases: CloudPathException

Source code in cloudpathlib/exceptions.py

class OverwriteNewerLocalError(CloudPathException):
    pass