Skip to content

Latest commit

 

History

History
52 lines (31 loc) · 3.42 KB

README.md

File metadata and controls

52 lines (31 loc) · 3.42 KB

AutoPyDriverServer

AutoPyDriverServer is a (test) automation tool via image recognition that provides a Selenium WebDriver API via the webdriver JSON wire protocol to drive to the AutoPy tool/library running as a server. It is adapted from the old Appium server Python implementation.

AutoPyDriverServer uses the Bottle micro web-framework, and has the goal of working with all off the shelf Selenium client libraries.

There are two benefits to testing with AutoPyDriverServer:

1: With AutoPyDriverServer, you are able to write your test in your choice of programming language, using the Selenium WebDriver API and language-specific client libraries. If you only used AutoPy, you would be required to write tests in Python, or interface to some Python code to call AutoPy.

2: AutoPyDriverServer uses the AutoPy library for Python, which provides cross-plaform support for some image recognition capability and mouse, keyboard manipulation. If you already use AutoPy, this will be a nice benefit.

Quick Start

To get started, clone the repo:

git clone git://github.com/daluu/AutoPyDriverServer

Next, change into the 'autopydriverserver' directory, and install dependencies:
pip install -r linux_mac_requirements.txt
or
pip install -r windows_requirements.txt

For Windows, you may wish to manually install AutoPy module (dependency), which is not in the requirements file for Windows (above), as suggested by AutoPy author. Get the binary installer at https://pypi.python.org/pypi/autopy/

To launch a webdriver-compatible server, run:
python server.py

For additional parameter info, append the --help parameter

Example WebDriver API/client test usage against this server tool can be found in sample-code folder. To run the test, startup the server (with customized parameters as needed, recommend set address to 127.0.0.1) and review the example files' code before executing those scripts. Examples use Python WebDriver binding, but any language binding will do.

NOTES/Caveats

AutoPyDriverServer is simply a WebDriver server interface to AutoPy. Issues you experience may usually be the result of an issue with AutoPy rather than AutoPyDriverServer itself. If you are experienced with Python, it would be wise to test your issue/scenario using native Python AutoPy API to confirm whether the issue is with AutoPy or AutoPyDriverServer. The source code of AutoPyDriverServer will point you to the appropriate AutoPy API or see the AutoPy Python API specifics for debugging.

The server isn't flawless and may at times appear to crash on you (on Windows, resulting ina popup about program hanging and whether you want to close it or do something else), upon receivng some WebDriver command request. But for the most part or most of the time, it works.

WebDriver API/command support and mapping to AutoPy API

See WebDriver API command support and mapping to AutoPy API

Contributing

Fork the project, make a change, and send a pull request!

Or as a user, try it out, provide your feedback, submit bugs/enhancement requests.