TestDataAutoGen 1.0.1

TestDataGenerator

A flexible C# library for automatic generation of randomized test data with rich customization via attributes. Simplifies creating complex test objects, including nested classes and collections.

Features

• Attribute-driven configuration of generated data values.
• Supports primitive types: int, long, double, float, decimal, bool, string, DateTime, Guid.
• Supports Nullable types and enums.
• Generates collections: List<T>, arrays, and dictionaries (Dictionary<TKey, TValue>).
• Handles nested complex objects recursively with configurable depth.
• Supports null values with configurable probability.
• Customizable ranges, string formats, fixed value lists, and collection sizes.
• Default values provided when attributes are not specified.

Installation

Use the NuGet package manager:

Install-Package TestDataGenerator

Or via .NET CLI:

dotnet add package TestDataGenerator

(Note: Package publishing pending - coming soon)

Usage

1. Define your class with FakeDataAttribute on properties

public class Person
{
    [FakeData(MinInt = 18, MaxInt = 99)]
    public int Age { get; set; }

    [FakeData(StringLength = 12)]
    public string Name { get; set; }

    [FakeData(MinCollectionCount = 2, MaxCollectionCount = 5)]
    public List<int> Scores { get; set; }

    public Address HomeAddress { get; set; }
}

public class Address
{
    [FakeData(StringLength = 20)]
    public string Street { get; set; }

    public string City { get; set; }
}

2. Generate test data

var person = TestDataGenerator.Generate<Person>();

3. Customize as needed

You can specify ranges, fixed values, string formats, null probabilities, and collection sizes:

[FakeData(MinDouble = 1.5, MaxDouble = 10.5, NullProbability = 0.1)]
public double? Score { get; set; }

[FakeData(FixedValues = new[] { "Red", "Green", "Blue" })]
public string FavoriteColor { get; set; }

Supported Attribute Properties

Limitations and Notes

• Maximum recursion depth for nested objects is limited to prevent stack overflow (default: 3).
• String format support is basic; custom implementations can extend it.
• Currently supports only generic collections like List<T>, arrays, and dictionaries.
• Nullability applies only to reference and nullable value types.
• Designed primarily for unit testing and development mock data generation.

Contributing

Contributions and suggestions are welcome! Please open issues or submit pull requests.

License

MIT License. See LICENSE file for details.

Contact

For questions or feedback, please reach out.

🎉 Pro Version Now Available!
Looking for more advanced features like schema-based generation, faker rules, and bulk data creation?

👉 Explore the Pro Version & Full Feature Comparison

🚀 Introducing TestDataAutoGen Pro!

Supercharge your test data generation with TestDataAutoGen Pro:

✅ JSON & XML schema-based generation
✅ Rule engine with custom property handling (e.g., emails, UUIDs)
✅ High-performance bulk generation
✅ More control, more flexibility

🔐 Pro is a private package available via GitHub NuGet feed.

📦 Learn more and request access: See Pro Version 📧 Contact: kumuddeveloper@gmail.com

This project is in active development. Stay tuned for upcoming releases and features!