A IPython debugging console for Plover.
Project description
plover-debugging-console
A IPython debugging console for Plover.
See also:
plover-run-py
plugin for executing a Python command with a stroke, or from the command-line.
Usage
- Install the plugin.
- Enable the extension plugin in Plover.
- Run the command
plover-debugging-console-connect
(orplover -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.
- https://github.com/albertz/background-zmq-ipython/issues/13
- https://github.com/user202729/plover-debugging-console/issues/1#issuecomment-1003654835
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 ofplover-run-shell
repository)
Implementation details
- The kernel can be connected to manually with
ipython console --existing <file>
orjupyter console --existing <file>
. - The IPython/Jupyter connection file path is stored in
connection_path_container
, which isplover_debugging_console_path
in the temp folder in the current version. background_zmq_ipython
package is used, which requiresjupyter
- Regarding
PAGER
,GIT_PAGER
,TERM
,CLICOLOR
environment variables being set: Either- unset/reset them manually, or
- update to a sufficiently new version of package
background-zmq-ipython
, at least commit 14d862848b7f5692412093642181718c29f57cad. (version currently not on PyPI)
- See https://stackoverflow.com/a/68769973/5267751 for the method used in
plover-debugging-console-execute
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for plover-debugging-console-0.2.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 79838313aaf8ed83a1bffed308b6570671097d916a2dd38b84a4978e49874440 |
|
MD5 | c3a08388fffb2b83d9365bc3775d2530 |
|
BLAKE2b-256 | da4f5cd223625a02bbc14914b66528a27c6455981c8fc7807beaa8207f604f24 |
Hashes for plover_debugging_console-0.2.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0dba3fefa805bc7e31de87e5ee0f79b850a7375c706628670da239afb136188b |
|
MD5 | a878c061b2fa8df4339bb8bf46af78e6 |
|
BLAKE2b-256 | 42de4e26ae317cec3b34c77f46caac83da0f80d034fb0acf32076d4cca7df38a |