HOWTO · Python
Simuler les entrées au clavier en Python
Apprenez à simuler les entrées au clavier en Python.
Sur cette page
Utilisez le package keyboard ou PyAutoGUI pour saisir du texte depuis un script Python. Le premier fournit write() pour le texte et press_and_release() pour les événements clavier. PyAutoGUI fournit write(), keyDown(), keyUp() et press() pour le texte et les événements de touche individuels. Installez la bibliothèque de votre choix avec pip install keyboard ou pip install pyautogui.
Les deux bibliothèques envoient les entrées au champ qui a le focus ; aucun des exemples ne sélectionne une application ou un champ. Préparez d’abord la cible et évitez de saisir des informations sensibles dans une fenêtre inattendue. Le texte simulé apparaît dans l’application cible, et non dans le terminal. L’exemple suivant, qui utilise la bibliothèque standard, affiche un plan des actions présentées ci-dessous ; il n’envoie pas d’événements keyboard.
Un texte et un événement clavier sont deux types d’entrée différents. Utilisez un appel de saisie de texte pour les mots et la ponctuation ordinaires, et un appel d’événement clavier lorsque la cible doit recevoir une touche nommée comme Entrée ou une combinaison de modificateurs. Préparez la cible avant de lancer un script et, pour adapter une séquence, utilisez un champ de test sans risque. Le plan de l’exemple précise l’ordre des actions : le texte d’abord, puis Entrée, ensuite un événement avec modificateur, et enfin les lettres restantes. Réorganisez ou supprimez des actions selon le formulaire ou l’éditeur que vous comptez utiliser.
Exécutez cet exemple :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
text = "Python is an amazing programming language."
actions = [("type", text), ("press", "enter"), ("press", "shift+p"), ("type", "ython")]
for action, value in actions:
print(f"{action}: {value}")
type: Python is an amazing programming language.
press: enter
press: shift+p
type: ython
Simuler une saisie au clavier avec la bibliothèque keyboard
Installez le package avec pip install keyboard. Pour saisir une phrase, appuyer sur Entrée, puis écrire Python en maintenant Maj pour sa première lettre, la séquence propre au package est keyboard.write("Python is an amazing programming language."), keyboard.press_and_release("enter"), keyboard.press_and_release("shift+p") et keyboard.write("ython"), dans cet ordre. Ces appels nécessitent que le package soit installé et qu’un champ de texte interactif ait le focus ; ce sont donc des instructions d’utilisation de l’API, et non un exemple exécuté. Placez délibérément le curseur avant de les lancer. La cible reçoit la phrase, puis un saut de ligne produit par Entrée, et Python sur la ligne suivante. write() reçoit le texte à saisir, tandis que press_and_release() envoie une touche nommée ou une combinaison, puis la relâche. Ici, shift+p saisit la première lettre majuscule de Python. Ces appels ne choisissent pas de fenêtre et ne déplacent pas le curseur. Appuyer sur Entrée peut envoyer un formulaire ou activer un contrôle ; omettez donc cet appel si la cible ne doit pas recevoir Entrée. Si vous avez uniquement besoin de saisir du texte, les appels write() suffisent. Consultez la documentation de keyboard pour en savoir plus sur l’API.
Simuler une saisie au clavier avec PyAutoGUI
Installez PyAutoGUI avec pip install pyautogui. Pour saisir la phrase, maintenez Maj en appuyant sur a, b et c, puis saisissez xyz en minuscules ; la séquence d’appels propre au package est pyautogui.write("Python is an amazing programming language."), pyautogui.keyDown("shift"), pyautogui.press("a"), pyautogui.press("b"), pyautogui.press("c"), pyautogui.keyUp("shift") et pyautogui.write("xyz"), dans cet ordre. Ces appels nécessitent que le package soit installé et qu’une cible de texte interactive soit disponible ; ce sont donc des instructions d’utilisation de l’API, et non un exemple exécuté. Donnez délibérément le focus à un champ de texte avant de les lancer. La cible reçoit Python is an amazing programming language.ABCxyz : keyDown("shift") maintient Maj pendant les trois appels individuels press(), qui produisent donc des lettres majuscules, et keyUp("shift") relâche la touche avant la saisie de xyz. write() saisit la chaîne fournie. keyDown() maintient une touche enfoncée jusqu’à ce que keyUp() la relâche. press() envoie un événement d’appui puis de relâchement pour une touche individuelle, par exemple une lettre. Pour maintenir un modificateur pendant plusieurs frappes, encadrez ces appels avec keyDown() et keyUp() au lieu de traiter press() comme une fonction arbitraire de combinaison de touches. Si vous avez uniquement besoin de saisir du texte, write() suffit ; conservez la séquence d’événements clavier si vous avez besoin du comportement avec modificateur. Consultez la documentation de PyAutoGUI pour en savoir plus.
Lorsque vous modifiez la séquence, gardez keyDown() et keyUp() appariés autour des seules frappes qui nécessitent le modificateur. Les appels placés après keyUp() s’exécutent sans ce modificateur maintenu. Pour saisir une simple phrase, supprimez tous les appels d’événements clavier. Le script reste ainsi centré sur la saisie du texte, et il est plus facile de repérer l’opération qui a produit un caractère inattendu.