plover-run-py 0.0.1

Command plugin for Plover to run an arbitrary Python command.

plover-run-py

Command plugin for Plover to run an arbitrary Python command.

See also:

• plover-run-shell plugin for running a shell command.
• plover-debugging-console plugin for running Python commands in Plover in a shell (more convenient for debugging and showing results).
• plover-retro-stringop plugin for running Python commands to transform/modify the previous text using arbitrary Python expression.

Usage

In order to use this plugin in Plover you need to create a dictionary entry of the form:

{
    "example_stroke": "{PLOVER:PY:command}"
}

Variables engine and plover are provided.

Remember to escape the characters in \{} according to Plover's dictionary format.

Alternatively, if the definition has the form "{PLOVER:PY_F:path}", the content of the file at the given path will be run as Python code.

Note: If the command takes a long time to finish, Plover might freeze.

Example

Refer to the API reference (1, 2) (unofficial, community-maintained) for more details.

• Sleep between key presses: {#a}{plover:py:import time; time.sleep(1)}{#b}

• Toggle a plugin and show a warning notification on the status: (broken into multiple lines for readability)

  {plover:py:
  engine["enabled_extensions"]^=\{'ibus'\};
  plover.log.warning('ibus enabled=' + str('ibus' in engine["enabled_extensions"]))
  }