https://github.com/sauceforge/saucery
The SauceLabs DesiredOption factory. Makes SauceLabs easy.
https://github.com/sauceforge/saucery
automation c-sharp dotnet nunit saucelabs tdd test-driven-development testing tunit xunit xunit3
Last synced: about 1 month ago
JSON representation
The SauceLabs DesiredOption factory. Makes SauceLabs easy.
- Host: GitHub
- URL: https://github.com/sauceforge/saucery
- Owner: Sauceforge
- License: mit
- Created: 2015-11-14T02:34:08.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2025-08-31T01:14:15.000Z (about 1 month ago)
- Last Synced: 2025-08-31T01:14:18.492Z (about 1 month ago)
- Topics: automation, c-sharp, dotnet, nunit, saucelabs, tdd, test-driven-development, testing, tunit, xunit, xunit3
- Language: C#
- Homepage: http://sauceforge.github.io
- Size: 7.45 MB
- Stars: 4
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Saucery
Automated testing made more awesome
[](https://app.codacy.com/gh/Sauceforge/Saucery/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[](https://github.com/sponsors/Sauceforge)
Saucery handles all the plumbing required to integrate with SauceLabs, making writing tests a breeze. so you only need to tell Saucery *what* you want. Saucery takes care of the *how*.
Saucery comes in multiple flavors supporting popular test frameworks.
The templates below include example tests.
### Packages
| Package | Badges |
| --- | --- |
| Saucery | [](https://www.nuget.org/packages/Saucery/) [](https://www.nuget.org/packages/Saucery/) |
| Saucery.XUnit | [](https://www.nuget.org/packages/Saucery.XUnit/) [](https://www.nuget.org/packages/Saucery.XUnit/) |
| Saucery.TUnit | [](https://www.nuget.org/packages/Saucery.TUnit/) [](https://www.nuget.org/packages/Saucery.TUnit/) |
| Saucery.XUnit.v3 | [](https://www.nuget.org/packages/Saucery.XUnit.v3/) [](https://www.nuget.org/packages/Saucery.XUnit.v3/) |
### Sponsoring
Saucery has been developed as an open-source project for over 10 years. If you find it valuable for your projects and team work, please consider supporting it and becoming a [](https://github.com/sponsors/Sauceforge)
### Dog food Status
We test Saucery itself on SauceLabs!
[](https://app.saucelabs.com/buildstatus/saucefauge?saucy)
### Initial Setup
These steps apply to all flavors:
1. You'll need a SauceLabs account. You can get a free trial account [here](https://saucelabs.com/sign-up).
1. If you want to run your tests locally you need to set 2 environment variables, SAUCE_USER_NAME and SAUCE_API_KEY
1. To run your test suite from your GitHub Actions pipeline you need to set two secrets SAUCE_USER_NAME and SAUCE_API_KEY. Instructions on how to set Github Secrets are [here](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository).
### NUnit
#### 🏁 Quick Start
#### Using the Project Template (Recommended)
```bash
cd Templates
dotnet new install .\NUnit
dotnet new saucery-nunit -n "MyTestProject"
```
### XUnit
#### 🏁 Quick Start
#### Using the Project Template (Recommended)
```bash
cd Templates
dotnet new install .\XUnit
dotnet new saucery-xunit -n "MyTestProject"
```
### TUnit
#### 🏁 Quick Start
#### Using the Project Template (Recommended)
```bash
cd Templates
dotnet new install .\TUnit
dotnet new saucery-tunit -n "MyTestProject"
```
### XUnit-v3
#### 🏁 Quick Start
#### Using the Project Template (Recommended)
```bash
cd Templates
dotnet new install .\XUnit3
dotnet new saucery-xunit3 -n "MyTestProject"
```
## Platform Range Expansion
Platform range expansion is a feature unique to Saucery. Say you wanted to test on a range of browser versions but you didn't want to specify each individually. That's fine. Saucery supports specifying ranges.
```csharp
new DesktopPlatform(SauceryConstants.PLATFORM_WINDOWS_11, SauceryConstants.BROWSER_CHROME, "100->119")
```
This will test on Windows 11 Chrome all available versions from 100 to 119 inclusive.
## Real Devices
Yes, Saucery supports Real Devices!
### Trends
[Nuget downloads](https://nugettrends.com/packages?months=24&ids=Saucery&ids=Saucery.XUnit&ids=Saucery.TUnit&ids=Saucery.Core&ids=Saucery.XUnit.v3)
[GitHub stars](https://star-history.com/#sauceforge/Saucery)
## Contact
Author: Andrew Gray
Twitter: [@agrayz](https://twitter.com/agrayz)