tebelorg#35 tebelorg#34 - cleaner execution and error handling

tebelorg#35 - Cleaner usage and execution without TagUI intermediary files

During usage, the following temporary files will be generated in order to use TagUI -

tagui_python - simple flow to initiate TagUI live mode
tagui_python.raw - raw file for TagUI module expansion
tagui_python.js - generated JavaScript code for TagUI
tagui_local.js - TagUI for Python custom functions file
tagui_python.log - log file for automation execution
tagui_python.txt - to retrieve data output from TagUI

When debug mode is on using debug(True), only tagui_python.log and tagui_python.txt will be retained while the rest are deleted. That essentially means that the first 4 files above do not really add value to the typical TagUI for Python user. Having them in the script folder during execution may add clutter, clunkiness and confusion.

Furthermore, TagUI for Python has been downloaded over 5000 times since initial release, without users reporting issue that requires above 4 temporary files for debugging and troubleshooting.

Raising issue to update code to immediately delete the first 4 files upon connecting to TagUI to remove clutter. For the last 2 files, they will be retained until close() is used, where they will be deleted if debug(False) (default).

tebelorg#34 - graceful error handling on Windows folder path with space

On Windows, if script is used in folder path name with space, error message can appear without any meaningful information.

Some components of upstream project TagUI cannot work with spaces in the path and folder name containing the TagUI automation script. Solution is store the script in a folder path without space, or run it from a folder path without space in it.

Author: kensoh

README.md

@@ -2,7 +2,7 @@
 
 # TagUI for Python
 
-[**Use Cases**](#use-cases) | [**API Reference**](#api-reference) | [**About & Credits**](#about--credits) | [**v1.8**](https://github.com/tebelorg/TagUI-Python/releases)
+[**Use Cases**](#use-cases) | [**API Reference**](#api-reference) | [**About & Credits**](#about--credits) | [**v1.9**](https://github.com/tebelorg/TagUI-Python/releases)
 
 ![TagUI for Python demo in Jupyter notebook](https://raw.githubusercontent.com/tebelorg/Tump/master/tagui_python.gif)
 

setup.py

@@ -2,7 +2,7 @@
 
 setup(
     name='tagui',
-    version='1.8.0',
+    version='1.9.0',
     py_modules=['tagui'],
     author='Ken Soh',
     author_email='[email protected]',

tagui.py

@@ -1,6 +1,6 @@
 """INTEGRATION ENGINE FOR TAGUI PYTHON PACKAGE ~ TEBEL.ORG"""
 __author__ = 'Ken Soh <[email protected]>'
-__version__ = '1.8.0'
+__version__ = '1.9.0'
 
 import subprocess
 import os
@@ -413,6 +413,11 @@ def init(visual_automation = False, chrome_browser = True):
     # sync tagui delta files for current release if needed
     if not _tagui_delta(tagui_directory): return False
 
+    # on Windows, check if there is space in folder path name
+    if platform.system() == 'Windows' and ' ' in os.getcwd():
+        print('[TAGUI][INFO] - to use TagUI for Python on Windows, avoid space in folder path name')
+        return False
+
     # create entry flow to launch SikuliX accordingly
     if visual_automation:
         # check for working java jdk for visual automation mode
@@ -492,6 +497,12 @@ def init(visual_automation = False, chrome_browser = True):
                     print('[TAGUI][ERROR] - TagUI process ended unexpectedly')
                     return False
 
+                # remove generated tagui flow, js code and custom functions files
+                if os.path.isfile('tagui_python'): os.remove('tagui_python')
+                if os.path.isfile('tagui_python.js'): os.remove('tagui_python.js')
+                if os.path.isfile('tagui_python.raw'): os.remove('tagui_python.raw')
+                if os.path.isfile('tagui_local.js'): os.remove('tagui_local.js')
+
                 # increment id and prepare for next instruction
                 _tagui_id = _tagui_id + 1
 
@@ -627,12 +638,6 @@ def close():
         # loop until tagui process has closed before returning control
         while _process.poll() is None: pass
 
-        # remove generated tagui flow, js code and custom functions files
-        if os.path.isfile('tagui_python'): os.remove('tagui_python')
-        if os.path.isfile('tagui_python.js'): os.remove('tagui_python.js')
-        if os.path.isfile('tagui_python.raw'): os.remove('tagui_python.raw')
-        if os.path.isfile('tagui_local.js'): os.remove('tagui_local.js')
-
         # remove generated tagui log and data files if not in debug mode
         if not debug():
             if os.path.isfile('tagui_python.log'): os.remove('tagui_python.log')