Exceptions

gd.py has stable exception system, which leads better understanding of errors. Below is a list of current existing exceptions.

Exception List

exception gd.GDException

Base exception class for gd.py. This could be caught to handle any exceptions thrown from this library.

exception gd.ClientException

Base exception class for errors that are thrown when operation in Client fails.

exception gd.EditorError

Exception that is raised when converting string to api.Object or api.Editor failed.

exception gd.HTTPError(exc: Exception)

Exception that is raised when exception in utils.http.HTTPClient occurs.

exception gd.MissingAccess(message: Optional[str] = None)

Exception that is raised when server responses with -1.

exception gd.SongRestrictedForUsage(id: int)

Exception that is raised when server returns -2 when looking for a song.

exception gd.LoginFailure(login: str, password: str)

Exception that is raised when server returns -1 when trying to log in.

login

Username that was wrong or password did not match.

password

Password that login was failed with.

exception gd.NothingFound(cls_name: str)

Exception that is raised when server returns nothing that can be converted to object of name cls_name.

exception gd.NotLoggedError(func_name: Optional[str])

Exception that is raised when a function that requires logged in user is called while Client is not logged.

Exception Hierarchy

GDException (Exception)
    EditorError
    ClientException
        HTTPError
        MissingAccess
        SongRestrictedForUsage
        LoginFailure
        NothingFound
        NotLoggedError