Corkus Exceptions

Exceptions hierarchy:

• CorkusException

  • InvalidInputError

  • HTTPError

    • WynncraftServerError

    • RatelimitExceeded

    • BadRequest

  • CorkusTimeoutError

exception corkus.errors.CorkusException

Bases: Exception

Base exception class for Corkus.py

Ideally speaking, this could be caught to handle any exceptions thrown from this library.

add_note()

Exception.add_note(note) – add a note to the exception

exception corkus.errors.InvalidInputError

Bases: CorkusException

Exception that’s thrown when you call a corkus function with invalid arguments. Corkus verified that argument isn’t valid before sending request.

add_note()

Exception.add_note(note) – add a note to the exception

exception corkus.errors.CorkusTimeoutError

Bases: CorkusException

Exception that’s thrown when a request timeouts.

property timeout

Configured timeout.

Return type:

int

property url

URL for which timeout happened.

Return type:

int

add_note()

Exception.add_note(note) – add a note to the exception

exception corkus.errors.HTTPError

Bases: CorkusException

Exception that’s thrown when an HTTP request operation fails.

property response

Failed response returned by AIOHTTP.

Return type:

ClientResponse

add_note()

Exception.add_note(note) – add a note to the exception

exception corkus.errors.WynncraftServerError

Bases: HTTPError

Exception that’s thrown for when a 500 range status code occurs.

This error indicates an unexpected error prevent the server from processing the request. If the error continues occurring for the same request it should be reported on the Wynncraft API issue tracker; or if you believe the error is exploitable, or directly to Colin (Colin#0670 on discord, colin350 on the forums) if the issue is exploitable/poses a risk to the stability of the API.

add_note()

Exception.add_note(note) – add a note to the exception

property response

Failed response returned by AIOHTTP.

Return type:

ClientResponse

exception corkus.errors.RatelimitExceeded

Bases: HTTPError

Exception that’s thrown for when a 429 status code occurs.

Warning

This exception shouldn’t be thrown when using Corkus normally. If you see that error it’s most likely because you disabled Rate limit. If you are sure that rate limit is enabled please create a bug repport

Danger

IPs that repeatedly exceed the rate limit could be blacklisted.

add_note()

Exception.add_note(note) – add a note to the exception

property response

Failed response returned by AIOHTTP.

Return type:

ClientResponse

exception corkus.errors.BadRequest

Bases: HTTPError

Exception that’s thrown for when a 400 status code occurs.

Indicates that a parameter given by the client was in an incorrect format, or that the requested resource doesn’t exist. This client should not immediately request this resource again without changes.

add_note()

Exception.add_note(note) – add a note to the exception

property response

Failed response returned by AIOHTTP.

Return type:

ClientResponse