From 84e9c0be3e83f45b721b70f8041db607247ebe97 Mon Sep 17 00:00:00 2001
From: Pedro de Oliveira Guedes <pedro.guedes@digitalcircle.com.br>
Date: Thu, 30 Dec 2021 13:23:33 -0300
Subject: [PATCH] KB methods improvements.

---
 api/wingui/cli.py | 60 +++++++++++++++++++++++++++++++++++++----------
 1 file changed, 48 insertions(+), 12 deletions(-)

diff --git a/api/wingui/cli.py b/api/wingui/cli.py
index 43428f8..c52a887 100644
--- a/api/wingui/cli.py
+++ b/api/wingui/cli.py
@@ -462,25 +462,61 @@ class Wingui:
 
 # Funções KB
     def kb_tap(self, s: str) -> str:
-        """Envia uma tecla ou teclas para serem clicadas no componente com foco onde o robo é executado
-        Em caso de teclas alteradoras, elas devem ser sempre posicionadas apos a tecla alvo.
-        Dessa forma, para enviar ALT+d, vc envia o string "d,alt". Para enviar C maiusculo, vc utiiliza
-        "c,shift".
         """
-        return self.__requestget__(f'/ipc/wingui/kb/tap?str={urllib.parse.quote(s, "")}')
+        ## KB Tap
+        Envia uma tecla ou teclas para serem clicadas no componente com foco onde o robo é executado. Em caso de teclas alteradoras, elas devem ser sempre posicionadas após a tecla alvo sem espaço entre a vírgula e o texto.
+
+        ---
+        #### Parâmetros:
+            - s: Sequência de teclas que se deve apertar.
+
+        ---
+        #### Retorna:
+            
+            ---
+
+        ---
+        #### Exemplo:
+            Para enviar ALT+d, você envia o string "d,alt". Para enviar C maiusculo, você utiiliza "c,shift".
+        """
+        str = urllib.parse.quote(s, "")
+        return self.__requestget__(f'/ipc/wingui/kb/tap?str={str}')
 
     def kb_type(self, s: str) -> str:
-        """Semelhante a tap, mas envia textos completos.
-        ***ATENCAO*** Esse metodo usa urlencoding, dessa forma caracteres serao codificados para envio. # virará %23 por exemplo. Ao chegar no robo passarão pelo decoding análogo.
         """
-        return self.__requestget__("/ipc/wingui/kb/type?str={}".format(urllib.parse.quote(s, "")))
+        ## KB Type
+        Semelhante a tap, mas envia textos completos.
+        
+        ---
+        #### Parâmetros:
+            - s: Texto que se quer digitar.
+
+        ---
+        #### Retorna:
+            
+            ---
+        """
+
+        str = urllib.parse.quote(s, "")
+        return self.__requestget__(f"/ipc/wingui/kb/type?str={str}")
 
     def kb_toggle(self, s: str) -> str:
-        """Semelhante a tap, mas envia textos completos.
-        ***ATENCAO*** Esse metodo usa urlencoding, dessa forma caracteres serao codificados para envio. # virará %23
-        por exemplo. Ao chegar no robo passrão pelo decoding análogo.
         """
-        return self.__requestget__("/ipc/wingui/kb/toggle?str={}".format(urllib.parse.quote(s, "")))
+        ## KB Toggle
+        Semelhante a tap, porém mantem a tecla ou o conjunto de teclas pressionado até que elas sejam pressionadas novamente manualmente ou pelo robô. Pode-se utilizar o método kb_tap para interromper o pressionamento por exemplo.
+        
+        ---
+        #### Parâmetros:
+            - s: Tecla ou sequência de teclas que se deseja pressionar.
+
+        ---
+        #### Retorna:
+            
+            ---
+        """
+
+        str = urllib.parse.quote(s, "")
+        return self.__requestget__(f"/ipc/wingui/kb/toggle?str={str}")
 
 # Funções Dialog
     def dialog_color(self, t: str = "Selecione Cor", d: str = "BEBEBE") -> bool: