cuixiao / atata

C#/.NET test automation framework for web

Atata

C#/.NET web UI test automation full featured framework based on Selenium WebDriver. It uses fluent page object pattern.

Supports .NET Framework 4.0+ and .NET Core/Standard 2.0+.

• What's new in v1.2.0

Features

• WebDriver. Based on Selenium WebDriver and preserves all its features.
• Page Object Model. Provides unique fluent page object pattern that is easy to implement and maintain.
• Components. Contains a rich set of ready to use components for inputs, tables, lists, etc.
• Integration. Works on any .NET test engine (e.g. NUnit, xUnit, SpecFlow) as well as on CI systems like Jenkins, Azure DevOps or TeamCity.
• Triggers. A bunch of triggers to bind with different events to extend component behavior.
• Verification. A set of fluent assertion methods and triggers for the component and data verification.
• Configurable. Defines the default component search strategies as well as additional settings. Atata.Configuration.Json provides flexible JSON configurations.
• Reporting/Logging. Built-in customizable logging and screenshot capturing functionality.
• Extensible. Atata.Bootstrap and Atata.KendoUI packages have a set of ready to use components. Framework supports any kind of extending.

Usage

Page Object

Simple sign-in page object for https://demo.atata.io/signin page:

using Atata;

namespace SampleApp.UITests
{
    using _ = SignInPage;

    [Url("signin")] // Relative URL of the page.
    [VerifyH1] // Verifies that H1 header text equals "Sign In" upon page object initialization.
    public class SignInPage : Page<_>
    {
        [FindByLabel] // Finds <label> element containing "Email" (<label for="email">Email</label>), then finds text <input> element by "id" that equals label's "for" attribute value.
        public TextInput<_> Email { get; private set; }

        [FindById("password")] // Finds password <input> element by id that equals "password" (<input id="password" type="password">).
        public PasswordInput<_> Password { get; private set; }

        [FindByValue(TermCase.Title)] // Finds button element by value that equals "Sign In" (<input value="Sign In" type="submit">).
        public Button<_> SignIn { get; private set; }
    }
}

Test

Usage in the test method:

[Test]
public void SignIn()
{
    Go.To<SignInPage>().
        Email.Set("[email protected]").
        Password.Set("abc123").
        SignIn.Click();
}

Setup

[SetUp]
public void SetUp()
{
    AtataContext.Configure().
        UseChrome().
        UseBaseUrl("https://demo.atata.io/").
        Build();
}

Find out more on Atata usage. Check atata-framework/atata-samples for different Atata test scenario samples.

Demo

Demo atata-framework/atata-sample-app-tests UI tests application demonstrates different testing approaches and features of Atata Framework. It covers main Atata features: page navigation, data input and verification, interaction with pop-ups and tables, logging, screenshot capture, etc.

Sample test:

[Test]
public void User_Create()
{
    string firstName, lastName, email;
    Office office = Office.NewYork;
    Gender gender = Gender.Male;

    Login().
        New().
            ModalTitle.Should.Equal("New User").
            General.FirstName.SetRandom(out firstName).
            General.LastName.SetRandom(out lastName).
            General.Email.SetRandom(out email).
            General.Office.Set(office).
            General.Gender.Set(gender).
            Save().
        Users.Rows[x => x.FirstName == firstName && x.LastName == lastName && x.Email == email && x.Office == office].View().
            Header.Should.Equal($"{firstName} {lastName}").
            Email.Should.Equal(email).
            Office.Should.Equal(office).
            Gender.Should.Equal(gender).
            Birthday.Should.Not.Exist().
            Notes.Should.Not.Exist();
}

Documentation

Find out more on Atata Docs and on Getting Started page in particular.

Tutorials

You can also check the following tutorials:

• Atata - C# Web Test Automation Framework - an introduction to Atata Framework.
• Verification of Page - how to verify web page data using different approaches of Atata Framework.
• Verification of Validation Messages - how to verify validation messages on web pages using Atata Framework.
• Handle Confirmation Popups - how to handle different confirmation popups using Atata Framework.
• Multi-Browser Configuration via Fixture Arguments - how to configure multi-browser tests application using NUnit fixture arguments.
• Visual Studio Team Services Configuration - how to configure Atata test automation build on Visual Studio Team Services using any browser.

Contact

Feel free to ask any questions regarding Atata Framework. Any feedback, issues and feature requests are welcome.

You can ask a question on Stack Overflow using atata tag.

If you faced an issue please report it to Atata Issues, write to Atata Gitter or just mail to [email protected].

Links

• Stack Overflow: https://stackoverflow.com/questions/tagged/atata
• Slack: https://atata-framework.slack.com
• Atata Issues: https://github.com/atata-framework/atata/issues
• Atata Gitter: https://gitter.im/atata-framework/atata
• Twitter: https://twitter.com/AtataFramework
• YouTube: https://www.youtube.com/channel/UCSNfv8sKpUR3a6dqPVy54KQ

Author

Contact me if you need a help in test automation using Atata Framework, or if you are looking for a quality test automation implementation for your project.

• Email: [email protected]
• Skype: e.shunevich
• LinkedIn: https://www.linkedin.com/in/yevgeniy-shunevych
• Gitter: https://gitter.im/YevgeniyShunevych

License

Atata is an open source software, licensed under the Apache License 2.0. See LICENSE for details.