:children_crossing::sparkles: add debug mode

[lstuma]

:bug: debug mode:

• exceptions in code do not crash web application
• exception stack traces are displayed in browser
• when saving a module used in web application restart web application or reload module somehow to allow for testing and debugging without having to restart entire server

🖳 non-debug mode:

• exceptions in code crash web application

@raspitim please share your thoughts on this :)

[lstuma]

i'm pretty sure all of the features described above are relatively easy to implement apart from the reloading modules one idk how i'm gonna do that but all of the other's i can do for sure once i get the time

[raspitim]

I am not sure about the crashing application thing. I think app exceptions should still be caught and a plain status 500 response should be returned.

[lstuma]

@raspitim Hm i think adding an option crash_on_failure in the app settings could be the way to go but yeah i think i agree

[lstuma]

aight so i think the exception handling i'll implement as the following:

• when exceptions occur before pigeon has started, then pigeon will not start, since this means the exception occured while importing modules etc. and should most definitely be fixed before running the application. adding to that, if we were to start the server anyways, developers would likely overlook the errors in the log and wonder as to why their views aren't being detected by the framework, even though this is just happening due to errors in their code (this happened to me :disappointed: )
• when exceptions occur while pigeon is running, they'll be ignored by default and just printed to the log, however, if CRASH_ON_FAILURE is set to True the application will also terminate
• when debug mode is on, the default error page will be overwritten and it will display the exception as well as stack trace

to realise this in code i'll do the following:

• add a _handleexception function to the Pigeon class that will work as a custom exception handler :)

@raspitim what do you think?

[lstuma]

current progress

[lstuma]

aight debug mode is implemented @raspitim

[lstuma]

reopening this issue since 1 feature hasn't been implemented yet:

• when saving a module used in web application restart web application or reload module somehow to allow for testing and debugging without having to restart entire server

[lstuma]

fixed (closing issue):

• ✨ automatic reload in debug mode (for the most part) works!

[lstuma]

it is a little bit aggressive though so we may need to come back to it at a later point in time @raspitim