Merge pull request #1 from browserstack/app_automate_tests

Add App Automate tests

Author: tejasshah93

README.md

@@ -1 +1,10 @@
 # python-appium-app-browserstack
+App Automate Python Samples
+---------------------
+
+This repository contains code for Automated Native App tests. Please feel free to clone the repo and use the example code.
+
+For frameworks integration with BrowserStack, refer to their individual repositories -
+
+- [Lettuce](https://github.com/browserstack/lettuce-appium-app-browserstack)
+- [Behave](https://github.com/browserstack/behave-appium-app-browserstack)

android/BrowserStackAndroid.py

@@ -0,0 +1,33 @@
+from appium import webdriver
+from appium.webdriver.common.mobileby import MobileBy
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+import time
+
+userName = "BROWSERSTACK_USERNAME"
+accessKey = "BROWSERSTACK_ACCESS_KEY"
+
+desired_caps = {
+    "build": "Python Android",
+    "realMobile": True,
+    "device": "Samsung Galaxy S7",
+    "app": "bs://<hashed app-id>"
+}
+
+driver = webdriver.Remote("http://" + userName + ":" + accessKey + "@hub.browserstack.com/wd/hub", desired_caps)
+
+search_element = WebDriverWait(driver, 30).until(
+    EC.element_to_be_clickable((MobileBy.ACCESSIBILITY_ID, "Search Wikipedia"))
+)
+search_element.click()
+
+search_input = WebDriverWait(driver, 30).until(
+    EC.element_to_be_clickable((MobileBy.ID, "org.wikipedia.alpha:id/search_src_text"))
+)
+search_input.send_keys("BrowserStack")
+time.sleep(5)
+
+search_results = driver.find_elements_by_class_name("android.widget.TextView")
+assert(len(search_results) > 0)
+
+driver.quit()

android/LocalSampleAndroid.py

@@ -0,0 +1,56 @@
+from appium import webdriver
+from appium.webdriver.common.mobileby import MobileBy
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from browserstack.local import Local
+import time
+
+userName = "BROWSERSTACK_USERNAME"
+accessKey = "BROWSERSTACK_ACCESS_KEY"
+
+desired_caps = {
+    "build": "Python Android Local",
+    "device": "Samsung Galaxy S7",
+    "realMobile": True,
+    "browserstack.local": True,
+    "app": "bs://<hashed app-id>"
+}
+
+bs_local = None
+
+def start_local():
+    global bs_local
+    bs_local = Local()
+    bs_local_args = { "key": accessKey, "forcelocal": "true" }
+    bs_local.start(**bs_local_args)
+
+def stop_local():
+    global bs_local
+    bs_local.stop()
+
+start_local()
+driver = webdriver.Remote("http://" + userName + ":" + accessKey + "@hub.browserstack.com/wd/hub", desired_caps)
+test_button = WebDriverWait(driver, 30).until(
+    EC.element_to_be_clickable((MobileBy.ID, "com.example.android.basicnetworking:id/test_action"))
+)
+test_button.click()
+WebDriverWait(driver, 30).until(
+    EC.element_to_be_clickable((MobileBy.CLASS_NAME, "android.widget.TextView"))
+)
+
+test_element = None
+search_results = driver.find_elements_by_class_name("android.widget.TextView")
+for result in search_results:
+    if result.text.__contains__("The active connection is"):
+        test_element = result
+
+if test_element is None:
+    raise Exception("Cannot find the needed TextView element from app")
+
+matched_string = test_element.text
+print matched_string
+assert(matched_string.__contains__("The active connection is wifi"))
+assert(matched_string.__contains__("Up and running"))
+
+driver.quit()
+stop_local()

android/README.md

@@ -0,0 +1,29 @@
+## Dependencies
+
+For installing the required packages, use the following command
+
+```
+$ pip install -r requirements.txt
+```
+
+## Running your tests
+
+- Do remember to switch the BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY with your own browserstack credentials.
+- Upload your Native App (.apk file) to BrowserStack servers using upload API and update the app capability:
+
+  ```
+  curl -u "username:accesskey" -X POST "https://api.browserstack.com/app-automate/upload" -F "file=@/path/to/app/file/Application-debug.apk"
+  ```
+
+- If you do not have an .apk file and looking to simply try App Automate, you can download our [sample app](https://www.browserstack.com/app-automate/sample-apps/android/WikipediaSample.apk) and upload to the BrowserStack servers using the above API.
+- For LocalSample tests, you can use our [local sample app](https://www.browserstack.com/app-automate/sample-apps/android/LocalSample.apk).
+- Update the desired capability "app" with the App URL returned from the above API call
+
+## Notes
+* You can view your test results on the [BrowserStack App Automate dashboard](https://www.browserstack.com/app-automate)
+* Refer [Get Started](https://www.browserstack.com/app-automate/appium-python) document to configure the capabilities
+
+For frameworks integration with BrowserStack, refer to their individual repositories -
+
+- [Lettuce](https://github.com/browserstack/lettuce-appium-app-browserstack)
+- [Behave](https://github.com/browserstack/behave-appium-app-browserstack)

android/requirements.txt

@@ -0,0 +1,3 @@
+Appium-Python-Client
+browserstack-local
+selenium

ios/BrowserStackIOS.py

@@ -0,0 +1,40 @@
+from appium import webdriver
+from appium.webdriver.common.mobileby import MobileBy
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+import time
+
+userName = "BROWSERSTACK_USERNAME"
+accessKey = "BROWSERSTACK_ACCESS_KEY"
+
+desired_caps = {
+    "build": "Python iOS",
+    "realMobile": True,
+    "device": "iPhone 7",
+    "automationName": "XCUITest",
+    "app": "bs://<hashed app-id>"
+}
+
+driver = webdriver.Remote("http://" + userName + ":" + accessKey + "@hub.browserstack.com/wd/hub", desired_caps)
+
+login_button = WebDriverWait(driver, 30).until(
+    EC.element_to_be_clickable((MobileBy.ACCESSIBILITY_ID, "Log In"))
+)
+login_button.click()
+
+email_input = WebDriverWait(driver, 30).until(
+    EC.element_to_be_clickable((MobileBy.ACCESSIBILITY_ID, "Email address"))
+)
+email_input.send_keys("hello@browserstack.com")
+
+driver.find_element_by_accessibility_id("Next").click()
+time.sleep(5)
+
+text_elements = driver.find_elements_by_xpath("//XCUIElementTypeStaticText")
+assert(len(text_elements) > 0)
+elements = filter(
+    lambda x: x.__contains__("not registered on WordPress.com"),
+    [x.text for x in text_elements]
+)
+assert(len(elements) > 0)
+driver.quit()

ios/LocalSampleIOS.py

@@ -0,0 +1,57 @@
+from appium import webdriver
+from appium.webdriver.common.mobileby import MobileBy
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+from browserstack.local import Local
+import os
+
+userName = "BROWSERSTACK_USERNAME"
+accessKey = "BROWSERSTACK_ACCESS_KEY"
+
+desired_caps = {
+    "build": "Python iOS Local",
+    "realMobile": True,
+    "device": "iPhone 7",
+    "automationName": "XCUITest",
+    "browserstack.local": True,
+    "app": "bs://<hashed app-id>"
+}
+
+bs_local = None
+
+def start_local():
+    global bs_local
+    bs_local = Local()
+    bs_local_args = { "key": accessKey, "forcelocal": "true" }
+    bs_local.start(**bs_local_args)
+
+def stop_local():
+    global bs_local
+    bs_local.stop()
+
+def existence_lambda(s):
+    result = s.find_element_by_accessibility_id("ResultBrowserStackLocal").get_attribute("value")
+    return result and len(result) > 0
+
+start_local()
+driver = webdriver.Remote("http://" + userName + ":" + accessKey + "@hub.browserstack.com/wd/hub", desired_caps)
+
+test_button = WebDriverWait(driver, 30).until(
+    EC.element_to_be_clickable((MobileBy.ACCESSIBILITY_ID, "TestBrowserStackLocal"))
+)
+test_button.click()
+
+WebDriverWait(driver, 30).until(existence_lambda)
+result_element = driver.find_element_by_accessibility_id("ResultBrowserStackLocal")
+result_string = result_element.text.lower()
+
+if result_string.__contains__("not working"):
+    screenshot_file = "%s/screenshot.png" % os.getcwd()
+    driver.save_screenshot(screenshot_file)
+    print "Screenshot stored at %s" % screenshot_file
+    print "Unexpected BrowserStackLocal test result"
+else:
+    assert(result_string.__contains__("up and running"))
+
+driver.quit()
+stop_local()

ios/README.md

@@ -0,0 +1,29 @@
+## Dependencies
+
+For installing the required packages, use the following command
+
+```
+$ pip install -r requirements.txt
+```
+
+## Running your tests
+
+- Do remember to switch the BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY with your own browserstack credentials.
+- Upload your Native App (.ipa file) to BrowserStack servers using upload API and update the app capability:
+
+  ```
+  curl -u "username:accesskey" -X POST "https://api.browserstack.com/app-automate/upload" -F "file=@/path/to/app/file/Application-debug.ipa"
+  ```
+
+- If you do not have an .ipa file and looking to simply try App Automate, you can download our [sample app](https://www.browserstack.com/app-automate/sample-apps/ios/WordPressSample.ipa) and upload to the BrowserStack servers using the above API.
+- For LocalSample tests, you can use our [local sample app](https://www.browserstack.com/app-automate/sample-apps/ios/LocalSample.ipa).
+- Update the desired capability "app" with the App URL returned from the above API call
+
+## Notes
+* You can view your test results on the [BrowserStack App Automate dashboard](https://www.browserstack.com/app-automate)
+* Refer [Get Started](https://www.browserstack.com/app-automate/appium-python) document to configure the capabilities
+
+For frameworks integration with BrowserStack, refer to their individual repositories -
+
+- [Lettuce](https://github.com/browserstack/lettuce-appium-app-browserstack)
+- [Behave](https://github.com/browserstack/behave-appium-app-browserstack)

ios/requirements.txt

@@ -0,0 +1,3 @@
+Appium-Python-Client
+browserstack-local
+selenium