OcarambaLite 4.2.1

dotnet add package OcarambaLite --version 4.2.1                
NuGet\Install-Package OcarambaLite -Version 4.2.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OcarambaLite" Version="4.2.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add OcarambaLite --version 4.2.1                
#r "nuget: OcarambaLite, 4.2.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install OcarambaLite as a Cake Addin
#addin nuget:?package=OcarambaLite&version=4.2.1

// Install OcarambaLite as a Cake Tool
#tool nuget:?package=OcarambaLite&version=4.2.1                

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

Ocaramba Templates Build status BrowserStack Status Sauce Test Status

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
  • 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
  • Extends Webdriver by additional methods like JavaScriptClick, WaitForAjax, WaitForAngular, etc., more details here
  • Automatically waits when locating element for specified time and conditions, GetElement method instead of Selenium FindElement, more details here
  • Page Object Pattern
  • Support for SeleniumGrid, Cross browser parallel test execution with SauceLab, TestingBot and Browserstack more details here, Advanced Browser Capabilities and Options more details here
  • More common locators, e.g: "//*[@title='{0}' and @ms.title='{1}']", more details here
  • Verify - asserts without stop tests, more details here
  • Measures average and 90 Percentile action times, more details here
  • DataDriven tests from Xml, Csv and Excel files for NUnit and Xml, Csv for MSTest with examples, more details NUnit, MsTest
  • Possibility to take full desktop (only .NET Framework), save page source, more details here
  • Visual Testing - browser screenshot of the element, more details here
  • Logging with NLog, EventFiringWebDriver logs, more details here
  • Files downloading (Firefox, Chrome), more details here
  • Possibility to send SQL or MDX queries (only .NET Framework)
  • Possibility of debugging framework installed from nuget package with sourcelink, more details here.
  • AngularJS support, more details here.
  • Possibility to check for JavaScript errors from the browser, more details here.
  • Instruction on how to run Ocaramba tests with Docker container, more details here.
  • ExtentReports support, more details here.

For all documentation, visit the 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:

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:

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?

Checkout the code or get it from nuget.org

  • Ocaramba NuGet Downloads NuGet Version
  • OcarambaLite NuGet Downloads NuGet Version - lighten version without selenium drivers

or download Ocaramba Visual Studio templates Ocaramba Templates

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on OcarambaLite:

Package Downloads
Ocaramba

Framework to automate tests using Selenium WebDriver

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.2.1 0 1/22/2025
4.2.0 559 11/22/2024
4.1.1 10,805 2/9/2023
4.1.0 1,266 2/1/2023
4.0.2 6,792 8/23/2022
4.0.1 3,653 6/3/2022
4.0.0 5,596 1/3/2022
3.3.1 18,170 7/21/2021
3.3.0 1,319 6/25/2021
3.2.12 13,312 3/8/2021
3.2.11 13,239 11/12/2020
3.2.10 20,217 4/16/2020
3.2.9 1,610 4/15/2020
3.2.8 8,815 3/6/2020
3.2.7 8,436 2/11/2020

You can find info about this release here: https://github.com/ObjectivityLtd/Ocaramba/releases