Exceptions
JuliaHub.jl is designed in a way that the only errors it should throw under normal circumstances are subtypes of JuliaHubException
(in addition to standard ArgumentError
s and MethodError
s etc. from invalid function calls). Any unhandled errors from JuliaHub.jl or its dependencies should be considered a bug.
You can also enable debug logging for JuliaHub
, which will make JuliaHub.jl print out additional debug messages, by setting the JULIA_DEBUG
environment variable:
ENV["JULIA_DEBUG"]="JuliaHub"
JuliaHub.JuliaHubException
— Typeabstract type JuliaHubException <: Exception
Abstract supertype of all JuliaHub.jl exception types.
JuliaHub.AuthenticationError
— Typestruct AuthenticationError <: JuliaHubException
Exception thrown if the authentication fails. The .msg
fields contains a human-readable error message.
JuliaHub.InvalidAuthentication
— Typestruct InvalidAuthentication <: JuliaHubException
This exception is thrown if the authentication token is invalid or has expired. Re-authenticating with JuliaHub.authenticate
should generally be sufficient to resolve the issue.
JuliaHub.InvalidRequestError
— Typestruct InvalidRequestError <: JuliaHubException
An exception thrown if the request was rejected by the backend due to request parameters that are inconsistent with the backend state. The .msg
field contains the error message.
JuliaHub.JuliaHubConnectionError
— Typestruct JuliaHubConnectionError <: JuliaHubException
An exception thrown if there is a communication error with JuliaHub.
The .msg
field contains the error message. If there is an underlying exception, it is stored in the .exception
field.
JuliaHub.JuliaHubError
— Typestruct JuliaHubError <: JuliaHubException
An exception thrown if there is an unexpected response from or backend failure in JuliaHub.
The .msg
field contains the error message. If there is an underlying exception, it is stored in the .exception
field.
JuliaHub.PermissionError
— Typestruct PermissionError <: JuliaHubException
Thrown if the currently authenticated user does not have the necessary permissions to perform the operation. The .msg
field contains the error message, and .response
may contain the raw server response.