POM.Selenium 1.0.0

About

POM Selenium is a microframework and extensible wrapper for Selenium Webdriver which combines suitable patterns such as Page Object Models + Inversion of Control with Dependency Injection + Fluent Interface + Design by Contract, making web applications testing easy.

Features

🙌No need to write code: You'll find a set of generic methods that have been designed for general purposes.
🗐 Auto-Generated Pages: create a configuration file, configure pages selectors and have your class files ready.
🛠️Extensible: Is something missing? Expand the functionality to your need.

Instalation

This package is also available on Nuget Packages: https://www.nuget.org/packages/POM.Selenium

Nuget

Install-Package POM.Selenium

.NET CLI

dotnet add package POM.Selenium

Getting Started

Setting up

The basic template for "Pages" setup is done through configuration file such as appsettings.json declaring a new section. Once it's done, the application will try to generate these pages based on the following convention:

appsettings.json file:

{
  "Pages": {
    "NugetPages": {
      "HomePage": { ... },
      "SignInPage": { ... },
      "PackagesPage": { ... }
    },
    "AmazonPages": {
      "LoginPage": { ... },
      "CartPage": { ... },
      "CustomerServicePage": { ... }
    }
  }
}

Program.cs file:

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureServices((hostContext, services) =>
            {
                // Adding POM.Selenium with auto generated pages - requires the first execution
                services.AddPomSelenium(autoGeneratePages:true);
                // Setting up IWebDriver for this test
                services.AddSingleton<IWebDriver, ChromeDriver>();
                // Setting up www.nuget.org testing pages
                services.AddTransient(s => s.AddPage<HomePage>());
                services.AddTransient(s => s.AddPage<SignInPage>());
                services.AddTransient(s => s.AddPage<PackagesPage>());
                // Setting up www.amazon.com testing pages
                services.AddTransient(s => s.AddPage<LoginPage>());
                services.AddTransient(s => s.AddPage<CartPage>());
                services.AddTransient(s => s.AddPage<CustomerServicePage>());
            });
}

Folder structure resulting:

[MyProject Folder]
├── bin
├── obj
├── Pages
│   ├── AmazonPages
│   │   ├── CartPage.cs
│   │   ├── CustomerServicePage.cs
│   │   └── LoginPage.cs
│   └── NugetPages
│       ├── HomePage.cs
│       ├── PackagesPage.cs
│       └── SignInPage.cs
├── appsettings.json
├── Program.cs
└── MyProject.csproj