07/29

Author: 4D617278

docs/testing/EXPLAIN_FILES.md

@@ -0,0 +1,81 @@
+# Understanding important files in the WebApp/tests/browserstack directory
+
+-rw-r--r-- 1 rpite rpite 6122 Jul  5 14:00 add_devices.py</br>
+-rw-r--r-- 1 rpite rpite 3929 Jun 20 17:22 automate.py</br>
+-rw-r--r-- 1 rpite rpite  476 Jul 27 13:13 browserstack.config.js</br>
+-rw-r--r-- 1 rpite rpite  337 May 15 12:33 browserstack.config-template.js</br>
+-rw-r--r-- 1 rpite rpite 5358 Jul 29 08:25 config.py</br>
+-rw-r--r-- 1 rpite rpite 6603 Jul 15 14:16 devices_to_test.json</br>
+-rw-r--r-- 1 rpite rpite  112 Apr 27 05:15 .eslintrc</br>
+-rw-r--r-- 1 rpite rpite 4744 Jul 29 08:26 parallel.wdio.config.js</br>
+-rw-r--r-- 1 rpite rpite  117 May 21 18:51 README.md</br>
+-rw-r--r-- 1 rpite rpite 1551 Jul 13 10:33 remove_devices.py</br>
+-rw-r--r-- 1 rpite rpite 1852 Jul 27 13:30 repl</br>
+-rw-r--r-- 1 rpite rpite   78 Jul 29 10:42 requirements.txt</br>
+drwxr-xr-x 2 rpite rpite 4096 Jul 29 10:25 specs</br>
+-rwxr-xr-x 1 rpite rpite 1607 Jul 15 05:52 testScript</br>
+-rw-r--r-- 1 rpite rpite 7979 Jul 27 13:29 utils.js</br>
+-rw-r--r-- 1 rpite rpite 4169 Jul 29 08:21 wdio.conf.js</br>
+-rw-r--r-- 1 rpite rpite 4564 Jul 29 07:55 wdio.conf.template</br>
+
+## Python Scripts
+
+Requires python3+
+
+To install python3 modules do:
+
+      $ pip3 install -r requirements.txt 
+
+### add_devices.py
+
+Adds device json to the devices_to_test.json file. Use -h for help.
+
+### automate.py
+
+Automatically inserts code into test script file. Requires [i3-wm](https://i3wm.org/) and xclip. Use -h for help.
+
+### remove_devices.py
+
+Removes device json from the devices_to_test.json file. Use -h for help.
+
+### config.py
+
+Uses the wdio.config.template file to generate the wdio.config.js file, which is used for running the test. Use -h for help.
+
+## Javascript files
+
+### browserstack.config.js
+
+Configuration file for test scripts.
+
+### parallel.wdio.config.js
+
+Template file for creating wdio.config.template.
+
+### utils.js
+
+Defines javascript functions used in test scripts.
+
+### wdio.conf.js
+
+Configuration for test run by webdriverio.
+
+## Bash scripts
+
+Requires bash
+
+### testScript
+
+Generates the template file named wdio.config.template which acts as a template for creating wdio.config.js as well as creates the script using the script name parameter if it does not already exist.
+
+## Miscellaneous files
+
+### repl
+
+Copied and pasted into the [wdio repl](https://webdriver.io/docs/repl.html) to use the functions defined in utils.js
+
+### wdio.conf.template
+
+Template file for creating wdio.conf.js
+
+

tests/browserstack/config.py

@@ -20,7 +20,8 @@
 parser.add_argument('-t', '--timeout', default=360000, type=int, help='time before test ends')
 parser.add_argument('-m', '--isMobileScreenSize', action='store_true', help='set mobile-screen to true')
 parser.add_argument('-d', '--isCordova', action='store_true', help='set isCordovaFromAppStore to true')
-parser.add_argument('-r', '--resolution', default='', type=str, help='set screen resolution')
+parser.add_argument('-r', '--resolution', default='', type=str, help='set screen resolution (1080x1920)')
+parser.add_argument('-o', '--orientation', default='', type=str, help='set screen orientation (LANDSCAPE/PORTRAIT)')
 parser.add_argument('--acceptSslCerts', action='store_false', help='do not use https')
 parser.add_argument('--connectionRetryTimeout', default=90000, type=int, help='time before connection is retried')
 parser.add_argument('--connectionRetryCount', default=3, type=int, help='number of times connection is retried')

tests/browserstack/example.wdio.config.js

@@ -27,6 +27,8 @@ exports.config = {
       browser_version: '%browser_version0',
       real_mobile: %real_mobile,
       acceptSslCerts: %acceptSslCerts,
+      resolution: '%resolution',
+      orientation: '%orientation',
       'browserstack.console': 'info',
       'browserstack.appium_version': '%browserstack.appium_version0',
       'browserstack.local': %browserstack.local,
@@ -47,6 +49,8 @@ exports.config = {
       browser_version: '%browser_version1',
       real_mobile: %real_mobile,
       acceptSslCerts: %acceptSslCerts,
+      resolution: '%resolution',
+      orientation: '%orientation',
       'browserstack.console': 'info',
       'browserstack.appium_version': '%browserstack.appium_version1',
       'browserstack.local': %browserstack.local,
@@ -67,6 +71,8 @@ exports.config = {
       browser_version: '%browser_version2',
       real_mobile: %real_mobile,
       acceptSslCerts: %acceptSslCerts,
+      resolution: '%resolution',
+      orientation: '%orientation',
       'browserstack.console': 'info',
       'browserstack.appium_version': '%browserstack.appium_version2',
       'browserstack.local': %browserstack.local,
@@ -87,6 +93,8 @@ exports.config = {
       browser_version: '%browser_version3',
       real_mobile: %real_mobile,
       acceptSslCerts: %acceptSslCerts,
+      resolution: '%resolution',
+      orientation: '%orientation',
       'browserstack.console': 'info',
       'browserstack.appium_version': '%browserstack.appium_version3',
       'browserstack.local': %browserstack.local,
@@ -107,6 +115,8 @@ exports.config = {
       browser_version: '%browser_version4',
       real_mobile: %real_mobile,
       acceptSslCerts: %acceptSslCerts,
+      resolution: '%resolution',
+      orientation: '%orientation',
       'browserstack.console': 'info',
       'browserstack.appium_version': '%browserstack.appium_version4',
       'browserstack.local': %browserstack.local,

tests/browserstack/parallel.wdio.config.js

@@ -0,0 +1,4 @@
+selenium
+pyperclip
+pyautogui
+pynput