{"id":15174130,"url":"https://github.com/testcentricity/tc_mac_calculator_demo","last_synced_at":"2026-01-28T10:03:02.768Z","repository":{"id":250627790,"uuid":"820713741","full_name":"TestCentricity/tc_mac_calculator_demo","owner":"TestCentricity","description":"This example uses TestCentricity™ For Apps gem to demonstrate MacOS desktop app functional testing of Apple's Calculator app.","archived":false,"fork":false,"pushed_at":"2025-04-22T04:16:24.000Z","size":283,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-31T22:09:34.040Z","etag":null,"topics":["appium","cucumber","macos-app-automation","ruby","screen-object-model"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/TestCentricity.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":"2024-06-27T03:18:47.000Z","updated_at":"2024-11-13T22:37:28.000Z","dependencies_parsed_at":"2024-07-29T00:59:04.122Z","dependency_job_id":"b97fd15b-da07-4a69-b780-c3c688ff0890","html_url":"https://github.com/TestCentricity/tc_mac_calculator_demo","commit_stats":{"total_commits":5,"total_committers":1,"mean_commits":5.0,"dds":0.0,"last_synced_commit":"848c249cfc6e0b0717c45fea671c76883d31098d"},"previous_names":["testcentricity/tc_mac_calculator_demo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TestCentricity/tc_mac_calculator_demo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TestCentricity%2Ftc_mac_calculator_demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TestCentricity%2Ftc_mac_calculator_demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TestCentricity%2Ftc_mac_calculator_demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TestCentricity%2Ftc_mac_calculator_demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TestCentricity","download_url":"https://codeload.github.com/TestCentricity/tc_mac_calculator_demo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TestCentricity%2Ftc_mac_calculator_demo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28844011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T07:39:25.367Z","status":"ssl_error","status_checked_at":"2026-01-28T07:39:24.487Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["appium","cucumber","macos-app-automation","ruby","screen-object-model"],"created_at":"2024-09-27T11:24:32.663Z","updated_at":"2026-01-28T10:03:02.751Z","avatar_url":"https://github.com/TestCentricity.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tc_mac_calculator_demo\n\nThis is a Cucumber based sample test suite and framework utilizing the TestCentricity™ For Apps gem and a screen-object\nmodel architecture for MacOS desktop app functional testing of version 10.16 of Apple's MacOS Calculator app, which is\nincluded with MacOS Ventura.\n\n![MacOS Calculator app](https://raw.githubusercontent.com/TestCentricity/tc_mac_calculator_demo/main/.github/images/CalcApp.png)\n\nThe primary purpose of this example test suite and framework is to demonstrate how to implement an automated testing solution\nfor a MacOS desktop app using Cucumber, Appium version 2.x, and the TestCentricity™ For Apps gem. This test suite includes\nscenarios for interacting with and validating the following functionality:\n  * Entering data via buttons or keyboard\n  * Menu bars and menus via mouse actions and keyboard shortcuts\n  * Invoking application dialogs and secondary windows\n\n\n## Gem Dependencies:\n\ncucumber  [![Gem Version](https://badge.fury.io/rb/cucumber.svg)](https://badge.fury.io/rb/cucumber)\n\ntestcentricity_apps  [![Gem Version](https://badge.fury.io/rb/testcentricity_apps.svg)](https://badge.fury.io/rb/testcentricity_apps)\n\n\n## Supporting Documentation\n\n[TestCentricity For Apps Framework - testcentricity_apps gem](https://rubygems.org/gems/testcentricity_apps)\n\n[TestCentricity For Apps - documentation](http://www.rubydoc.info/gems/testcentricity_apps/)\n\n\n## Prerequisites to running tests:\n\nIn order for Cucumber to execute the features and scenarios in the `tc_mac_calculator_demo` test automation project, you must\ninstall Appium version 2.x, XCode, and the Appium Mac2 driver on the Mac computer host where the tests will be executed.\n\n\n## Instructions for running tests\n\nIn order for Cucumber to execute features or scenarios from the `tc_mac_calculator_demo` test automation project, the`test_context`\nmust be specified in the Cucumber command line at runtime. There are 2 test execution profiles, or `test_context`, that are\nsupported (they are defined in `cucumber.yml`):\n* `calc_bat`  - Run the Calculator Build Acceptance Test (BAT) suite\n* `calc_regress`  - Run Calculator full regression test suite\n\n1. To run the Cucumber BAT suite, execute the following command in the Terminal:\n\n        bundle exec cucumber -p calc_bat\n\n   ℹ️ **NOTE:**\n    * To have Cucumber generate HTML formatted test results, append `-p report` to the above command line arguments.\n\n   For example, to execute the BAT suite with test results being logged to an HTML test results file, execute the following\n   command in the Terminal:\n\n        bundle exec cucumber -p calc_bat -p report\n\n   To execute the regression test suite, execute the following command in the Terminal:\n\n        bundle exec cucumber -p calc_regress\n\n   ℹ️ **NOTE:**\n    * Appium will automatically be started prior to tests being run on locally hosted simulators.\n\n2. As the Cucumber tests are executing, the Terminal will display the lines of each feature file and scenario as they run\n   in real-time.\n\n3. Upon completion of test execution, the Terminal will display the final test results.\n\n4. If you specified in the command line that HTML formatted test results should be generated (`-p report`), you can view\n   them by opening the `reports` folder in the `tc_mac_calculator_demo` project directory, and selecting the `test_results.html`\n   file. Right-clicking on the `test_results.html` file will display a popup menu. Select the **Open in Browser** menu\n   item, and then select a web browser from the popup sub menu that appears. The formatted test results will open in the\n   web browser that you selected.\n\n\n## Detailed Documentation\n\nDetailed HTML documentation of the features, scenarios, and step definitions for the `tc_mac_calculator_demo`project\ncan be accessed from the `index.html` file within the `doc` folder in the `tc_mac_calculator_demo` project folder:\n\n    📁 tc_mac_calculator_demo\n     ├── 📁 config\n     ├── 📁 doc\n     │   └── 📄 index.html\n     ├── 📁 features\n     └── 📁 reports\n\nTo view this documentation, navigate to the `index.html` file, right click on it, and select *Open in Browser*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestcentricity%2Ftc_mac_calculator_demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftestcentricity%2Ftc_mac_calculator_demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestcentricity%2Ftc_mac_calculator_demo/lists"}