Update stable version

Update stable version

Author: JE-Chen

stable.toml dev.tomlstable.toml renamed to dev.toml

@@ -1,12 +1,12 @@
-# Rename to build stable version
-# This is stable version
+# Rename to build dev version
+# This is dev version
 [build-system]
-requires = ["setuptools>=61.0"]
+requires = ["setuptools"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "je_auto_control"
-version = "0.0.127"
+name = "je_auto_control_dev"
+version = "0.0.63"
 authors = [
     { name = "JE-Chen", email = "zenmailman@gmail.com" },
 ]

docs/source/Eng/doc/callback_function/callback_function_doc.rst

@@ -41,6 +41,8 @@ for example, time.sleep will become time_sleep.
 
 If we want to add functions in the callback_executor, we can use the following code:
 
+This code will add all the functions of the time module to the executor (interpreter).
+
 .. code-block:: python
 
     from je_auto_control import package_manager

docs/source/Eng/doc/cli/cli_doc.rst

@@ -1,16 +1,18 @@
-命令列介面 文件
+CLI
 ----
 
-我們可以使用 CLI 模式去執行 keyword.json 檔案或執行包含 Keyword.json files 的資料夾，
-以下這個範例是去執行指定路徑的關鍵字 json 檔
+We can use the CLI mode to execute the keyword.
+json file or execute the folder containing the Keyword.json files.
+
+The following example is to execute the specified path of the keyword JSON file.
 
 .. code-block::
 
     python je_auto_control --execute_file "C:\Users\JeffreyChen\Desktop\Code_Space\AutoControl\test\unit_test\argparse\test1.json"
 
 
 
-以下這個範例是去執行指定路徑資料夾下所有的 keyword json 檔
+The following example is to run all keyword JSON files in a specified folder:
 
 .. code-block::
 

docs/source/Eng/doc/critical_exit/critical_exit_doc.rst

@@ -1,13 +1,16 @@
-緊急退出 文件
+緊急退出
 ----
-* Critical Exit 是提供故障保護的機制。
-* Critical Exit 預設是關閉的。
-* 如果開啟，預設按鍵是 F7。
-* 開啟的方法是 CriticalExit().init_critical_exit()
 
-以下這個範例是讓滑鼠不受控制的移動並拋出例外，
-當接收到例外，初始化 Critical Exit 並自動按下 F7，
-( 注意! 如果修改這個範例必須極度小心。 )
+* Critical Exit is a mechanism that provides fault protection.
+* Critical Exit is disabled by default.
+* If enabled, the default hotkey is F7.
+* To enable Critical Exit, call CriticalExit().init_critical_exit()
+* (enabling it will consume additional system resources).
+
+The following example is to make the mouse move uncontrollably and throw an exception.
+When the exception is caught, initialize the Critical Exit and automatically press F7.
+(Note! If you modify this example, you must be extremely careful.
+You may lose control of your computer, such as the mouse being out of control.)
 
 .. code-block:: python
 
@@ -16,7 +19,7 @@
     from je_auto_control import AutoControlMouseException
     from je_auto_control import CriticalExit
     from je_auto_control import press_key
-    from je_auto_control import set_mouse_position
+    from je_auto_control import set_position
     from je_auto_control import size
 
     # print your screen width and height
@@ -27,7 +30,7 @@
 
     try:
         from time import sleep
-
+        # Or no sleep
         sleep(3)
         while True:
             set_mouse_position(200, 400)

docs/source/Eng/doc/generate_report/generate_report_doc.rst

@@ -1,14 +1,16 @@
-報告產生 文件
+Generate Report
 ----
 
-Generate Report 可以生成以下格式的報告
-* HTML
-* JSON
-* XML
-* Generate Report 主要用來記錄與確認有哪些步驟執行，執行是否成功，
-* 如果要使用 Generate Report 需要先設定紀錄為 True，使用 test_record_instance.init_record = True
-* 下面的範例有搭配 keyword and executor 如果看不懂可以先去看看 executor
-以下是產生 HTML 的範例。
+* Generate Report can generate reports in the following formats:
+ * HTML
+ * JSON
+ * XML
+
+* Generate Report is mainly used to record and confirm which steps were executed and whether they were successful or not.
+* If you want to use Generate Report, you need to set the recording to True by using test_record_instance.init_record = True.
+* The following example is used with keywords and an executor. If you don't understand, please first take a look at the executor.
+
+Here's an example of generating an HTML report.
 
 .. code-block:: python
 
@@ -57,7 +59,7 @@ Generate Report 可以生成以下格式的報告
     execute_action(test_list)
 
 
-以下是產生 JSON 的範例。
+Here's an example of generating an JSON report.
 
 .. code-block:: python
 
@@ -105,7 +107,7 @@ Generate Report 可以生成以下格式的報告
     print("\n\n")
     execute_action(test_list)
 
-以下是產生 XML 的範例。
+Here's an example of generating an XML report.
 
 .. code-block:: python
 

docs/source/Eng/doc/image/image_doc.rst

@@ -1,12 +1,14 @@
-圖片偵測 文件
+Image detect
 ----
 
-* Image 提供了關於圖像辨識的功能。
-* 定位一張圖片在螢幕中的位置。
-* 定位多張圖片在螢幕中的位置。
-* 定位圖片在螢幕中的位置並點擊。
+* Image detect provides functionalities related to image recognition.
+* Locating the position of a single image on the screen.
+* Locating the position of multiple images on the screen.
+* Locating the position of an image on the screen and clicking on it.
 
-以下範例是定位所有圖片
+This is mainly used to recognize images on the screen and perform clicks or determine if the image exists on the screen.
+
+The following example is to locate all images.
 
 .. code-block:: python
 
@@ -23,7 +25,7 @@
     image_data = locate_all_image(screenshot(), detect_threshold=0.9, draw_image=False)
     print(image_data)
 
-以下範例是定位並點擊圖片
+The following example is used to locate and click on an image.
 
 .. code-block:: python
 
@@ -39,7 +41,7 @@
     image_data = locate_and_click(screenshot(), "mouse_left", detect_threshold=0.9, draw_image=False)
     print(image_data)
 
-以下範例是定位圖片
+The following example locates an image.
 
 .. code-block:: python
 

docs/source/Eng/doc/installation/installation_doc.rst

@@ -1,4 +1,4 @@
-安裝 文件
+Installation
 ----
 
 .. code-block:: python
@@ -14,7 +14,7 @@
     * osx 11 big sur
     * ubuntu 20.0.4
 
-| 如果想要在樹梅派使用
+| If you want install on raspberry pi
 
 .. code-block:: python
 

docs/source/Eng/doc/keyboard/keyboard_doc.rst

@@ -1,12 +1,12 @@
-鍵盤 文件
+Keyboard
 ----
 
-* 主要用來模擬鍵盤的控制。
-* 提供熱鍵、檢盤鍵盤狀態、模擬鍵盤控制等功能。
+* Used to simulate keyboard control.
+* Provides functions such as hotkeys, checking keyboard key status (whether pressed), and simulating keyboard control.
+* The following example is to obtain information about the keyboard.
 
-以下範例是取得鍵盤的資訊，
-* special_table 是特定的鍵盤按鍵 ( 注意! 不是每個平台都有 )
-* keys_table 是所有可以使用的按鍵
+* special_table is a table of special keyboard keys (Note! Not every platform has them).
+* keys_table is a table of all available keys.
 
 .. code-block:: python
 
@@ -16,7 +16,7 @@
     print(get_special_table())
 
 
-以下範例是按著鍵盤的某個按鍵，並在一秒後釋放
+The following example presses a certain key on the keyboard and releases it after one second.
 
 .. code-block:: python
 
@@ -27,7 +27,7 @@
     sleep(1)
     release_key("a")
 
-以下範例是按下與釋放按鍵
+The following example presses and releases a key.
 
 .. code-block:: python
 
@@ -51,7 +51,7 @@
 
     write("abcdefg")
 
-以下範例是按下按鍵並相反的釋放
+以下範例是按下按鍵並相反的釋放按鍵
 
 .. code-block:: python
 

docs/source/Eng/doc/keyword_and_executor/keyword_and_executor_doc.rst

@@ -1,9 +1,9 @@
-鍵盤與執行者 文件
+Keyword & Executor
 ----
 
-* Keyword 是一個 JSON 檔案裏面包含許多自定義的關鍵字與參數。
-* Keyword 會與 Executor 搭配使用。
-* Keyword 的格式是以下範例，且在 JSON 檔案裡面使用一樣格式。
+Keyword is a JSON file that contains many custom keywords and parameters.
+Keywords are used in conjunction with the Executor.
+The format of a keyword is as shown in the following example, and the same format is used in the JSON file.
 
 .. code-block:: python
 
@@ -16,10 +16,13 @@
         ["function_name_in_event_dict": {param_value1, param_value2....}]
     ]
 
-如果我們想要在 executor 裡面添加 function，可以使用如下:
-這段程式碼會把所有 time module 的 builtin, function, method, class
-載入到 executor，然後要使用被載入的 function 需要使用 package_function 名稱，
-例如 time.sleep 會變成 time_sleep
+The executor is an interpreter that can parse JSON files and execute automation scripts.
+It can be easily transferred over the network to a remote server or computer,
+which can then execute the automation scripts using the executor.
+
+If we want to add a function to the executor, we can use the following code snippet.
+This code will load all the built-in functions, methods, and classes of the time module into the executor.
+To use the loaded functions, we need to use the package_function name, for example, time.sleep will become time_sleep.
 
 .. code-block:: python
 
@@ -28,21 +31,21 @@
 
 
 
-如果你需要查看被更新的 event_dict 可以使用
+If you need to check the updated event_dict, you can use:
 
 .. code-block:: python
 
     from je_auto_control import executor
     print(executor.event_dict)
 
-如果我們想要執行 JSON 檔案
+If we want to execute a JSON file
 
 .. code-block:: python
 
     from je_auto_control import execute_action, read_action_json
     execute_action(read_action_json(file_path))
 
-如果我們想要執行資料夾裡所有 JSON 檔案
+If we want to execute all JSON files in a folder, we can use the following code snippet:
 
 .. code-block:: python
 

docs/source/Eng/doc/mouse/mouse_doc.rst

@@ -1,19 +1,19 @@
-滑鼠 文件
+Mouse
 ----
 
-* 主要用來模擬滑鼠的控制。
-* 提供模擬點擊、設定位置等功能。
+* This module is used for simulating mouse control.
+* It provides functions for simulating clicks, setting positions, etc.
 
-以下範例是取得鍵盤的資訊，
-* mouse_table 是所有可以使用的按鍵
+The following example is to obtain information about mouse clicks:
+mouse_table contains all the available mouse buttons.
 
 .. code-block:: python
 
     from je_auto_control import mouse_table
 
     print(mouse_table)
 
-以下範例是按著滑鼠，一秒後釋放滑鼠
+The following example is holding down the mouse button and releasing it after one second.
 
 .. code-block:: python
 
@@ -22,17 +22,18 @@
     from je_auto_control import press_mouse, release_mouse
 
     press_mouse("mouse_right")
+    sleep(1)
     release_mouse("mouse_right")
 
-以下範例是點擊並放開滑鼠
+The following example is clicking and releasing the mouse.
 
 .. code-block:: python
 
     from je_auto_control import click_mouse
 
     click_mouse("mouse_right")
 
-以下範例是檢查滑鼠位置並改變滑鼠位置
+The following example is to check the mouse position and change the mouse position.
 
 .. code-block:: python
 
@@ -41,7 +42,7 @@
     print(get_mouse_position())
     set_mouse_position(100, 100)
 
-以下範例是3秒後滑鼠會往上 scroll
+Here's an example where the mouse will scroll up after 3 seconds:
 
 .. code-block:: python