py: Support Node.js 14+ or newer (#16)

* py: Support Node.js 14+, fix AsyncTask

* py: emitter patches

* py: update docs

HISTORY.md

@@ -1,3 +1,6 @@
+## 0.2.4
+* py: Support Node versions 14+
+
 ## 0.2.3
 * py: Add notebook and Google Colab support [#15](https://github.com/extremeheat/JSPyBridge/pull/15)
 * py: CLI now has a new --update flag to update internal, Node.js dependencies. Now use --clean to reset the package store.

src/javascript/__init__.py

@@ -13,6 +13,9 @@ def init():
     config.global_jsi = proxy.Proxy(config.executor, 0)
     atexit.register(config.event_loop.on_exit)
 
+    if config.global_jsi.needsNodePatches():
+        config.node_emitter_patches = True
+
 
 init()
 
@@ -34,11 +37,10 @@ def require(name, version=None):
 globalThis = config.global_jsi.globalThis
 
 
-def AsyncTask(fn):
-    fn.is_async_task = True
-
-    def decor(start):
-        t = config.event_loop.startThread(fn)
+def AsyncTask(start=False):
+    def decor(fn):
+        fn.is_async_task = True
+        t = config.event_loop.newTaskThread(fn)
         if start:
             t.start()
 
@@ -53,7 +55,17 @@ def decor(start):
 # you will not be able to off an emitter.
 def On(emitter, event):
     # print("On", emitter, event,onEvent)
-    def decor(fn):
+    def decor(_fn):
+        # Once Colab updates to Node 16, we can remove this.
+        # Here we need to manually add in the `this` argument for consistency in Node versions.
+        # In JS we could normally just bind `this` but there is no bind in Python.
+        if config.node_emitter_patches:
+            def handler(*args, **kwargs):
+                _fn(emitter, *args, **kwargs)
+            fn = handler
+        else:
+            fn = _fn
+
         emitter.on(event, fn)
         # We need to do some special things here. Because each Python object
         # on the JS side is unique, EventEmitter is unable to equality check
@@ -77,7 +89,10 @@ def decor(fn):
         i = hash(fn)
 
         def handler(*args, **kwargs):
-            fn(*args, **kwargs)
+            if config.node_emitter_patches:
+                fn(emitter, *args, **kwargs)
+            else:
+                fn(*args, **kwargs)
             del config.event_loop.callbacks[i]
 
         emitter.once(event, handler)

src/javascript/config.py

@@ -7,6 +7,8 @@
 global_jsi = None
 # Currently this breaks GC
 fast_mode = False
+# Whether we need patches for legacy node versions
+node_emitter_patches = False
 
 
 if ("DEBUG" in os.environ) and ("jspybridge" in os.getenv("DEBUG")):

src/javascript/connection.py

@@ -111,7 +111,7 @@ def com_io():
         )
     except Exception as e:
         print(
-            "--====--\t--====--\n\nBridge failed to spawn JS process!\n\nDo you have Node.js 15 or newer installed? Get it at https://nodejs.org/\n\n--====--\t--====--"
+            "--====--\t--====--\n\nBridge failed to spawn JS process!\n\nDo you have Node.js 16 or newer installed? Get it at https://nodejs.org/\n\n--====--\t--====--"
         )
         stop()
         raise e

src/javascript/js/bridge.js

@@ -51,7 +51,14 @@ class Bridge {
         console,
         require: $require,
         _require: require,
-        globalThis
+        globalThis,
+        needsNodePatches: () => {
+          const [major, minor] = process.versions.node.split('.')
+          if ((major == 14 && minor < 17) || (major == 15)) { // eslint-disable-line
+            return true
+          }
+          return false
+        }
       }
     }
     this.ipc = ipc