ByteDev.Testing 1.1.0

ByteDev.Testing

.NET Standard library that provides some testing related functionality.

Installation

ByteDev.Testing has been written as a .NET Standard 2.0 library, so you can consume it from a .NET Core or .NET Framework 4.6.1 (or greater) application.

ByteDev.Testing is hosted as a package on nuget.org. To install from the Package Manager Console in Visual Studio run:

Install-Package ByteDev.Testing

Further details can be found on the nuget page.

Release Notes

Releases follow semantic versioning.

Full details of the release notes can be viewed on GitHub.

Usage

Builders

Builders for both directories and files.

// Create a directory quickly on disk
DirectoryInfo dir = DirectoryBuilder.InFileSystem
                        .WithPath(@"C:\Temp\Testing")
                        .EmptyIfExists()
                        .Build();


// Create a file quickly on disk
FileInfo file = FileBuilder.InFileSystem
                    .WithPath(@"C:\Temp\Testing\TestFile1.txt")
                    .WithSize(10)
                    .OverwriteIfExists(true)
                    .Build();

TestConnectionString

Represents a method to help retrieve a test connection string for automated testing so connection string constants are not stored in code or config.

// Get reference to assembly that is running the tests
var assembly = Assembly.GetAssembly(typeof(SomeIntTests));

var testConn = new TestConnectionString(assembly);

// Set the name of a possible environment variable where the connection might be held
testConn.EnvironmentVarName = "MyIntTests-ConnString";

// Set possible files where the connection string might be held
testConn.FilePaths = new []
{
    @"X:\Secure\MyIntTests-ConnString.txt",
    @"C:\User\jonbob\MyIntTests-ConnString.txt",
};

string connStr = testConn.GetConnectionString();

TestSettings

Represents test settings that live external to the test project in a JSON file.

// Get reference to assembly that is running the tests
var assembly = Assembly.GetAssembly(typeof(SomeIntTests));

var testSettings = new TestSettings(assembly);

// Set possible files where the test settings might be held
testSettings.FilePaths = new[]
{
    @"X:\Secure\MyAppSettings.json",
    @"C:\User\jonbob\MyAppSettings.json",
};

MyAppSettings settings = testSettings.GetSettings<MyAppSettings>();

Example settings type:

public class MyAppSettings
{
    public string KeyVaultName { get; set; }

    public string ClientId { get; set; }
}

Example JSON settings file MyAppSettings.json:

{
  "KeyVaultName": "my-keyvault",
  "ClientId": "98a0d492-c6c6-4f1f-9d19-a98d94242ce6"
}