DockerizedTesting.S3 1.1.0

A fixture for XUnit that start up a fake local S3 bucket to test your code with. Whilst it was built for XUnit it should be framework agnostic.

Install-Package DockerizedTesting.S3 -Version 1.1.0
dotnet add package DockerizedTesting.S3 --version 1.1.0
<PackageReference Include="DockerizedTesting.S3" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DockerizedTesting.S3 --version 1.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Dockerized Testing

This colleaction of packages allows you to quickly spin up Docker resources to test your projects with.

Simply implement IClassFixture and then start the resource like this:

public class RedisFixtureTests : IClassFixture<RedisFixture>
{
    public RedisFixtureTests(RedisFixture redisFixture)
    {
        redisFixture.Start().Wait();
        var client = await ConnectionMultiplexer.ConnectAsync("localhost:" + fixture.Ports.Single());
    }
}

You can also build and run instances of your own VS projects like this:

public class ExampleProjectTests : IClassFixture<ExampleTestFixture>
{
    private readonly ExampleTestFixture fixture;

    public ExampleProjectTests(ExampleTestFixture fixture)
    {
        fixture.Start(new ExampleTestFixtureOptions()).Wait();
    }
}

public class ExampleTestFixtureOptions : FixtureOptions
{
    public override IDockerImageProvider ImageProvider { get; } = new DockerProjectImageProvider(nameof(ExampleProjectNs));
}

public class ExampleTestFixture : BaseFixture<ExampleTestFixtureOptions>
{
    // etc
}

Or you can build and run other dockerized resources like this:

public class ReadDataFromDb : IClassFixture<MsSqlFixture>
{
    public ReadDataFromDb(MsSqlFixture fixture)
    {
        fixture.Start(new CustomMsSqlFixtureOptions()).Wait();
    }
}

public class CustomMsSqlFixtureOptions : MsSqlFixtureOptions
{
    public CustomMsSqlFixtureOptions()
    {
        ImageProvider = new DockerfileImageProvider("example_database", ".",
            new ImageBuildParameters
            {
                BuildArgs = new Dictionary<string, string>()
                {
                    {"PASSWORD", this.SaPassword},
                    {"DATABASE","test" }
                }
            });
    }
    public override IDockerImageProvider ImageProvider { get; }
}

The corresponding Dockerfile contains:

LABEL project=example_database

Take a look at the Examples folder or the integration tests for each project for more examples.

Nuget packages are available here https://www.nuget.org/profiles/devjoes

Dockerized Testing

This colleaction of packages allows you to quickly spin up Docker resources to test your projects with.

Simply implement IClassFixture and then start the resource like this:

public class RedisFixtureTests : IClassFixture<RedisFixture>
{
    public RedisFixtureTests(RedisFixture redisFixture)
    {
        redisFixture.Start().Wait();
        var client = await ConnectionMultiplexer.ConnectAsync("localhost:" + fixture.Ports.Single());
    }
}

You can also build and run instances of your own VS projects like this:

public class ExampleProjectTests : IClassFixture<ExampleTestFixture>
{
    private readonly ExampleTestFixture fixture;

    public ExampleProjectTests(ExampleTestFixture fixture)
    {
        fixture.Start(new ExampleTestFixtureOptions()).Wait();
    }
}

public class ExampleTestFixtureOptions : FixtureOptions
{
    public override IDockerImageProvider ImageProvider { get; } = new DockerProjectImageProvider(nameof(ExampleProjectNs));
}

public class ExampleTestFixture : BaseFixture<ExampleTestFixtureOptions>
{
    // etc
}

Or you can build and run other dockerized resources like this:

public class ReadDataFromDb : IClassFixture<MsSqlFixture>
{
    public ReadDataFromDb(MsSqlFixture fixture)
    {
        fixture.Start(new CustomMsSqlFixtureOptions()).Wait();
    }
}

public class CustomMsSqlFixtureOptions : MsSqlFixtureOptions
{
    public CustomMsSqlFixtureOptions()
    {
        ImageProvider = new DockerfileImageProvider("example_database", ".",
            new ImageBuildParameters
            {
                BuildArgs = new Dictionary<string, string>()
                {
                    {"PASSWORD", this.SaPassword},
                    {"DATABASE","test" }
                }
            });
    }
    public override IDockerImageProvider ImageProvider { get; }
}

The corresponding Dockerfile contains:

LABEL project=example_database

Take a look at the Examples folder or the integration tests for each project for more examples.

Nuget packages are available here https://www.nuget.org/profiles/devjoes

Release Notes

Fixed issue where it would wait forever for s3 to come up
Made mounting a volume optional (you can sometimes get this issue otherwise https://github.com/jubos/fake-s3/issues/66 )

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
1.1.0 55 11/6/2019
1.0.3 83 7/19/2019
1.0.2 86 7/10/2019
1.0.1 83 7/4/2019
1.0.0 81 7/4/2019