-
Notifications
You must be signed in to change notification settings - Fork 131
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
108c4de
commit 5aa8531
Showing
546 changed files
with
9,142 additions
and
11,554 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,135 @@ | ||
| ## Ocaramba | ||
| <img align="left" src="https://user-images.githubusercontent.com/12324498/73060034-43ff2580-3e97-11ea-9100-748d0716eba7.png"> | ||
|
|
||
| **Cross-Platform C# Framework to automate tests using Selenium WebDriver** | ||
|
|
||
| [](https://marketplace.visualstudio.com/items?itemName=Ocaramba.Ocaramba1) | ||
|  | ||
| [](https://automate.browserstack.com/public-build/ZUJWZGNEczFZVFNVWUJvUHJ6Y0pYUTlnSG4rYnhKVXFUeSsrYzlTUEZIZz0tLWxZUStLVnNqWml6bXNpcm1FSUxMQ3c9PQ==--20fde38e51169fe9739fc60ce188f00ecdf0f1fe) | ||
| [](https://app.saucelabs.com/u/JRACZEK) | ||
|
|
||
| Test Framework was designed in Objectivity to propose a common way how people should create Selenium WebDriver tests. | ||
|
|
||
| <img align="left" src="https://user-images.githubusercontent.com/12324498/73060119-73159700-3e97-11ea-99d3-1b21584c6baa.png"> | ||
| Project API documentation can be found here: http://Accenture.github.io/Ocaramba<br /><br /> | ||
|
|
||
| <img align="left" src="https://github.com/Accenture/Ocaramba/wiki/images/ocarambadiagram.png"> | ||
|
|
||
| **It provides the following features:** | ||
| - .NET Frameworks 4.7.2 and .NET 8.0 supported | ||
| - Cross-Platform Windows, Linux and macOS systems supported | ||
| - Supports continuous integration tools like Azure DevOps, Teamcity, Jenkins and others. | ||
| - Ready for parallel tests execution, more details [here](https://github.com/Accenture/Ocaramba/wiki/Selenium%20Parallel%20tests%20execution) | ||
| - Possibility to use MSTest, NUnit or xUNIT framework | ||
| - Specflow ready | ||
| - Written entirely in C# | ||
| - Contains example projects how to use it | ||
| - Allows using Chrome, Firefox, Edge Chromium, Safari or Internet Explorer | ||
| - Overrides browser profile preferences, pass arguments to browsers, installs browser extensions, loading default firefox profile, Headless mode, more details [here](https://github.com/Accenture/Ocaramba/wiki/Override-browser-profile-preferences,-install-browser-extensions,-Headless-mode) | ||
| - Extends Webdriver by additional methods like JavaScriptClick, WaitForAjax, WaitForAngular, etc., more details [here](http://Accenture.github.io/Ocaramba/html/d51aa97e-08b5-c0b6-6987-c10545a64ebd.htm) | ||
| - Automatically waits when locating element for specified time and conditions, GetElement method instead of Selenium FindElement, more details [here](http://Accenture.github.io/Ocaramba/html/3c09ca99-f931-c6c9-98fc-194eff6500ff.htm) | ||
| - Page Object Pattern | ||
| - Support for [SeleniumGrid](https://github.com/SeleniumHQ/selenium/wiki/Grid2), [Cross browser parallel test execution](https://github.com/Accenture/Ocaramba/wiki/Cross-browser-parallel-test-execution-with-SeleniumGrid-or-testing-Cloud-Providers) with [SauceLab](https://saucelabs.com/), [TestingBot](https://testingbot.com) and [Browserstack](https://www.browserstack.com/) more details [here](https://github.com/Accenture/Ocaramba/wiki/Selenium-Grid-support), Advanced Browser Capabilities and Options more details [here](https://github.com/Accenture/Ocaramba/wiki/Advanced-Browser-Capabilities-and-options) | ||
| - More common locators, e.g: ```"//*[@title='{0}' and @ms.title='{1}']"```, more details [here](https://github.com/Accenture/Ocaramba/wiki/More%20common%20locators) | ||
| - Verify - asserts without stop tests, more details [here](https://github.com/Accenture/Ocaramba/wiki/Verify-asserts-without-stop-tests) | ||
| - Measures average and 90 Percentile action times, more details [here](https://github.com/Accenture/Ocaramba/wiki/Performance%20measures) | ||
| - DataDriven tests from Xml, Csv and Excel files for NUnit and Xml, Csv for MSTest with examples, more details [NUnit](https://github.com/Accenture/Ocaramba/wiki/NUnit-DataDriven-tests-from-Xml,-CSV-and-Excel-files), [MsTest](https://github.com/Accenture/Ocaramba/wiki/MsTest-DataDriven-tests-from-Xml-and-CSV-files) | ||
| - Possibility to take full desktop (only .NET Framework), save page source, more details [here](https://github.com/Accenture/Ocaramba/wiki/Screen-shots---full-desktop---selenium---PageSource-saving) | ||
| - Visual Testing - browser screenshot of the element, more details [here](https://github.com/Accenture/Ocaramba/wiki/Visual-Testing) | ||
| - Logging with NLog, EventFiringWebDriver logs, more details [here](https://github.com/Accenture/Ocaramba/wiki/Logging) | ||
| - Files downloading (Firefox, Chrome), more details [here](https://github.com/Accenture/Ocaramba/wiki/Downloading%20files) | ||
| - Possibility to send [SQL](http://Accenture.github.io/Ocaramba/html/730c92c7-831a-4449-3938-16540cf259b8.htm) or [MDX](http://Accenture.github.io/Ocaramba/html/7de319df-06eb-1c79-8c2d-9c60aaf3ab85.htm) queries (only .NET Framework) | ||
| - Possibility of debugging framework installed from nuget package with [sourcelink](https://github.com/dotnet/sourcelink), more details [here](https://github.com/Accenture/Ocaramba/wiki/Debugging-Test.Automation-framework). | ||
| - AngularJS support, more details [here](https://github.com/Accenture/Ocaramba/wiki/Angular-support). | ||
| - Possibility to check for JavaScript errors from the browser, more details [here](https://github.com/Accenture/Ocaramba/wiki/Verifying-Javascript-Errors-from-browser). | ||
| - Instruction on how to run Ocaramba tests with Docker container, more details [here](https://github.com/Accenture/Ocaramba/wiki/Run-Ocaramba-tests-with-Docker-container). | ||
| - ExtentReports support, more details [here](https://github.com/Accenture/Ocaramba/wiki/ExtentReports-Support). | ||
|
|
||
| For all documentation, visit the [Ocaramba Wiki](https://github.com/Accenture/Ocaramba/wiki). | ||
|
|
||
| Projects examples of using Test Framework : | ||
| - Ocaramba.Tests.Angular for AngularJS | ||
| - Ocaramba.Tests.Features for Specflow | ||
| - Ocaramba.Tests.MsTest for MsTest | ||
| - Ocaramba.Tests.NUnit for NUnit | ||
| - Ocaramba.Tests.NUnitExtentReports for NUnit featuring test execution HTML report based on ExtentReports framework | ||
| - Ocaramba.Tests.xUnit for xUnit | ||
| - Ocaramba.Tests.PageObjects for Page Object Pattern | ||
| - Ocaramba.Documentation.shfbproj for building API documentation | ||
| - Ocaramba.Tests.CloudProviderCrossBrowser for cross browser parallel test execution with BrowserStack\SauceLabs\TestingBot\SeleniumGrid | ||
| - Ocaramba.UnitTests for unit test of framework | ||
|
|
||
| NUnit Example Test: | ||
|
|
||
| ```csharp | ||
| namespace Ocaramba.Tests.NUnit.Tests | ||
| { | ||
| using global::NUnit.Framework; | ||
|
|
||
| using Ocaramba.Tests.PageObjects.PageObjects.TheInternet; | ||
|
|
||
| [Parallelizable(ParallelScope.Fixtures)] | ||
| public class JavaScriptAlertsTestsNUnit : ProjectTestBase | ||
| { | ||
| [Test] | ||
| public void ClickJsAlertTest() | ||
| { | ||
| var internetPage = new InternetPage(this.DriverContext).OpenHomePage(); | ||
| var jsAlertsPage = internetPage.GoToJavaScriptAlerts(); | ||
| jsAlertsPage.OpenJsAlert(); | ||
| jsAlertsPage.AcceptAlert(); | ||
| Assert.AreEqual("You successfuly clicked an alert", jsAlertsPage.ResultText); | ||
| } | ||
| } | ||
| } | ||
|
|
||
| ``` | ||
|
|
||
| NUnit Example Page Object: | ||
|
|
||
| ```csharp | ||
| namespace Ocaramba.Tests.PageObjects.PageObjects.TheInternet | ||
| { | ||
| using System; | ||
| using System.Globalization; | ||
|
|
||
| using NLog; | ||
|
|
||
| using Ocaramba; | ||
| using Ocaramba.Extensions; | ||
| using Ocaramba.Types; | ||
| using Ocaramba.Tests.PageObjects; | ||
|
|
||
| public class InternetPage : ProjectPageBase | ||
| { | ||
| private static readonly Logger Logger = LogManager.GetCurrentClassLogger(); | ||
|
|
||
| /// <summary> | ||
| /// Locators for elements | ||
| /// </summary> | ||
| private readonly ElementLocator | ||
| linkLocator = new ElementLocator(Locator.CssSelector, "a[href='/{0}']"); | ||
|
|
||
| public InternetPage(DriverContext driverContext) : base(driverContext) | ||
| { | ||
| } | ||
|
|
||
| public JavaScriptAlertsPage GoToJavaScriptAlerts() | ||
| { | ||
| this.Driver.GetElement(this.linkLocator.Format("javascript_alerts")).Click(); | ||
| return new JavaScriptAlertsPage(this.DriverContext); | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
| #### Where to start? | ||
| ------------- | ||
| - See [Getting started](https://github.com/Accenture/Ocaramba/wiki/Getting%20started). | ||
|
|
||
| Checkout the code or get it from [nuget.org](https://www.nuget.org/packages?q=Ocaramba) | ||
| - Ocaramba   | ||
| - OcarambaLite   - lighten version without selenium drivers | ||
|
|
||
| or download Ocaramba Visual Studio templates [](https://marketplace.visualstudio.com/items?itemName=Ocaramba.Ocaramba1) | ||
|
|
Oops, something went wrong.