base on AutoFixture is an open source library for .NET designed to minimize the 'Arrange' phase of your unit tests in order to maximize maintainability. Its primary goal is to allow developers to focus on what is being tested rather than how to setup the test scenario, by making it easier to create object graphs containing test data. # AutoFixture [](https://raw.githubusercontent.com/AutoFixture/AutoFixture/master/LICENCE.txt) [](https://ci.appveyor.com/project/AutoFixture/autofixture/branch/master) [](https://github.com/AutoFixture/AutoFixture/actions/workflows/release.yml) [](https://www.nuget.org/packages/AutoFixture) [](https://www.nuget.org/packages/AutoFixture) <a href="https://twitter.com/AutoFixture"> <img src="https://img.shields.io/twitter/follow/AutoFixture?label=%40AutoFixture" alt="AutoFixture" align="right" /> </a> Write maintainable unit tests, faster. AutoFixture makes it easier for developers to do Test-Driven Development by automating non-relevant Test Fixture Setup, allowing the Test Developer to focus on the essentials of each test case. Check the [testimonials](https://github.com/AutoFixture/AutoFixture/wiki/Who-uses-AutoFixture) to see what other people have to say about AutoFixture. ## Table of Contents - [Overview](#overview) - [Downloads](#downloads) - [Documentation](#documentation) - [Feedback & Questions](#feedback--questions) - [License](#license) ## Overview (Jump straight to the [CheatSheet](https://github.com/AutoFixture/AutoFixture/wiki/Cheat-Sheet) if you just want to see some code samples right away.) AutoFixture is designed to make Test-Driven Development more productive and unit tests more refactoring-safe. It does so by removing the need for hand-coding anonymous variables as part of a test's Fixture Setup phase. Among other features, it offers a generic implementation of the [Test Data Builder](http://www.natpryce.com/articles/000714.html) pattern. When writing unit tests, you typically need to create some objects that represent the initial state of the test. Often, an API will force you to specify much more data than you really care about, so you frequently end up creating objects that has no influence on the test, simply to make the code compile. AutoFixture can help by creating such [Anonymous Variables](https://docs.microsoft.com/en-us/archive/blogs/ploeh/anonymous-variables) for you. Here's a simple example: ```c# [Fact] public void IntroductoryTest() { // Arrange Fixture fixture = new Fixture(); int expectedNumber = fixture.Create<int>(); MyClass sut = fixture.Create<MyClass>(); // Act int result = sut.Echo(expectedNumber); // Assert Assert.Equal(expectedNumber, result); } ``` This example illustrates the basic principle of AutoFixture: It can create values of virtually any type without the need for you to explicitly define which values should be used. The number *expectedNumber* is created by a call to `Create<T>` - this will create a 'nice', regular integer value, saving you the effort of explicitly coming up with one. The example also illustrates how AutoFixture can be used as a [SUT Factory](http://blog.ploeh.dk/2009/02/13/SUTFactory.aspx) that creates the actual System Under Test (the MyClass instance). Given the right combination of unit testing framework and extensions for AutoFixture, we can further reduce the above test to be even more declarative: ### [xUnit](http://blog.ploeh.dk/2010/10/08/AutoDataTheoriesWithAutoFixture.aspx) ```c# [Theory, AutoData] public void IntroductoryTest(int expectedNumber, MyClass sut) { int result = sut.Echo(expectedNumber); Assert.Equal(expectedNumber, result); } ``` ### [NUnit](http://gertjvr.wordpress.com/2013/09/25/howto-autofixture-nunit2) ```c# [Test, AutoData] public void IntroductoryTest(int expectedNumber, MyClass sut) { int result = sut.Echo(expectedNumber); Assert.Equal(expectedNumber, result); } ``` Notice how we can reduce unit tests to state only the relevant parts of the test. The rest (variables, Fixture object) is relegated to attributes and parameter values that are supplied automatically by AutoFixture. The test is now only two lines of code. Using AutoFixture is as easy as referencing the library and creating a new instance of the Fixture class! ## Downloads AutoFixture packages are distributed via NuGet.<br /> To install the packages you can use the integrated package manager of your IDE, the .NET CLI, or reference the package directly in your project file. ```cmd dotnet add package AutoFixture --version 4.18.0 ``` ```xml <PackageReference Include="AutoFixture" Version="4.18.0" /> ``` AutoFixture offers a variety of utility packages and integrations with most of the major mocking libraries and testing frameworks. ### Core packages The core packages offer the full set of AutoFixture's features without requring any testing framework or third party integration. | Product | Package | Stable | Preview | Downloads | |---------|---------|--------|---------|-----------| | The core package | [AutoFixture](http://www.nuget.org/packages/AutoFixture) | [](https://www.nuget.org/packages/AutoFixture) | [](https://www.nuget.org/packages/AutoFixture)|  | | Assertion idioms | [AutoFixture.Idioms](http://www.nuget.org/packages/AutoFixture.Idioms) | [](https://www.nuget.org/packages/AutoFixture.Idioms) | [](https://www.nuget.org/packages/AutoFixture.Idioms)|  | | Seed extensions | [AutoFixture.SeedExtensions](http://www.nuget.org/packages/AutoFixture.SeedExtensions) | [](https://www.nuget.org/packages/AutoFixture.SeedExtensions) | [](https://www.nuget.org/packages/AutoFixture.SeedExtensions)|  | ### Mocking libraries AutoFixture offers integations with most major .NET mocking libraries.<br/> These integrations enable such features as configuring mocks, auto-injecting mocks, etc. | Product | Package | Stable | Preview | Downloads | |---------|---------|--------|---------|-----------| | Moq | [AutoFixture.AutoMoq](http://www.nuget.org/packages/AutoFixture.AutoMoq) | [](https://www.nuget.org/packages/AutoFixture.AutoMoq) | [](https://www.nuget.org/packages/AutoFixture.AutoMoq)|  | | NSubstitute | [AutoFixture.AutoNSubstitute](http://www.nuget.org/packages/AutoFixture.AutoNSubstitute) | [](https://www.nuget.org/packages/AutoFixture.AutoNSubstitute) | [](https://www.nuget.org/packages/AutoFixture.AutoNSubstitute)|  | | FakeItEasy | [AutoFixture.AutoFakeItEasy](http://www.nuget.org/packages/AutoFixture.AutoFakeItEasy) | [](https://www.nuget.org/packages/AutoFixture.AutoFakeItEasy) | [](https://www.nuget.org/packages/AutoFixture.AutoFakeItEasy)|  | | Rhino Mocks | [AutoFixture.AutoRhinoMocks](http://www.nuget.org/packages/AutoFixture.AutoRhinoMocks) | [](https://www.nuget.org/packages/AutoFixture.AutoRhinoMocks) | [](https://www.nuget.org/packages/AutoFixture.AutoRhinoMocks)|  | > **NOTE:** > Since AutoFixture tries maintain compatibility with a large number of package versions, the packages bundled with AutoFixture might not contain the latest features of your mocking library.<br /> > Make sure to install the latest version of the mocking library package, alongside the AutoFixture package. ### Testing frameworks AutoFixture offers integrations with most major .NET testing frameworks.<br /> These integrations enable auto-generation of test cases, combining auto-generated data with inline arguments, etc. | Product | Package | Stable | Preview | Downloads | |----------|---------|--------|---------|-----------| | xUnit v2 | [AutoFixture.Xunit2](http://www.nuget.org/packages/AutoFixture.Xunit2) | [](https://www.nuget.org/packages/AutoFixture.Xunit2) | [](https://www.nuget.org/packages/AutoFixture.Xunit2) |  | | NUnit v3 | [AutoFixture.NUnit3](http://www.nuget.org/packages/AutoFixture.NUnit3) | [](https://www.nuget.org/packages/AutoFixture.NUnit3) | [](https://www.nuget.org/packages/AutoFixture.NUnit3) |  | | xUnit v1 | [AutoFixture.Xunit](http://www.nuget.org/packages/AutoFixture.Xunit) | [](https://www.nuget.org/packages/AutoFixture.Xunit) | [](https://www.nuget.org/packages/AutoFixture.Xunit) |  | | NUnit v2 | [AutoFixture.NUnit2](http://www.nuget.org/packages/AutoFixture.NUnit2) | [](https://www.nuget.org/packages/AutoFixture.NUnit2) | [](https://www.nuget.org/packages/AutoFixture.NUnit2) |  | | Foq | [AutoFixture.AutoFoq](http://www.nuget.org/packages/AutoFixture.AutoFoq) | [](https://www.nuget.org/packages/AutoFixture.AutoFoq) | [](https://www.nuget.org/packages/AutoFixture.AutoFoq) |  | You can check the compatibility with your target framework version on the [wiki](https://github.com/AutoFixture/AutoFixture/wiki#net-platforms-compatibility-table) or on the [NuGet](https://www.nuget.org/profiles/AutoFixture) website. ### vNext feed The artifacts of the next major version are published to [nuget.org](https://www.nuget.org), and are marked with the `preview` suffix (e.g. `5.0.0-preview00007`).</br> You can use these packages to early access and test the next major version of the AutoFixture.</br> Make sure to enable the preview packages in your IDE in order to see the latest version. > __NOTE:__ This preview versions exists for the _preview purpose_ only, so use them with caution: > >* New versions of packages might contain breaking changes and API could change drastically from package to package. By other words, we don't follow the SemVer policy for the packages in this feed; >* Preview packages might be unlisted over time, in order to not clutter the version suggestion dialog in IDEs, but will generally remain available ## Documentation * [CheatSheet](https://github.com/AutoFixture/AutoFixture/wiki/Cheat-Sheet) * [FAQ](https://github.com/AutoFixture/AutoFixture/wiki/FAQ) ### Additional resources * [Pluralsight course](https://www.pluralsight.com/courses/unit-testing-autofixture-dot-net) * [ploeh blog](http://blog.ploeh.dk/tags/#AutoFixture-ref) * [Nikos Baxevanis' blog](http://blog.nikosbaxevanis.com) * [Enrico Campidoglio's blog](http://megakemp.com/tag/autofixture) * [Gert Jansen van Rensburg's blog](http://gertjvr.wordpress.com/category/autofixture) * [Questions on Stack Overflow](http://stackoverflow.com/questions/tagged/autofixture) ## Feedback & Questions If you have questions, feel free to ask. The best places to ask are: * [Stack Overflow - use the *autofixture* tag](http://stackoverflow.com/questions/tagged/autofixture) * [GitHub Q&A Discussions](https://github.com/AutoFixture/AutoFixture/discussions/categories/q-a) ## License AutoFixture is Open Source software and is released under the [MIT license](https://raw.githubusercontent.com/AutoFixture/AutoFixture/master/LICENCE.txt).<br /> The licenses allows the use of AutoFixture libraries in free and commercial applications and libraries without restrictions. ### .NET Foundation This project is supported by the [.NET Foundation](https://dotnetfoundation.org). ", Assign "at most 3 tags" to the expected json: {"id":"5354","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"