FakeItEasy

The FakeItEasy integration package allows you to automatically create fake dependencies for both concrete and fake abstract instances in unit tests using an Autofac container.

Array types, IEnumerable<T> types, and concrete types will be created via the underlying container, which is automatically configured with the AnyConcreteTypeNotAlreadyRegisteredSource, while other interfaces and abstract classes will be created as FakeItEasy Fakes.

You can get the Autofac.Extras.FakeItEasy package on NuGet.

Getting Started

Given you have a system under test and a dependency:

public class SystemUnderTest
{
  public SystemUnderTest(IDependency dependency)
  {
  }
}

public interface IDependency
{
}

When writing your unit test, use the Autofac.Extras.FakeItEasy.AutoFake class to instantiate the system under test. Doing this will automatically inject a fake dependency into the constructor for you.

[Test]
public void Test()
{
  using (var fake = new AutoFake())
  {
    // The AutoFake class will inject a fake IDependency
    // into the SystemUnderTest constructor
    var sut = fake.Resolve<SystemUnderTest>();
  }
}

Configuring Fakes

You can configure the automatic fakes and/or assert calls on them as you would normally with FakeItEasy.

[Test]
public void Test()
{
  using (var fake = new AutoFake())
  {
    // Arrange - configure the fake
    A.CallTo(() => fake.Resolve<IDependency>().GetValue()).Returns("expected value");
    var sut = fake.Resolve<SystemUnderTest>();

    // Act
    var actual = sut.DoWork();

    // Assert - assert on the fake
    A.CallTo(() => fake.Resolve<IDependency>().GetValue()).MustHaveHappened();
    Assert.AreEqual("expected value", actual);
  }
}

public class SystemUnderTest
{
  private readonly IDependency dependency;

  public SystemUnderTest(IDependency strings)
  {
    this.dependency = strings;
  }

  public string DoWork()
  {
    return this.dependency.GetValue();
  }
}

public interface IDependency
{
  string GetValue();
}

Configuring Specific Dependencies

You can configure the AutoFake to provide a specific instance for a given service type:

[Test]
public void Test()
{
  using (var fake = new AutoFake())
  {
    var dependency = new Dependency();
    fake.Provide(dependency);

    // ...and the rest of the test.
  }
}

You can also configure the AutoFake to provide a specific implementation type for a given service type:

[Test]
public void Test()
{
  using (var fake = new AutoFake())
  {
    // Configure a component type that doesn't require
    // constructor parameters.
    fake.Provide<IDependency, Dependency>();

    // Configure a component type that has some
    // constructor parameters passed in. Use Autofac
    // parameters in the list.
    fake.Provide<IOtherDependency, OtherDependency>(
                new NamedParameter("id", "service-identifier"),
                new TypedParameter(typeof(Guid), Guid.NewGuid()));

    // ...and the rest of the test.
  }
}

Options for Fakes

You can specify options for fake creation using optional constructor parameters on AutoFake:

using(var fake = new AutoFake(
    // Create fakes with strict behavior (unconfigured calls throw exceptions)
    strict: true,

    // Calls to fakes of abstract types will call the base methods on the abstract types
    callsBaseMethods: true,

    // Provide an action to perform upon the creation of each fake
    onFakeCreated: f => { ... }))
{
  // Use the fakes/run the test.
}

Be careful when mixing these options. It makes no sense to specify callsBaseMethods with any other options, as it will override them. When both onFakeCreated and strict are specified, the configuration supplied to onFakeCreated will override strict, as applicable.