MockQueryable.Moq 3.0.2

.NET Standard 2.1
There is a newer version of this package available.
See the version list below for details.
NuGet\Install-Package MockQueryable.Moq -Version 3.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
dotnet add package MockQueryable.Moq --version 3.0.2
<PackageReference Include="MockQueryable.Moq" Version="3.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MockQueryable.Moq --version 3.0.2
#r "nuget: MockQueryable.Moq, 3.0.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install MockQueryable.Moq as a Cake Addin
#addin nuget:?package=MockQueryable.Moq&version=3.0.2

// Install MockQueryable.Moq as a Cake Tool
#tool nuget:?package=MockQueryable.Moq&version=3.0.2

MockQueryable

Build status Build status Build Status Downloads Downloads Downloads

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.Core from the package manager console:

PM> Install-Package MockQueryable.Core

Downloads

Then make own extension for your favorite mock framework

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.1
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on MockQueryable.Moq:

Package Downloads
Reo.Core.Testing

Package Description

Zeesfam.NetLib

Package Description

Reo.Core.Testing.31

Package Description

GitHub repositories (3)

Showing the top 3 popular GitHub repositories that depend on MockQueryable.Moq:

Repository Stars
Ombi-app/Ombi
Want a Movie or TV Show on Plex/Emby/Jellyfin? Use Ombi!
lkurzyniec/netcore-boilerplate
Boilerplate of API in .NET 6
CodeMazeBlog/CodeMazeGuides
The main repository for all the Code Maze guides
Version Downloads Last updated
6.0.1 341,434 3/28/2022
6.0.0 16,003 3/24/2022
5.0.2 33,188 3/24/2022
5.0.1 1,176,541 5/25/2021
5.0.0 715,193 11/12/2020
5.0.0-preview.7 13,179 7/28/2020
3.1.3 1,112,542 5/19/2020
3.1.2 97,057 4/17/2020
3.1.1 282,166 1/25/2020
3.0.2 40,582 12/20/2019
3.0.1 39,905 10/11/2019
3.0.0 11,760 9/30/2019
1.1.0 449,039 2/28/2019
1.0.4 39,144 1/29/2019
1.0.3 198,832 8/30/2018
1.0.2 56,668 1/17/2018
1.0.1 8,126 12/26/2017
1.0.0 5,533 12/26/2017

Allows mutation of base enumerable