v1.5 - #16 cleaner debug log when ' is used

Upstream TagUI project has a limitation in live mode. It was a tradeoff to enable dynamic variables working for selectors and parameters in live mode. As a result, TagUI for Python sends the following string to TagUI when a single quote ' is used as parameter (non-identifier parameter).

```
'+"\'"+'
```

With the issue aisingapore/TagUI#465 raised by user, an improvement is made upstream, using a solution for a similar problem while working on this personal side project. Thus a commit can now be made here that replaces single quote ' for non-identifier parameter with

```
\'
```

This may seem like a small improvement, but it helps clarify in debug log tagui_python.log when t.debug(True) is set. Otherwise, whenever there is a ' it would result in some roundabout escape sequence above due to a limitation in upstream live mode. This commit fixes that by escaping ' to \' following standard convention.

Author: kensoh

README.md

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

sample.py

@@ -15,7 +15,7 @@
 # use read() to fetch and return text from UI element
 search_text = t.read('search-box')
 
-# use echo() to print to output (tracked in debug log)
+# use echo() to print to output, same as Python print()
 t.echo(search_text)
 
 # use click() to click on an UI element or x, y location

setup.py

@@ -2,7 +2,7 @@
 
 setup(
     name='tagui',
-    version='1.4.0',
+    version='1.5.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.4.0'
+__version__ = '1.5.0'
 
 import subprocess
 import os
@@ -131,10 +131,9 @@ def _tagui_output():
     return tagui_output_text
 
 def _esq(input_text = ''):
-    """function to escape single quote ' for tagui live mode"""
-    # ie change ' to be `"\'"` which becomes '+"\'"+' in tagui
-    # "[BACKSLASH_QUOTE]" used in interim to work with send()
-    return input_text.replace("'",'`"[BACKSLASH_QUOTE]"`')
+    """function for selective escape of single quote ' for tagui"""
+    # [BACKSLASH_QUOTE] marker to work together with send()
+    return input_text.replace("'",'[BACKSLASH_QUOTE]')
 
 def _sdq(input_text = ''):
     """function to escape ' in xpath for tagui live mode"""
@@ -562,7 +561,7 @@ def send(tagui_instruction = None):
         tagui_instruction = tagui_instruction.replace('\f','\\f')
 
         # special handling for single quote to work with _esq() for tagui
-        tagui_instruction = tagui_instruction.replace('"[BACKSLASH_QUOTE]"','"\\\'"')
+        tagui_instruction = tagui_instruction.replace('[BACKSLASH_QUOTE]','\\\'')
 
         # escape backslash to display source string correctly after echoing
         echo_safe_instruction = tagui_instruction.replace('\\','\\\\')