{"id":30593052,"url":"https://github.com/alttester/examples-python-android-with-appium-alttrashcat","last_synced_at":"2026-03-27T02:27:55.822Z","repository":{"id":88979081,"uuid":"532959740","full_name":"alttester/EXAMPLES-Python-Android-with-Appium-AltTrashCat","owner":"alttester","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-23T09:47:37.000Z","size":660625,"stargazers_count":1,"open_issues_count":2,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-23T10:42:24.460Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alttester.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-09-05T15:32:24.000Z","updated_at":"2024-07-04T08:20:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"c446d34c-d590-4342-9357-c33abee3fe94","html_url":"https://github.com/alttester/EXAMPLES-Python-Android-with-Appium-AltTrashCat","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alttester/EXAMPLES-Python-Android-with-Appium-AltTrashCat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alttester%2FEXAMPLES-Python-Android-with-Appium-AltTrashCat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alttester%2FEXAMPLES-Python-Android-with-Appium-AltTrashCat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alttester%2FEXAMPLES-Python-Android-with-Appium-AltTrashCat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alttester%2FEXAMPLES-Python-Android-with-Appium-AltTrashCat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alttester","download_url":"https://codeload.github.com/alttester/EXAMPLES-Python-Android-with-Appium-AltTrashCat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alttester%2FEXAMPLES-Python-Android-with-Appium-AltTrashCat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272734612,"owners_count":24984277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-29T18:05:24.975Z","updated_at":"2026-03-27T02:27:55.817Z","avatar_url":"https://github.com/alttester.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TrashCat Testing with AltTester® and Appium\n\nThis project contains automated tests for the TrashCat game using AltTester® with Appium. The tests validate game functionality through the AltTester® Unity SDK.\n\n## What This Project Contains\n\n- **Page Object Models** (`pages/`): Reusable page objects for different game screens\n- **Test Suite** (`tests/`): Automated test cases for the TrashCat game\n- **Test Runner Script** (`run_tests_android.sh`): Automated script that starts Appium, installs the app, and runs all tests\n\n## Prerequisites\n\nBefore running the tests, you need:\n\n1. **AltTester® Desktop** (version 2.0.0 or later)\n   - Download from: https://alttester.com/downloads/\n   - ❗ **Must be running during test execution**\n\n2. **Appium Server Setup**\n   - Follow the setup guide: https://alttester.com/docs/sdk/latest/pages/alttester-with-appium.html\n\n3. **Python Environment**\n   - Python 3.x installed\n   - Dependencies will be installed automatically by the script\n\n## Setup Instructions\n\n### Step 1: Build the TrashCat APK\n\nYou need to create an instrumented `TrashCat.apk` file:\n\n1. Clone the TrashCat Unity project with AltTester® Unity SDK:\n   ```bash\n   git clone --recursive https://github.com/alttester/trashcat.git\n   ```\n\n2. Open the project in Unity\n\n3. Instrument the application using the latest version of AltTester® Unity SDK\n   - Detailed instrumentation instructions: https://alttester.com/docs/sdk/latest/pages/get-started.html\n\n4. Build the Android APK from Unity\n\n### Step 2: Add the APK to This Project\n\n1. Create an `app` folder in the project root (if it doesn't exist):\n   ```bash\n   mkdir app\n   ```\n\n2. Copy your instrumented `TrashCat.apk` into the `app/` folder:\n   ```\n   app/\n   └── TrashCat.apk\n   ```\n\n## Running the Tests\n\n1. **Start AltTester® Desktop**\n   - Open the AltTester® Desktop application\n\n2. **Connect Your Android Device or Emulator**\n   - Ensure your device is connected via USB with USB debugging enabled, OR\n   - Start an Android emulator\n\n3. **Run the Test Script**\n   ```bash\n   ./run_tests_android.sh\n   ```\n\n### What the Script Does\n\nThe `run_tests_android.sh` script automatically:\n- Installs/updates all Python dependencies from `requirements.txt`\n- Starts the Appium server\n- Installs the TrashCat app from the `app/` folder onto your device\n- Executes all test cases in the `tests/` folder\n- Generates a test report\n\n## Additional Resources\n\n- [AltTester® Documentation](https://alttester.com/docs/sdk/latest/)\n- [AltTester® with Appium Guide](https://alttester.com/docs/sdk/latest/pages/alttester-with-appium.html)\n- [TrashCat Unity Project](https://github.com/alttester/trashcat)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falttester%2Fexamples-python-android-with-appium-alttrashcat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falttester%2Fexamples-python-android-with-appium-alttrashcat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falttester%2Fexamples-python-android-with-appium-alttrashcat/lists"}