TestStack / White

DEPRECATED - no longer actively maintained
Other
1.02k stars 485 forks source link

DEPRECATED - no longer actively maintained

The White project lacks maintainers and community activity. As last maintainer, I tried to bring back some life to White but quickly ended up tripping over issues with the old architecture of this project which prevented implementing some features I wanted (eg. UIA3 support).

For that reason, a new project called FlaUI was born. FlaUI is a complete rewrite from scratch that supports UIA2 (Managed) and UIA3 (Interop), is easily extensible, supports .NET Core and .NET Standard and allows accessing all UIA features up to the latest Windows SDK.

FlaUI is now mature enough to be the successor of White and is already widely used. There is also an adapter available that allows re-using some of the syntax of White but execute it in FlaUI (feel free to help improving it).

Thanks for all the creators and maintainers of White for this great project but now it is time to head over to FlaUI. Feel free to raise questions, problems, improvement ideas in gitter or in FlaUIs issues.

I hope to see you there.

TestStack.White

White is a framework for automating rich client applications based on Win32, WinForms, WPF, Silverlight and SWT (Java) platforms. It is .NET based and does not require the use of any proprietary scripting languages. Tests/automation programs using White can be written with whatever .NET language, IDE and tools you are already using. White provides a consistent object-oriented API, hiding the complexity of Microsoft's UIAutomation library (on which White is based) and windows messages.

Join the chat at https://gitter.im/TestStack/White

Introduction

Project white has been inactive for some time, but still has many users and is a great UI automation framework.

TestStack has brought this project into it's offering to try and breathe some life into Project White.

Build Status

Master Branch

Build status Test status Documentation Status

UIAComWrapper Branch

Build status Test status

Contributing

White needs contributors to keep improving. There is plenty to do:

Getting Started

Install TestStack.White from NuGet

PM> Install-Package TestStack.White

Now download one or more of these tools. Each of these has their own strengths and weaknesses and generally using more than one to view the automation properties will be required.

See the sample apps here for examples of using White in both WinForms and WPF.

Documentation

Documentation Status

Change Log

http://docs.teststack.net/White/ChangeLog.html

Documentation

http://teststackwhite.readthedocs.org/en/latest

Discussion Group

https://groups.google.com/forum/#!forum/teststack_white

Sample Applications

https://github.com/TestStack/White/tree/master/src/Samples

Whites UI Tests

https://github.com/TestStack/White/tree/master/src/TestStack.White.UITests

Contributions to White's documentation is welcome

Contributing to White

Pull Requests for White are welcome, please include either Unit or UI Tests covering your changes if possible.

Setting up Git

http://jake.ginnivan.net/setting-up-git

Contributing to a TestStack Project

http://teststack.azurewebsites.net/Contributing.html

Reporting Issues

If possible, please add a failing test to TestStack.White.UITests when you report an issue, this will allow me to fix it, and ensure there is no regression later.

Also include the following information:

Credits

Thanks to Thoughtworks and specifically Vivek Singh for starting this project. We have got permission from Vivek to continue this project.

TestStack.White will supersede the following repositories:
http://white.codeplex.com/
https://github.com/petmongrels/white
https://code.google.com/p/white-project/