Description
Background
At the moment it is difficult to jump right into a PyScript project and understand what the behavior of some things will be. For example, if I use print
or the the logging module without any configuration, it would be helpful to know where the print
statements will end up writing. With some context it is clear that the behaviour can differ depending on if the terminal
is active.
Problem
The documentation does not explain basic I/O behaviors of common outputs like logging
or print
. A developer may expect anything printed
to go to the web console. It's only through testing that they find out that the if you write to stderr
or submit a logger.error
message via the Python Logging library that you will observe that a div will be added to the document of class py-error
, and if you want to disable or overwrite this behaviour you need to refer to the error
plugin (see #156).
Proposal
Create a section that explains how Python IO and logging maps into the web console and other features, like the error
plugin.