RavenDB.TestDriver 7.1.0-rc-71003

Prefix Reserved
This is a prerelease version of RavenDB.TestDriver.
There is a newer version of this package available.
See the version list below for details.
dotnet add package RavenDB.TestDriver --version 7.1.0-rc-71003
                    
NuGet\Install-Package RavenDB.TestDriver -Version 7.1.0-rc-71003
                    
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.1.0-rc-71003" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="RavenDB.TestDriver" Version="7.1.0-rc-71003" />
                    
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.1.0-rc-71003
                    
#r "nuget: RavenDB.TestDriver, 7.1.0-rc-71003"
                    
#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.1.0-rc-71003&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=RavenDB.TestDriver&version=7.1.0-rc-71003&prerelease
                    
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 18 7/1/2025
7.1.0-rc-71004 102 6/25/2025
7.1.0-rc-71003 133 6/18/2025
7.1.0-rc-71000 152 5/29/2025
7.0.4 168 6/25/2025
7.0.3 974 6/10/2025
7.0.2 5,252 4/29/2025
7.0.1 5,757 3/27/2025
7.0.0 12,930 2/4/2025
6.2.7 110 6/25/2025
6.2.6 382 6/10/2025
6.2.5 1,824 4/29/2025
6.2.4 2,369 3/18/2025
6.2.3 18,227 1/21/2025
6.2.2 27,074 12/11/2024
6.2.1 19,884 10/30/2024
6.2.0 7,720 9/17/2024
6.0.110 332 3/18/2025
6.0.109 789 1/21/2025
6.0.108 250 12/11/2024
6.0.107 851 10/30/2024
6.0.106 8,795 9/17/2024
6.0.105 18,849 7/23/2024
6.0.104 10,696 6/17/2024
6.0.103 6,435 5/16/2024
6.0.102 13,855 4/29/2024
6.0.101 33,480 3/19/2024
6.0.100 47,184 2/12/2024
6.0.4 4,258 1/19/2024
6.0.3 60,476 1/16/2024
6.0.2 2,471 12/27/2023
6.0.1 5,195 11/14/2023
6.0.0 4,183 10/2/2023
5.4.209 346 6/10/2025
5.4.208 1,039 4/29/2025
5.4.207 1,023 3/18/2025
5.4.206 9,238 1/21/2025
5.4.205 3,650 12/11/2024
5.4.204 8,350 10/30/2024
5.4.203 9,419 10/2/2024
5.4.202 588 9/17/2024
5.4.201 10,760 7/23/2024
5.4.200 15,711 6/17/2024
5.4.119 2,703 5/16/2024
5.4.118 3,009 4/29/2024
5.4.117 11,737 3/19/2024
5.4.116 9,061 2/12/2024
5.4.115 2,592 1/18/2024
5.4.114 154 1/16/2024
5.4.113 8,336 12/27/2023
5.4.112 106,052 11/14/2023
5.4.111 10,102 10/3/2023
5.4.110 3,547 9/12/2023
5.4.109 13,876 8/1/2023
5.4.107 5,096 6/23/2023
5.4.106 328 6/22/2023
5.4.105 740 6/20/2023
5.4.104 36,893 5/12/2023
5.4.103 27,183 3/30/2023
5.4.102 4,197 3/27/2023
5.4.101 15,419 2/13/2023
5.4.100 18,284 1/9/2023
5.4.5 54,783 11/21/2022
5.4.4 13,498 10/12/2022
5.4.3 795 10/10/2022
5.4.2 18,562 9/1/2022
5.4.1 35,241 7/19/2022
5.4.0 11,779 7/18/2022
5.3.108 40,165 1/9/2023
5.3.107 2,837 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,132 4/19/2022
5.3.101 24,338 3/15/2022
5.3.100 31,968 2/1/2022
5.3.2 9,329 1/7/2022
5.3.1 5,735 12/21/2021
5.3.0 4,788 11/29/2021
5.2.116 217 8/1/2023
5.2.115 224 6/23/2023
5.2.114 213 6/22/2023
5.2.113 226 6/20/2023
5.2.112 494 5/12/2023
5.2.111 590 3/30/2023
5.2.110 871 3/27/2023
5.2.109 677 2/13/2023
5.2.108 3,220 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,348 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,833 5/26/2021
5.1.7 20,552 4/23/2021
5.1.6 2,528 4/13/2021
5.1.5 7,864 3/1/2021
5.1.4 9,329 2/1/2021
5.1.3 892 1/25/2021
5.1.2 5,838 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,050 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,607 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 274 6/19/2023
4.2.123 2,994 6/7/2022
4.2.122 1,290 4/19/2022
4.2.121 1,093 3/15/2022
4.2.120 2,201 2/1/2022
4.2.119 511 12/21/2021
4.2.118 1,123 11/15/2021
4.2.117 1,029 9/29/2021
4.2.116 960 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,843 8/17/2020
4.2.104 2,344 7/22/2020
4.2.103 13,700 5/25/2020
4.2.102 5,282 4/15/2020
4.2.101 11,748 3/3/2020
4.2.100 863 3/2/2020
4.2.8 15,323 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,211 9/14/2018
4.1.0 1,644 8/31/2018
4.1.0-rc-41000 848 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,076 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,831 2/6/2018