RavenDB.TestDriver 7.0.3

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package RavenDB.TestDriver --version 7.0.3
                    
NuGet\Install-Package RavenDB.TestDriver -Version 7.0.3
                    
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.
<PackageReference Include="RavenDB.TestDriver" Version="7.0.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="RavenDB.TestDriver" Version="7.0.3" />
                    
Directory.Packages.props
<PackageReference Include="RavenDB.TestDriver" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add RavenDB.TestDriver --version 7.0.3
                    
#r "nuget: RavenDB.TestDriver, 7.0.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=RavenDB.TestDriver&version=7.0.3
                    
Install as a Cake Addin
#tool nuget:?package=RavenDB.TestDriver&version=7.0.3
                    
Install as a Cake Tool

RavenDB .NET Test Driver

You're looking at RavenDB Test Driver Client (SDK) NuGet release.
It makes it easy to write tests that require RavenDB instance, leveraging embedded server and providing you friendly API.

RavenDB is a NoSQL database that fuses extreme performance with ease-of-use, offering above the roof developer experience.
Learn more at https://ravendb.net or visit our GitHub repository.

Installation

Get the latest stable version from NuGet.

Learning resources

Community

Getting started

Configure

var testServerOptions = new TestServerOptions
{
    // Looks for the newest version on your machine including 3.1.15 and any newer patches
    // but not major new releases (default is .NET version at time of server release).
    FrameworkVersion = "3.1.15+",

    // Specifies where ravendb server binaries are located (Optional)
    ServerDirectory = "PATH_TO_RAVENDB_SERVER",

    // Specifies where ravendb data will be placed/located (Optional)
    DataDirectory = "PATH_TO_RAVENDB_DATADIR", 
};

ConfigureServer(testServerOptions);

Write a test

using Raven.Client.Documents;
using Raven.TestDriver;
using Xunit;
using System.Linq;
using Raven.Client.Documents.Indexes;

namespace RavenDBTestDriverFullExample
{

    public class RavenDBTestDriver : RavenTestDriver
    {
        static RavenDBTestDriver()
        {
            // ConfigureServer() must be set before calling GetDocumentStore()
            // and can only be set once per test run.
            ConfigureServer(new TestServerOptions
            {
                DataDirectory = "C:\\RavenDBTestDir"
            });
        }
        // This allows us to modify the conventions of the store we get from 'GetDocumentStore'
        protected override void PreInitialize(IDocumentStore documentStore)
        {
            documentStore.Conventions.MaxNumberOfRequestsPerSession = 50;
        }

        [Fact]
        public void MyFirstTest()
        {
            // GetDocumentStore() evokes the Document Store, which establishes and manages communication
            // between your client application and a RavenDB cluster via HTTP requests.
            using (var store = GetDocumentStore())
            {
                store.ExecuteIndex(new TestDocumentByName());
                using (var session = store.OpenSession())
                {
                    session.Store(new TestDocument { Name = "Hello world!" });
                    session.Store(new TestDocument { Name = "Goodbye..." });
                    session.SaveChanges();
                }
                // If we want to query documents, sometimes we need to wait for the indexes to catch up  
                // to prevent using stale indexes.
                WaitForIndexing(store);

                // Sometimes we want to debug the test itself. This method redirects us to the studio
                // so that we can see if the code worked as expected (in this case, created two documents).
                WaitForUserToContinueTheTest(store);

                // Queries are defined in the session scope.
                // If there is no relevant index to quickly answer the query, RavenDB creates an auto-index
                // based on the query parameters.
                // This query will use the static index defined in lines 63-70 and filter the results by name.
                using (var session = store.OpenSession())
                {
                    var query = session.Query<TestDocument, TestDocumentByName>()
                        .Where(x => x.Name == "hello").ToList();
                    Assert.Single(query);
                }
            }
        }
    }
    // AbstractIndexCreationTask allows you to create and manually define a static index. 
    public class TestDocumentByName : AbstractIndexCreationTask<TestDocument>
    {
        public TestDocumentByName()
        {
            Map = docs => from doc in docs select new { doc.Name };
            Indexes.Add(x => x.Name, FieldIndexing.Search);
        }
    }

    public class TestDocument
    {
        public string Name { get; set; }
    }
}

Contributing

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on RavenDB.TestDriver:

Package Downloads
ECommerce.Data.RavenDbProvider

a resilient abstract data access. StartPoint ECommerce.DataAccess based on Hexagonal architecture gives you the capacity to access any data source with retrying and fallback action

GitHub repositories (10)

Showing the top 10 popular GitHub repositories that depend on RavenDB.TestDriver:

Repository Stars
JasperFx/wolverine
Supercharged .NET server side development!
Aguafrommars/TheIdServer
OpenID/Connect, OAuth2, WS-Federation and SAML 2.0 server based on Duende IdentityServer and ITFoxtec Identity SAML 2.0 with its admin UI
CommunityToolkit/Aspire
A community project with additional components and extensions for .NET Aspire
linkdotnet/Blog
A blog (engine) completely written in C# and Blazor. It aims to be a simple use and easy to extend platform. Blogposts are written in Markdown and are rendered to HTML. This gives all the flexibility needed to express yourself but also have an easy way of creating posts in the first place.
TcOpenGroup/TcOpen
Application framework for industrial automation built on top of TwinCAT3 and .NET.
RemyDuijkeren/NodaMoney
NodaMoney provides a library that treats Money as a first class citizen and handles all the ugly bits like currencies and formatting.
stoveproject/Stove
Domain Driven Design oriented application framework, meets CRUD needs
RemiBou/Toss.Blazor
Experimental project using AspNetCore Blazor
linkdotnet/BlogExamples
Contains all of my examples from various blog posts
ravendb/samples-yabt
"Yet Another Bug Tracker" solution sample for RavenDB and .NET with Angular UI
Version Downloads Last Updated
7.1.0 606 7/1/2025
7.1.0-rc-71004 130 6/25/2025
7.1.0-rc-71003 137 6/18/2025
7.1.0-rc-71000 153 5/29/2025
7.0.4 544 6/25/2025
7.0.3 1,066 6/10/2025
7.0.2 5,876 4/29/2025
7.0.1 5,801 3/27/2025
7.0.0 13,142 2/4/2025
6.2.7 182 6/25/2025
6.2.6 678 6/10/2025
6.2.5 2,005 4/29/2025
6.2.4 2,488 3/18/2025
6.2.3 19,144 1/21/2025
6.2.2 27,925 12/11/2024
6.2.1 19,997 10/30/2024
6.2.0 7,836 9/17/2024
6.0.110 357 3/18/2025
6.0.109 796 1/21/2025
6.0.108 258 12/11/2024
6.0.107 858 10/30/2024
6.0.106 8,802 9/17/2024
6.0.105 19,037 7/23/2024
6.0.104 10,704 6/17/2024
6.0.103 6,482 5/16/2024
6.0.102 13,872 4/29/2024
6.0.101 34,075 3/19/2024
6.0.100 47,826 2/12/2024
6.0.4 4,498 1/19/2024
6.0.3 60,484 1/16/2024
6.0.2 2,477 12/27/2023
6.0.1 5,196 11/14/2023
6.0.0 4,200 10/2/2023
5.4.209 358 6/10/2025
5.4.208 1,119 4/29/2025
5.4.207 1,044 3/18/2025
5.4.206 9,637 1/21/2025
5.4.205 3,912 12/11/2024
5.4.204 8,443 10/30/2024
5.4.203 9,606 10/2/2024
5.4.202 595 9/17/2024
5.4.201 11,024 7/23/2024
5.4.200 16,117 6/17/2024
5.4.119 2,710 5/16/2024
5.4.118 3,029 4/29/2024
5.4.117 11,749 3/19/2024
5.4.116 9,068 2/12/2024
5.4.115 2,601 1/18/2024
5.4.114 162 1/16/2024
5.4.113 8,342 12/27/2023
5.4.112 110,111 11/14/2023
5.4.111 10,112 10/3/2023
5.4.110 3,549 9/12/2023
5.4.109 13,990 8/1/2023
5.4.107 5,098 6/23/2023
5.4.106 330 6/22/2023
5.4.105 742 6/20/2023
5.4.104 36,896 5/12/2023
5.4.103 27,185 3/30/2023
5.4.102 4,201 3/27/2023
5.4.101 15,421 2/13/2023
5.4.100 18,328 1/9/2023
5.4.5 54,833 11/21/2022
5.4.4 13,522 10/12/2022
5.4.3 795 10/10/2022
5.4.2 18,588 9/1/2022
5.4.1 35,301 7/19/2022
5.4.0 11,781 7/18/2022
5.3.108 40,175 1/9/2023
5.3.107 2,886 11/21/2022
5.3.106 549 10/10/2022
5.3.105 623 9/1/2022
5.3.104 1,913 7/18/2022
5.3.103 29,592 6/7/2022
5.3.102 56,139 4/19/2022
5.3.101 24,345 3/15/2022
5.3.100 31,972 2/1/2022
5.3.2 9,330 1/7/2022
5.3.1 5,737 12/21/2021
5.3.0 4,788 11/29/2021
5.2.116 219 8/1/2023
5.2.115 226 6/23/2023
5.2.114 215 6/22/2023
5.2.113 228 6/20/2023
5.2.112 496 5/12/2023
5.2.111 592 3/30/2023
5.2.110 873 3/27/2023
5.2.109 679 2/13/2023
5.2.108 3,274 1/9/2023
5.2.107 449 11/21/2022
5.2.106 551 10/10/2022
5.2.105 560 9/1/2022
5.2.104 598 7/18/2022
5.2.103 618 6/7/2022
5.2.102 11,227 4/19/2022
5.2.101 18,684 3/15/2022
5.2.100 916 2/1/2022
5.2.6 820 1/7/2022
5.2.5 487 12/21/2021
5.2.4 13,583 11/15/2021
5.2.3 8,611 9/29/2021
5.2.2 17,492 8/16/2021
5.2.1 2,251 7/1/2021
5.2.0 3,930 6/21/2021
5.1.13 487 12/21/2021
5.1.12 574 11/15/2021
5.1.11 604 9/29/2021
5.1.10 617 8/16/2021
5.1.9 11,886 7/1/2021
5.1.8 3,835 5/26/2021
5.1.7 20,552 4/23/2021
5.1.6 2,528 4/13/2021
5.1.5 7,865 3/1/2021
5.1.4 9,329 2/1/2021
5.1.3 892 1/25/2021
5.1.2 5,862 12/11/2020
5.1.1 2,381 12/1/2020
5.1.0 1,478 11/18/2020
5.0.14 1,142 6/16/2021
5.0.13 655 5/24/2021
5.0.12 12,053 4/23/2021
5.0.11 3,969 4/13/2021
5.0.10 792 3/1/2021
5.0.9 782 2/1/2021
5.0.8 2,363 1/25/2021
5.0.7 3,587 12/11/2020
5.0.6 711 12/1/2020
5.0.5 17,937 11/16/2020
5.0.4 935 11/10/2020
5.0.3 4,610 9/28/2020
5.0.2 7,439 8/17/2020
5.0.1 1,464 8/5/2020
5.0.0 4,243 7/23/2020
4.2.124 276 6/19/2023
4.2.123 3,006 6/7/2022
4.2.122 1,290 4/19/2022
4.2.121 1,094 3/15/2022
4.2.120 2,203 2/1/2022
4.2.119 511 12/21/2021
4.2.118 1,124 11/15/2021
4.2.117 1,029 9/29/2021
4.2.116 961 8/16/2021
4.2.115 1,011 7/1/2021
4.2.114 2,507 5/24/2021
4.2.113 2,593 4/23/2021
4.2.112 817 4/13/2021
4.2.111 3,128 3/1/2021
4.2.110 1,832 2/1/2021
4.2.109 713 1/25/2021
4.2.108 3,386 11/16/2020
4.2.107 709 11/10/2020
4.2.106 6,380 9/28/2020
4.2.105 10,844 8/17/2020
4.2.104 2,344 7/22/2020
4.2.103 13,701 5/25/2020
4.2.102 5,282 4/15/2020
4.2.101 11,750 3/3/2020
4.2.100 863 3/2/2020
4.2.8 15,324 1/21/2020
4.2.6 7,077 12/9/2019
4.2.5 2,697 11/25/2019
4.2.5-patch-42026 522 11/13/2019
4.2.4 3,404 10/14/2019
4.2.4-patch-42020 531 9/27/2019
4.2.3 12,913 8/26/2019
4.2.2 9,478 7/15/2019
4.2.1 1,781 6/27/2019
4.2.0 3,603 5/21/2019
4.2.0-rc-42008 553 5/8/2019
4.2.0-rc-42007 592 4/25/2019
4.2.0-rc-42005 575 4/17/2019
4.2.0-rc-42003 569 4/12/2019
4.2.0-rc-42002 574 4/5/2019
4.2.0-rc-42001 583 3/22/2019
4.2.0-rc-42000 568 3/22/2019
4.1.10 1,266 11/25/2019
4.1.9 772 10/14/2019
4.1.9-patch-41022 510 9/27/2019
4.1.8 2,157 8/26/2019
4.1.8-patch-41017 542 7/15/2019
4.1.7 830 6/27/2019
4.1.6 910 5/21/2019
4.1.5 1,584 4/15/2019
4.1.5-patch-41012 646 3/15/2019
4.1.4 11,054 2/13/2019
4.1.4-patch-41009 691 2/1/2019
4.1.4-patch-41008 2,200 1/7/2019
4.1.3 4,664 11/19/2018
4.1.3-patch-41006 1,216 11/5/2018
4.1.3-patch-41005 809 10/22/2018
4.1.2 5,653 10/15/2018
4.1.1 4,213 9/14/2018
4.1.0 1,646 8/31/2018
4.1.0-rc-41000 849 8/17/2018
4.0.11 1,189 2/28/2019
4.0.10 936 2/13/2019
4.0.10-patch-40057 648 2/1/2019
4.0.10-patch-40056 678 1/7/2019
4.0.9 972 11/19/2018
4.0.9-patch-40054 783 11/5/2018
4.0.9-patch-40052 761 10/22/2018
4.0.8 1,065 10/15/2018
4.0.7 1,077 8/31/2018
4.0.6 2,524 8/3/2018
4.0.6-patch-40047 988 7/2/2018
4.0.5 6,194 6/12/2018
4.0.4-patch-40038 1,140 5/18/2018
4.0.3 18,292 4/23/2018
4.0.3-patch-40034 1,611 3/30/2018
4.0.3-patch-40033 1,137 3/19/2018
4.0.3-patch-40031 1,183 3/7/2018
4.0.2 3,524 2/26/2018
4.0.1 1,485 2/20/2018
4.0.0 1,835 2/6/2018