HOWTO · Python
Simular entradas de teclado en Python
Aprenda a simular entradas de teclado en Python.
En esta página
Usa el paquete keyboard o PyAutoGUI para escribir texto desde un script de Python. El primero ofrece write() para escribir texto y press_and_release() para enviar eventos de teclas. PyAutoGUI ofrece write(), keyDown(), keyUp() y press() para escribir texto y enviar eventos de teclas individuales. Instala la biblioteca que prefieras con pip install keyboard o pip install pyautogui.
Ambas bibliotecas envían la entrada al campo que tenga el foco en ese momento; ninguno de los ejemplos selecciona una aplicación ni un campo. Prepara primero el destino y evita escribir información confidencial en una ventana equivocada. El texto simulado aparece en la aplicación de destino, no en la terminal. El siguiente ejemplo con la biblioteca estándar imprime un plan de las acciones que se usan más adelante; no envía eventos de keyboard.
Una cadena de texto y un evento de tecla son tipos de entrada distintos. Usa una llamada para escribir texto corriente y signos de puntuación, y una llamada de evento de tecla cuando el destino deba recibir una tecla con nombre, como Enter, o una combinación de modificadores. Deja listo el destino antes de iniciar el script y, al adaptar una secuencia, prueba primero con un campo inocuo. El plan de ejemplo deja claro el orden: primero el texto, luego Enter y después un evento de tecla con modificador, seguido de las letras restantes. Reordena o elimina acciones para adaptarlas al formulario o editor que vayas a usar.
Ejecuta este ejemplo:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
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
Simular la entrada de teclado con la biblioteca keyboard
Instala el paquete con pip install keyboard. Para escribir una oración, pulsar Enter y luego escribir Python manteniendo Shift para su primera letra, la secuencia específica del paquete es keyboard.write("Python is an amazing programming language."), keyboard.press_and_release("enter"), keyboard.press_and_release("shift+p") y keyboard.write("ython"), en ese orden. Estas llamadas requieren que el paquete esté instalado y que haya un campo de texto interactivo enfocado, así que son instrucciones de uso de la API, no un ejemplo ejecutado. Coloca el cursor deliberadamente antes de ejecutarlas. El texto de destino será la oración, seguido de un salto de línea producido por Enter y Python en la línea siguiente. write() acepta el texto que se escribirá, mientras que press_and_release() envía una tecla con nombre o una combinación y la suelta. En este caso, shift+p escribe en mayúscula la primera letra de Python. Estas llamadas no seleccionan una ventana ni mueven el cursor. Pulsar Enter puede enviar un formulario o activar un control, así que omite esa llamada si el destino no debe recibir Enter. Si solo necesitas escribir texto, bastan las llamadas a write(). Consulta la documentación de keyboard para conocer los detalles de la API.
Simular la entrada de teclado con PyAutoGUI
Instala PyAutoGUI con pip install pyautogui. Para escribir la oración, mantener Shift mientras se pulsan a, b y c, y luego escribir xyz en minúsculas, la secuencia específica del paquete es pyautogui.write("Python is an amazing programming language."), pyautogui.keyDown("shift"), pyautogui.press("a"), pyautogui.press("b"), pyautogui.press("c"), pyautogui.keyUp("shift") y pyautogui.write("xyz"), en ese orden. Estas llamadas requieren que el paquete esté instalado y que haya un destino de texto interactivo, así que son instrucciones de uso de la API, no un ejemplo ejecutado. Enfoca deliberadamente un campo de texto antes de ejecutarlas. El destino recibe Python is an amazing programming language.ABCxyz: keyDown("shift") mantiene Shift pulsada durante las tres llamadas individuales de press(), por lo que esas letras quedan en mayúscula, y keyUp("shift") la suelta antes de escribir xyz. write() escribe la cadena indicada. keyDown() mantiene una tecla pulsada hasta que keyUp() la suelta. press() envía un evento de pulsación y liberación para una tecla individual, como una letra. Para mantener un modificador pulsado durante varias pulsaciones, coloca keyDown() y keyUp() alrededor de esas llamadas, en vez de tratar press() como una función para cualquier combinación de teclas. Si solo necesitas escribir texto, basta con write(); conserva la secuencia de eventos de teclas cuando necesites el comportamiento del modificador. Consulta la documentación de PyAutoGUI para obtener más detalles.
Al cambiar la secuencia, mantén keyDown() y keyUp() emparejadas alrededor únicamente de las pulsaciones que necesiten el modificador. Las llamadas posteriores a keyUp() se ejecutan sin ese modificador pulsado. Para escribir una oración sencilla, elimina por completo las llamadas de eventos de teclas. Así el script se centra en escribir texto y resulta más fácil identificar qué operación produjo un carácter inesperado.