altunity-headspin-python

AltUnity enables UI test automation, by instrumenting games to get access and programmatically control the Unity objects.
Headspin is a Digital Experience AI Platform that combines a global device infrastructure, test automation, and ML-driven analytics.
Python is an interpreted high-level general-purpose programming language.

Core Concepts

• Behaviour Driven Development is an agile software development process that encourages collaboration among developers, quality assurance testers, and customer representatives in a software project.
  • Stakeholders might be used to the User Story template; "As a … I want … So that …"
  • Developers might be used to a unit test design pattern; "Arrange, Act, Assert"
  • Cucumber expresess functionality using keywords; "Given, When, Then"
• Fluent Interface is an object-oriented API whose design relies extensively on method chaining.
  • PageObect.someFunction()
  • PageOject.someElement().click()
• Page Object Model is a Design Pattern which has become popular in test automation for enhancing test maintenance and reducing code duplication.
  
  • The "login" screen will have a "Login page object" that contains the selectors for elements on the page and functions that can be performed on that page.

Getting Started

1. Install Python3
2. Open the integrated terminal
3. Install dependencies noted in requirements.txt
   • In the integrated terminal run pip3 install -r requirements.txt
4. In the root folder create a new file called .env
5. Copy+Paste the following (changing the placeholder to your API Key)

   API_KEY="0123456789"
   

6. Save
7. Open headspin.ini and set your values
8. Save

Run Tests

AltUnity (Unity Mobile Apps)

The apk is included as part of this sample repo.

• In the integrated terminal run behave

Python Tips and Tricks

Clear Dependencies

• [mac] In the integrated terminal run pip3 freeze | xargs pip uninstall -y
• [win] In the integrated terminal run pip3 uninstall -y -r <(pip freeze)

Hide pycache from VS Code's Explorer

1. Open the Command Pallete
2. Search for and then select "Preferences: Open User Settings"
3. Search for files.exclude
4. Select the "Add Pattern" button
5. Enter **/__pycache__