Skip to content

Automation Testware is a flexible solution that implements the interaction and management of the main automation engines for Web (Selenium), Mobile (Appium) and Desktop (WinAppDriver) environments. You can check one example of the Allure reporting engine in the following URL:

License

Notifications You must be signed in to change notification settings

ERNI-Academy/net6-automation-testware

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Continuous-Integration

Quality Gate Status

All Contributors

About

Automation Testware is a flexible solution that implements the interaction and management of the main automation engines for Web (Selenium), Mobile (Appium) and Desktop (WinAppDriver) environments.

TestWare provides a robust and scalable core that can be reused by any automation project in order to abstract the core automation implementation focusing only on its business needs.

This solution comes from the need to standarize and reuse the common usage and extension of the different automation engines.

With this action the maintenance decreases and the robustness increases.

Built With

Features

Testware provides capabilities to automate:

  • Websites (using Selenium)

    • Supported Browsers:
      Chrome Firefox IE Edge
  • Websites (using Selenoid)

    • Supported Browsers:
      Chrome Firefox Edge
  • Mobile Applications (using Appium)

  • Windows Desktop applications (using WinAppDriver)

  • API Rest (using Restsharp)

Testware provides capabilities to report:

  • HTML (using extent report)

Evidence collection:

  • Screenshots after each step (for web, mobile applications and windows desktop applications)

Getting Started

  1. Clone this repository
  2. Open solution with visual studio
  3. Build the solution

Start automation project

  1. Create a test project using any desired runner.
  2. Implement a LifeCycle handler class
    • It should inherit from AutomationLifeCycleBase.
    • GetTestWareComponentAssemblies: Returns the assemblies list that contains the TestWareComponents.
    • GetTestWareEngines: Returns the engines instances that will be used at the current Automation project.
    • GetConfiguration: Returns the configuration object defined at .json file.
 public class LifeCycle : AutomationLifeCycleBase
    {
        protected override IEnumerable<Assembly> GetTestWareComponentAssemblies()
        {
            IEnumerable<Assembly> assemblies = new[]
            {
                typeof(LifeCycle).Assembly
            };

            return assemblies;
        }

        protected override IEnumerable<IEngineManager> GetTestWareEngines()
        {
            IEnumerable<IEngineManager> engines = new[]
            {
                new SeleniumManager()
            };

            return engines;
        }

        protected override TestConfiguration GetConfiguration()
        {
            var configManager = new ConfigurationManager();
            return configManager.ReadConfigurationFile("TestConfiguration.Web.json");
        }
    }
  1. Add calls to the lifecycle class on the execution life cycles according

    • BeginTestExecution: Once at the very begining of execution. It initializes the Core.
      • BeginTestSuite (optional): Once at the begining of the test suite/feature.
        • BeginTestCase: Once at the begining of a test case. It Initialize the Engines
          • BeginTestStep (optional): Once at the begining of test step.
          • EndTestStep (optional): Once at the end of test step. It generate evidences of execution (optional)
        • EndTestCase: Once at the end of test case. It dispose the engine
      • EndTestSuite: Once at the end of test suite.
    • EndTestExecution: Once at the end of the execution
  2. Implement business automation objects (i.e Pages)

    • Components should inherit from ITestWareComponent in order to be registered
 public interface IBusinessPage : ITestWareComponent
    {
        void BusinessAction();
        void BusinessAssertion();
    }
  1. Design test cases. (Is it possible to access the business objects resolving from the ContainerManager)
        using (var scope = ContainerManager.Container.BeginLifetimeScope())
        {
            businessPage = scope.Resolve<IBusinessPage>();
            businessPage.BusinessAction();
        }

Configuration file example

{
    "Configurations": [
        {
            "Tag": "API",
            "Capabilities": [
                {
                    "Name": "API",
                    "BaseUrl": "https://newton.vercel.app/api/v2/",
                    "Timeout": 3000
                }
            ]
        },
        {
            "Tag": "WebDriver",
            "Capabilities": [
                {
                    "Name": "WebDriver",
                    "Driver": "Chrome",
                    "Arguments": [
                        "--start-maximized"
                    ]
                }
            ]
        },
        {
            "Tag": "RemoteDriver",
            "Capabilities": [
            {
                "Name": "Chrome",
                "Uri": "http://localhost:4444/wd/hub",
                "BrowserName": "Chrome",
                "BrowserVersion": "111.0",
                "Resolution": "1920x1080x24",
                "EnableLog": false,
                "EnableVnc": true,
                "EnableVideo": false,
                "CommandTimeOutInMinutes": 5,
                "Arguments": [
                "--start-maximized"
                ]
            },
            {
                "Name": "Firefox",
                "Uri": "http://localhost:4444/wd/hub",
                "BrowserName": "Firefox",
                "BrowserVersion": "110.0",
                "Resolution": "1920x1080x24",
                "EnableLog": false,
                "EnableVnc": true,
                "EnableVideo": false,
                "CommandTimeOutInMinutes": 5,
                "Arguments": [
                "--start-maximized"
                ]
            },
            {
                "Name": "Edge",
                "Uri": "http://localhost:4444/wd/hub",
                "BrowserName": "Edge",
                "BrowserVersion": "111.0",
                "Resolution": "1920x1080x24",
                "EnableLog": false,
                "EnableVnc": true,
                "EnableVideo": false,
                "CommandTimeOutInMinutes": 5,
                "Arguments": [
                "--start-maximized"
                ]
            }
            ]
        },
        {
            "Name": "Appiumdriver",
            "AppiumUrl": "http://127.0.0.1:4723/wd/hub",
            "ApkUrl": "https://github.com/saucelabs/sample-app-mobile/releases/download/2.7.1/Android.SauceLabs.Mobile.Sample.app.2.7.1.apk",
            "ApkPath": "C:\\workspace\\services\\AutomationFramework\\AutomationFramework.DataEntities\\Binaries\\SwagLabs.apk",
            "CommandTimeOutInMinutes": 5,
            "DeviceName": "emulator-5554",
            "PlatformName": "Android",
            "Options": [
                {
                "Name": "fullReset",
                "Value": false
                },
                {
                "Name": "noReset",
                "Value": true
                },
                {
                "Name": "appActivity",
                "Value": "com.swaglabsmobileapp.MainActivity"
                },
                {
                "Name": "unicodeKeyboard",
                "Value": true
                },
                {
                "Name": "resetKeyboard",
                "Value": true
                },
                {
                "Name": "autoAcceptAlerts",
                "Value": true
                },
                {
                "Name": "autoGrantPermissions",
                "Value": true
                },
                {
                "Name": "newCommandTimeout",
                "Value": 500
                }
            ]
        },
        {
            "Tag": "WinAppDriver",
            "Capabilities": [

                {
                    "Name":  "Notepad",
                    "ApplicationPath": "C:\\Windows\\System32\\notepad.exe",
                    "ApplicationName": "Notepad",
                    "ApplicationClassName": "Notepad",
                    "WinAppDriverUrl": "http://127.0.0.1:4723/wd/hub",
                    "CommandTimeOutInMinutes": 5
                },
                {
                    "Name":  "Calculator",
                    "ApplicationPath": "C:\\Windows\\System32\\calc.exe",
                    "ApplicationName": "Calculator",
                    "ApplicationClassName": "",
                    "WinAppDriverUrl": "http://127.0.0.1:4723/wd/hub",
                    "CommandTimeOutInMinutes": 5
                }
            ]
        }    
    ],
    "TestResultPath": "C:\\workspace\\ERNI\\results\\"
}

Contributing

Please see our Contribution Guide to learn how to contribute.

License

MIT

Copyright Β© 2022 ERNI - Swiss Software Engineering

Code of conduct

Please see our Code of Conduct

Stats

https://repobeats.axiom.co/api/embed/7ebe11822a109c9c80ee0470d57be9997ac78837.svg

Follow us

Twitter Follow Twitch Status YouTube Channel Views Linkedin

Contact

πŸ“§ [email protected]

Contributors ✨


Didac Lopez

πŸ’» πŸ–‹ πŸ“– 🎨 πŸ€” 🚧 ⚠️ πŸ’‘ πŸ‘€

mg-diego

πŸ’» πŸ–‹ πŸ“– 🎨 πŸ€” 🚧 ⚠️ πŸ’‘ πŸ‘€

Rabosa616

πŸ’» πŸ–‹ πŸ“– 🎨 πŸ€” 🚧 ⚠️ πŸ’‘ πŸ‘€

Carmen Avram

πŸ’» πŸ–‹ πŸ“– 🎨 πŸ€” 🚧 ⚠️ πŸ’‘ πŸ‘€

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!

About

Automation Testware is a flexible solution that implements the interaction and management of the main automation engines for Web (Selenium), Mobile (Appium) and Desktop (WinAppDriver) environments. You can check one example of the Allure reporting engine in the following URL:

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages