Giter Club home page Giter Club logo

accessibility's Introduction

Accessibility: Wrapper for the Accessibility API

accessibility is a Python module that wraps the Accessibility API for Mac OS X. It can be used to query and modify attributes of running applications, as well as watch for a variety of notifications. The source code and several examples (in the examples directory) are hosted on GitHub.

The module should compile under recent versions of both Python 2 and 3, and work with Mac OS X 10.8.x and 10.9.x. In addition, to compile the module on version 10.9.0 or later of OS X, you will need to have the Xcode IDE installed.

Building

The module can be compiled using the traditional python setup.py clean build install provided by setuptools.

Documentation

The module includes extensive docstrings, complete with examples in many cases. These can be can be browsed using Python's help command, or one can compile the Sphinx documentation. For the latter:

  1. cd docs
  2. Initialize the git submodule with git submodule update --init --recursive to retrieve the custom Sphinx theme.
  3. make html and then browse the documentation in docs/_build/html.

License

This project is under the ISC License. See the LICENSE.txt file for details.

accessibility's People

Contributors

atheriel avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

accessibility's Issues

missing setup step

Hi,

great library! I ran into a small issue with the setup when I tried to generate the documentation. Before I could run step 3 successfully I had to run:

# being in <repo>/docs
cd theme
git submodule update --init --recursive

Only then I was able to run make html, since the theme was not there and I received the build error:

Theme error:
no theme named 'theme' found (missing theme.conf?)
make: *** [html] Error 1

So, you might want to add this to the setup steps.

Best,
Marco

Is there anyway to get the element class name?

I seriously can't thank you enough for making this. It has saved me a tremendous amount of time. I'm not too familiar with Objective-C, but is there anyway to retrieve the element class name? I attached an example from the Accessibility Inspector GUI https://imgur.com/ySZirRA Here the Element Class is CalcWindow. Is there anyway to get this? Figured it would be significantly easier to find children along the hierarchy.

Building on MacOS 10.12

In order to build the accessibility library on MacOS 10.12, I had to add following lines in setup.py.

elif mac_ver()[0].startswith('10.12'):
header_dir = '/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.12.sdk/System/Library/Frameworks/ApplicationServices.framework/Versions/A/Frameworks/HIServices.framework/Versions/A/Headers' # noqa

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.