MockQueryable.Core 3.1.3

Core package for MockQueryable extensions for mocking operations such ToListAsync, FirstOrDefaultAsync etc.
When writing tests for your application it is often desirable to avoid hitting the database. The extension allows you to achieve this by creating a context – with behavior defined by your tests – that makes use of in-memory data.

There is a newer prerelease version of this package available.
See the version list below for details.
Install-Package MockQueryable.Core -Version 3.1.3
dotnet add package MockQueryable.Core --version 3.1.3
<PackageReference Include="MockQueryable.Core" Version="3.1.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MockQueryable.Core --version 3.1.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

MockQueryable

Build status
Build status
Build Status
Downloads
Downloads
Downloads

Build history

Extensions for mocking Entity Framework Core (EFCore) operations such ToListAsync, FirstOrDefaultAsync etc. by Moq, NSubstitute or FakeItEasy
When writing tests for your application it is often desirable to avoid hitting the database. The extensions allow you to achieve this by creating a context – with behavior defined by your tests – that makes use of in-memory data.

When should I use it?

If you have something similar to the following code:

var query = _userRepository.GetQueryable();

await query.AnyAsync(x =>...)
await query.FirstOrDefaultAsync(x =>...)
query.CountAsync(x => ...)
query.ToListAsync()
//etc.

and you want to cover it by unit tests

How do I get started?

//1 - create a List<T> with test items
var users = new List<UserEntity>()
{
  new UserEntity{LastName = "ExistLastName", DateOfBirth = DateTime.Parse("01/20/2012")},
  ...
};

//2 - build mock by extension
var mock = users.AsQueryable().BuildMock();

//3 - setup the mock as Queryable for Moq
_userRepository.Setup(x => x.GetQueryable()).Returns(mock.Object);

//3 - setup the mock as Queryable for NSubstitute
_userRepository.GetQueryable().Returns(mock);

//3 - setup the mock as Queryable for FakeItEasy
A.CallTo(() => userRepository.GetQueryable()).Returns(mock);

Do you prefer DbSet?

//2 - build mock by extension
var mock = users.AsQueryable().BuildMockDbSet();

//3 - setup DbSet for Moq
var userRepository = new TestDbSetRepository(mock.Object);

//3 - setup DbSet for NSubstitute or FakeItEasy
var userRepository = new TestDbSetRepository(mock);

Do you use DbQuery?

//2 - build mock by extension
var mock = users.AsQueryable().BuildMockDbQuery();

//3 - setup the mock as Queryable for Moq
_userRepository.Setup(x => x.GetQueryable()).Returns(mock.Object);

//3 - setup the mock as Queryable for NSubstitute
_userRepository.GetQueryable().Returns(mock);

//3 - setup the mock as Queryable for FakeItEasy
A.CallTo(() => userRepository.GetQueryable()).Returns(mock);

Check out the sample project

Where can I get it?

First, install NuGet.

If you are using Moq - then, install MockQueryable.Moq from the package manager console:

PM> Install-Package MockQueryable.Moq

If you are using NSubstitute - then, install MockQueryable.NSubstitute from the package manager console:

PM> Install-Package MockQueryable.NSubstitute

If you are using FakeItEasy - then, install MockQueryable.FakeItEasy from the package manager console:

PM> Install-Package MockQueryable.FakeItEasy

Can I use it with my favorite mock framework?

You can install MockQueryable.EntityFrameworkCore from the package manager console:

PM> Install-Package MockQueryable.EntityFrameworkCore

Downloads

or even MockQueryable.Core

PM> Install-Package MockQueryable.Core

Downloads

Then make own extension for your favorite mock framework

MockQueryable

Build status
Build status
Build Status
Downloads
Downloads
Downloads

Build history

Extensions for mocking Entity Framework Core (EFCore) operations such ToListAsync, FirstOrDefaultAsync etc. by Moq, NSubstitute or FakeItEasy
When writing tests for your application it is often desirable to avoid hitting the database. The extensions allow you to achieve this by creating a context – with behavior defined by your tests – that makes use of in-memory data.

When should I use it?

If you have something similar to the following code:

var query = _userRepository.GetQueryable();

await query.AnyAsync(x =>...)
await query.FirstOrDefaultAsync(x =>...)
query.CountAsync(x => ...)
query.ToListAsync()
//etc.

and you want to cover it by unit tests

How do I get started?

//1 - create a List<T> with test items
var users = new List<UserEntity>()
{
  new UserEntity{LastName = "ExistLastName", DateOfBirth = DateTime.Parse("01/20/2012")},
  ...
};

//2 - build mock by extension
var mock = users.AsQueryable().BuildMock();

//3 - setup the mock as Queryable for Moq
_userRepository.Setup(x => x.GetQueryable()).Returns(mock.Object);

//3 - setup the mock as Queryable for NSubstitute
_userRepository.GetQueryable().Returns(mock);

//3 - setup the mock as Queryable for FakeItEasy
A.CallTo(() => userRepository.GetQueryable()).Returns(mock);

Do you prefer DbSet?

//2 - build mock by extension
var mock = users.AsQueryable().BuildMockDbSet();

//3 - setup DbSet for Moq
var userRepository = new TestDbSetRepository(mock.Object);

//3 - setup DbSet for NSubstitute or FakeItEasy
var userRepository = new TestDbSetRepository(mock);

Do you use DbQuery?

//2 - build mock by extension
var mock = users.AsQueryable().BuildMockDbQuery();

//3 - setup the mock as Queryable for Moq
_userRepository.Setup(x => x.GetQueryable()).Returns(mock.Object);

//3 - setup the mock as Queryable for NSubstitute
_userRepository.GetQueryable().Returns(mock);

//3 - setup the mock as Queryable for FakeItEasy
A.CallTo(() => userRepository.GetQueryable()).Returns(mock);

Check out the sample project

Where can I get it?

First, install NuGet.

If you are using Moq - then, install MockQueryable.Moq from the package manager console:

PM> Install-Package MockQueryable.Moq

If you are using NSubstitute - then, install MockQueryable.NSubstitute from the package manager console:

PM> Install-Package MockQueryable.NSubstitute

If you are using FakeItEasy - then, install MockQueryable.FakeItEasy from the package manager console:

PM> Install-Package MockQueryable.FakeItEasy

Can I use it with my favorite mock framework?

You can install MockQueryable.EntityFrameworkCore from the package manager console:

PM> Install-Package MockQueryable.EntityFrameworkCore

Downloads

or even MockQueryable.Core

PM> Install-Package MockQueryable.Core

Downloads

Then make own extension for your favorite mock framework

Release Notes

MockQueryable splitted into MockQueryable.Core and MockQueryable.EntityFrameworkCore

  • .NETStandard 2.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on MockQueryable.Core:

Package Downloads
MockQueryable.EntityFrameworkCore
Extension for mocking Entity Framework Core operations such ToListAsync, FirstOrDefaultAsync etc. When writing tests for your application it is often desirable to avoid hitting the database. The extension allows you to achieve this by creating a context – with behavior defined by your tests – that makes use of in-memory data.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
5.0.0-preview.7 1,326 7/28/2020
3.1.3 171,384 5/19/2020
3.1.2 42,595 4/17/2020
3.1.1 127,631 1/25/2020
3.0.2 30,887 12/20/2019
3.0.1 32,054 10/11/2019
3.0.0 5,368 9/30/2019
1.1.0 295,191 2/28/2019
1.0.4 39,505 1/29/2019
1.0.3 116,747 8/30/2018
1.0.2 44,565 1/17/2018
1.0.1 429 12/26/2017
1.0.0 8,632 12/26/2017