TestDataFramework.dll 3.1.2

There is a newer version of this package available.
See the version list below for details.
Install-Package TestDataFramework.dll -Version 3.1.2
dotnet add package TestDataFramework.dll --version 3.1.2
<PackageReference Include="TestDataFramework.dll" Version="3.1.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add TestDataFramework.dll --version 3.1.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: TestDataFramework.dll, 3.1.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 TestDataFramework.dll as a Cake Addin
#addin nuget:?package=TestDataFramework.dll&version=3.1.2

// Install TestDataFramework.dll as a Cake Tool
#tool nuget:?package=TestDataFramework.dll&version=3.1.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

This is a unit testing tool. It randomizes values in your classes automatically so you don't need to do data entry.

This tool includes the optional ability to write out objects to a database for tests which involve data access.

To get an object value quickly:

IPopulator memoryPopulator = StaticPopulatorFactory.CreateMemoryPopulator();

SubjectClass subject = memoryPopulator.Make<SubjectClass>();

// Or

// Makes five objects
IEnumerable<SubjectClass> subjectSet = memoryPopulator.Make<SubjectClass>(5);

The above example uses the in-memory populator.

DON'T use the Make() or MakeAndBind() methods with the SQL Server populator unless you know what you are doing. They will write to the database immediately.

Go to the Wiki for more.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.5.3 367 9/25/2021
3.5.1 605 3/31/2019
3.5.0 465 3/3/2019
3.4.1 540 2/20/2019
3.4.0 530 2/19/2019
3.3.5 603 12/1/2018
3.3.4 541 11/26/2018
3.3.3 509 11/22/2018
3.3.2 540 11/5/2018
3.3.1 574 11/2/2018
3.3.0 520 10/29/2018
3.2.1 597 10/25/2018
3.2.0 570 10/25/2018
3.1.4 619 10/9/2018
3.1.3 597 10/9/2018
3.1.2 620 10/8/2018
3.1.1 569 9/22/2018
3.0.1 607 8/26/2018
2.4.0 957 1/22/2018
2.2.4 716 1/19/2018 812 1/12/2018 729 12/13/2017
2.2.2 815 12/9/2017
2.2.1 751 12/4/2017
2.2.0 751 11/22/2017
2.1.0 987 10/30/2017 713 7/11/2017 639 7/9/2017 593 7/9/2017 587 7/9/2017
2.0.4 639 7/6/2017
2.0.3 592 7/2/2017
2.0.2 714 1/9/2017
2.0.1 753 12/7/2016

       *   - Added missing overload for GuaranteeByFixedQuantity in the derived OperableLists.
             Was missing overload taking IEnumerable<T> and an explicit fixed quantity
* - Removing state from a service. Allows the same populator object to be used in generation
 of an explicitly set property value.

* - Deep setting of properties.

- Deep setting of object graph properties beyond a collection.

- Make an object in one line via Make and BindAndMake.

- Ignore a property (to avoid possible side effects).

- Exclusive range of possible values for a property.

- Take and Skip operations for control of what subsets of a collection explicit setters apply to.

- Better encapsulation. Less public/protected member exposure.
* Bug fixes:
Value type and enum constructor parameters were not being populated.
Unsigned integer properties were causing code to break.

* Bug fix. Constructor finder was finding a constructor for a string with a char array parameter.
Was trying to invoke it. Now circumventing this for value/string types and arrays.
Populating those constructor arguments directly.

* Populator will now attempt to resolve constructor with parameters.
Constructors are attempted from least number of parameters (including zero) to most number of parameters.
* Bug fix. When calling deferred value generator, was including record references that were not populatable, and therefore null.
This was causing a null reference exception when the generator tried to access a method (GetType()) off the null record.
* Ability to ignore properties. Useful to avoid side effects of properties with logic in the setter.
New RecordObjects convenience property on the OperableList<T> result collection type. Instead of
user having to write the LINQ statement to select out the RecordObjects.
* All setters on a property are executed in turn.
* Support for enums

* Bug fix. A combination of explicit/deep property setting and collections in the target object were
causing a null ref exception.

* Fixed bug in deep explicit property setting, same issue as in It's a relatively rare edge case.
Calling Make/BindAndMake on an operable list will call the persistence layer only once for entire list.
Was calling once per element. Will save database round trips when DB populator is used.

* Deep explicit setting of properties.

* Introduction of the ability to get a value immediately by calling Make() or BindAndMake().
This is without needing to call IPopulator.Bind() separately to get values on the whole set
of requested objects.

* Bug Fix. Setting explicit value off of an interface didn't identify the concrete object's
actual (derived) type. Under these conditions, properties weren't being explicitly set
on the object instance.

* Assembly version properties correction.

* Syncing C# and Sql Server DateTime values for the Sql Server populator.
Milliseconds were being truncated on Sql Server but not in C#.

* Extra guard when accessing types from assemblies to be scanned.
Was throwing a ReflectionTypeLoadException for a particular assembly/type.


* Bug fix: Guid / uniqueidentifier in Sql Server now supported.


* Foreign keys can be explicitly set. Framework will not enforce referential integrity for those
properties if so.

Allows you to set a foreign key to null if the matching primary key table isn't in the C# model.
Referential integrity errors on the database server can occur if you introduce them this way.

* Internal methods/members of public facing types are marked as internal (or internal protected)
to reduce user's intellisense noise.

* Skipping assemblies that are not found in the file system during scannig of referenced
assemblies for primary/foreign table class matches. An exception had been occuring for some
assemblies, possibly becasue they were not in the bin folder due to being in the GAC.

* Adding an AppSettings key to explicitly enable or disable log messages. The key is:
"TestDataFramework-EnableLogger". The value to enable logging is "true".


Documentation is up to date on GitHub.

*  Guarantee methods work with primary keys properly.


* RecordReference.Set method fix.

* Guarantee... methods fix.