Package: oa-atomacos
atomacos: Automated Testing on macOSThis library is a fork ofatomac.
It was created to provide a release with python 3 support because
there has not been a releasesince 2013Atomacos is a library to enable GUI testing of macOS applications via the Apple Accessibility API.
Atomacos has direct access to the API viapyobjc. It's fast and easy to use to write tests.Getting startedRequirementsmacOSpyobjcSystemwide Accesibility enabledOn travis, it's only on 10.11 because we are able to enable accessibility API.If you experience issues, please open a ticket in theissue tracker.Enabling Systemwide AccessibilityCheck the checkbox:System Preferences > Universal Access > Enable access for assistive devices
System Preferences > Security & Privacy > Privacy > AccessibilityFailure to enable this will result inAXErrorAPIDisabledexceptions during some module usage.InstallingFor release$pipinstallatomacosFor pre-release$pipinstall--preatomacosUsage ExamplesOnce installed, you should be able to use it to launch an application:>>>importatomacos>>>atomacos.launchAppByBundleId('com.apple.Automator')This should launch Automator.Next, get a reference to the UI Element for the application itself:>>>automator=atomacos.getAppRefByBundleId('com.apple.Automator')>>>automator<atomacos.AXClasses.NativeUIElementAXApplicationAutomator>Now, we can find objects in the accessibility hierarchy:>>>window=automator.windows()[0]>>>window.AXTitleu'Untitled'>>>sheet=window.sheets()[0]Note that we retrieved an accessibility attribute from the Window object -AXTitle.
Atomacos supports reading and writing of most attributes.
Xcode's includedAccessibility Inspectorcan provide a quick way to find these attributes.There is a shortcut for getting the sheet object which
bypasses accessing it through the Window object.
Atomacos can search all objects in the hierarchy:>>>sheet=automator.sheetsR()[0]There are search methods for most types of accessibility objects.
Each search method, such aswindows,
has a corresponding recursive search function, such aswindowsR.The recursive search finds items that aren't just direct children, but children of children.
These search methods can be given terms to identify specific elements.
Note that*and?can be used as wildcard match characters in all search methods:>>>close=sheet.buttons('Close')[0]There are methods to search for UI Elements that match any number of criteria.
The criteria are accessibility attributes:>>>close=sheet.findFirst(AXRole='AXButton',AXTitle='Close')findFirstandfindFirstRreturn the first item found to match the criteria orNone.findAllandfindAllRreturn a list of all items that match the criteria or an empty list([]).Objects are fairly versatile.
You can get a list of supported attributes and actions on an object:>>>close.getAttributes()[u'AXRole',u'AXRoleDescription',u'AXHelp',u'AXEnabled',u'AXFocused',u'AXParent',u'AXWindow',u'AXTopLevelUIElement',u'AXPosition',u'AXSize',u'AXTitle']>>>close.AXTitleu'Close'>>>close.getActions()[u'Press']Performing an action is as natural as:>>>close.Press()Any action can be triggered this way.LinksLicenseIssuesSourceCodeChangesCommitspage has all changes to the project.Releasepage will also outline changesThanksATOMacandPyObjC