plover-debugging-console
A IPython debugging console for Plover.
See also:
Usage
- Install the plugin.
- Enable the extension plugin in Plover.
- Run the command
plover-debugging-console-connect
(or plover -s plover-debugging-console-connect
)
in a terminal.
The global variable engine
is given. Other objects can be accessed from engine
as public
or private members.
Alternatively, plover-debugging-console-connect qtconsole
can be used to launch a console-style application using Qt.
See documentation of jupyter qtconsole
for more details.
Or plover-debugging-console-execute
can be used to execute a file non-interactively. See note below.
Known issues
Those errors can be fixed by installing the latest version of background_zmq_ipython
manually on GitHub. Refer to
https://github.com/openstenoproject/plover/wiki/Manually-Installing-Plugins for instruction.
Note
-
Once started, the kernel is not stopped until Plover exits.
-
The session (kernel, global variables) are persistent, and shared between consoles.
However, plover-debugging-console-execute <file>
uses a separate environment, see
documentation of %run
IPython magic command.
-
Any print
commands are printed on Plover's console, not IPython's console.
-
Error messages might be hidden (if plover-debugging-console-execute
is used),
or displayed in a different console.
To view the error messages, open an interactive console.
-
On some operating systems, the plugin may set PAGER
environment variable. (see issue #2 of plover-run-shell
repository)
Implementation details
- The kernel can be connected to manually with
ipython console --existing <file>
or jupyter console --existing <file>
. - The IPython/Jupyter connection file path is stored in
connection_path_container
, which is
plover_debugging_console_path
in the temp folder in the current version. background_zmq_ipython
package is used, which requires jupyter
- Regarding
PAGER
, GIT_PAGER
, TERM
, CLICOLOR
environment variables being set: Either
- See https://stackoverflow.com/a/68769973/5267751 for the method used in
plover-debugging-console-execute
.