Publish Vulpes Preview 15 sources for desktop, Android and Tundra

Share Gaia assets and adapters, keep private profiles and development documents local, and update both public READMEs.

android/tools/probe-android.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+"""Evaluate a diagnostic in one Gaia app through the ADB-only debugger."""
+import json,sys,time
+from rdp import RDP
+
+def evaluate(host, script):
+    r=RDP()
+    try:
+        for process in r.call('root','listProcesses')['processes']:
+            if process['isParent']: continue
+            target=r.call(process['actor'],'getTarget')['process']
+            if 'webIsolated' not in target.get('remoteType',''): continue
+            text='''(() => { const w=[...Services.ww.getWindowEnumerator()].find(w=>w.location.hostname===%s); if(!w)return null; return w.wrappedJSObject.eval(%s); })()''' % (json.dumps(host+'.localhost'),json.dumps(script))
+            response=r.call(target['consoleActor'],'evaluateJSAsync',text=text)
+            if 'resultID' not in response: continue
+            while True:
+                value=r.recv()
+                if value.get('type')=='evaluationResult' and value.get('resultID')==response['resultID']:
+                    if value.get('hasException'): raise RuntimeError(value.get('exceptionMessage',str(value)))
+                    if value.get('result') is not None and value.get('result') != {'type':'null'}: return value.get('result')
+                    break
+        raise RuntimeError('App not open: '+host)
+    finally:r.s.close()
+
+def run(host,expression,timeout=30):
+    start=time.monotonic()+timeout
+    while True:
+        try:
+            evaluate(host,'window.__androidProbe=null; Promise.resolve().then(async()=>('+expression+')).then(value=>window.__androidProbe=JSON.stringify({value}),error=>window.__androidProbe=JSON.stringify({error:String(error),stack:error.stack})); "started"')
+            break
+        except (RuntimeError, EOFError, OSError) as e:
+            if time.monotonic()>=start:raise
+            if isinstance(e, RuntimeError) and not str(e).startswith('App not open:'):raise
+            time.sleep(.3)
+    until=time.monotonic()+timeout
+    while time.monotonic()<until:
+        result=evaluate(host,'window.__androidProbe || "pending"')
+        if isinstance(result,str) and result != 'pending':return json.loads(result)
+        time.sleep(.3)
+    raise TimeoutError(host)
+
+if __name__=='__main__':
+    print(json.dumps(run(sys.argv[1],sys.argv[2]),ensure_ascii=False,indent=2))