Logging
=======
pshell uses :mod:`logging` to record all commands to the stderr or log file.
By default, it uses the **pshell** logger; it can however be set to use an alternative,
possibly context-local, logger.


Setting and retrieving the pshell logger
----------------------------------------
.. autofunction:: pshell.set_global_logger

.. autodata:: pshell.context_logger

:class:`~contextvars.ContextVar`. Context-local logger, for use in multithreaded and
asynchronous code. On Python 3.14t and later free-threading nterpreters, this is
inherited when creating a new thread; on most other interpreters, it's not; see
:attr:`sys.flags.thread_inherit_context`. See :mod:`contextvars` for more information on
how context variables propagate.

Set to None to use the global logger instead.

.. autofunction:: pshell.get_logger

Using the pshell logger
-----------------------
.. autofunction:: pshell.log.debug
.. autofunction:: pshell.log.info
.. autofunction:: pshell.log.warning
.. autofunction:: pshell.log.error
.. autofunction:: pshell.log.critical
.. autofunction:: pshell.log.inc_stacklevel