Description
The Controller().type() function is very useful to easily type out long strings.
However, some web interfaces are too slow to capture the key presses because the key is released directly after being pressed [1]. I will be using duration to refer to the time a key is pressed and delay to refer to the time between two consecutive keys being pressed.
There is already a pull request to add a delay between key presses in #579 , but it does not include duration. As mentioned in [2], the xdotool utility provides the --delay option to set how long the key press should last [3][4], but the time is apparently split 50-50 between duration and delay.
I would propose to add both parameters to Controller().type() as described in [2], but keep the current default of no duration or delay by default.
def type(self, string, duration=0.0, delay=0.0):
"""Types a string.
This method will send all key presses and releases necessary to type
all characters in the string.
:param str string: The string to type.
:param duration float: Key press duration in seconds.
:param delay float: Time between two key presses in seconds.
:raises InvalidCharacterException: if an untypable character is
encountered
"""
from . import _CONTROL_CODES
from time import sleep
for i, character in enumerate(string):
key = _CONTROL_CODES.get(character, character)
try:
self.press(key)
if duration > 0.0: # prevent context switch if duration is 0
sleep(duration)
self.release(key)
if delay > 0.0:
sleep(delay)
except (ValueError, self.InvalidKeyException):
raise self.InvalidCharacterException(i, character)
Description The
Controller().type()
function is very useful to easily type out long strings. However, some web interfaces are too slow to capture the key presses because the key is released directly after being pressed [1]. I will be usingduration
to refer to the time a key is pressed anddelay
to refer to the time between two consecutive keys being pressed.There is already a pull request to add a
delay
between key presses in #579 , but it does not includeduration
. As mentioned in [2], thexdotool
utility provides the--delay
option to set how long the key press should last [3][4], but the time is apparently split 50-50 betweenduration
anddelay
.I would propose to add both parameters to
Controller().type()
as described in [2], but keep the current default of noduration
ordelay
by default.[1] https://github.com/moses-palmer/pynput/blob/6d01a92d2e4ef10be57af6ef7ce720f04f8b5652/lib/pynput/keyboard/_base.py#L488C1-L492C34 [2] https://github.com/Evidlo/passhole/pull/64 [3] https://askubuntu.com/questions/1098762/does-xdotool-key-delay-pause-for-specified-delay-between-typing-every-two-co [4] https://github.com/jordansissel/xdotool/issues/423