English description | Описание на русском
Winium for Desktop
![GitHub license](https://img.shields.io/badge/license-MPL 2.0-blue.svg?style=flat-square)
Winium.Desktop is an open source test automation tool for automated testing of Windows application based on WinForms and WPF platforms.
Supported Platforms
- WinForms
- WPF
For Windows Phone 8.1 test automation tool see Windows Phone Driver. For Windows Phone 8 Silverlight test automation tool see Windows Phone Driver.
Why Winium?
You have Selenium WebDriver for testing of web apps, Appium for testing of iOS and Android apps. And now you have Selenium-based tools for testing of Windows apps too. What are some of the benefits? As said by Appium:
- You can write tests with your favorite dev tools using any WebDriver-compatible language such as Java, Objective-C, JavaScript with Node.js (in promise, callback or generator flavors), PHP, Python, Ruby, C#, Clojure, or Perl with the Selenium WebDriver API and language-specific client libraries.
- You can use any testing framework.
Requirements
- Microsoft .NET Framework 4.5.1
Quick Start
-
Write your tests using you favorite language. In your tests use
app
desired capability to set path to tested app's exe file. Here is python example:# put it in setUp self.driver = webdriver.Remote(command_executor='http://localhost:9999', desired_capabilities={'app': 'C:\\testApp.exe', 'args': '-port 345'}) # put it in test method body win = self.driver.find_element_by_id('WpfTestApplicationMainWindow') win.find_element_by_id('SetTextButton').click() assert 'CARAMBA' == self.driver.find_element_by_id('MyTextBox').text
-
Start
Winium.Desktop.Driver.exe
(download release from github or build it yourself) -
Run your tests and watch the magic happening
How it works
Winium.Desktop.Driver implements Selenium Remote WebDriver and listens for JsonWireProtocol commands. It is responsible for automation of app under test using Winium.Cruciatus.
Contributing
Contributions are welcome!
- Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
- Fork the repository to start making your changes to the master branch (or branch off of it).
- We recommend to write a test which shows that the bug was fixed or that the feature works as expected.
- Send a pull request and bug the maintainer until it gets merged and published.
😃
Contact
Have some questions? Found a bug? Create new issue or contact us at [email protected]
License
Winium is released under the MPL 2.0 license. See LICENSE for details.