An extension that adds Project and Item templates to Visual Studio along with Code Snippets to make unit testing with NUnit 3 easier. We currently only plan to add templates for NUnit 3, but will add templates for NUnit 2.6.4 if there is demand.
This project is build using SideWaffle, many thanks for their great work.
You can download the extension for Visual Studio 2012-2019 from the Visual Studio Gallery or from the GitHub Releases page.
The project currently provides the following templates.
| Template | Platform | Language | Project Type |
|---|---|---|---|
| NUnit 3 Unit Test Project | Desktop | C# | Traditional Style 3 |
| NUnit 3 Unit Test Project | Desktop | C# | Sdk Style |
| NUnit 3 Unit Test Project | Desktop .NET Core | C# | SDK Style |
| NUnit 3 Unit Test Project | Desktop | Visual Basic | Traditional Style 3 |
| NUnit 3 Unit Test Project | Xamarin Android 1 | C# | Traditional Style |
| NUnit 3 Unit Test Project | Xamarin iOS 1 | C# | Traditional Style |
| NUnit 3 Unit Test Project | Xamarin UWP 1,2 | C# | Traditional Style |
- Requires Xamarin for Visual Studio be installed.
- Requires the Windows 10 SDK be installed.
- Legacy csproj format
| Template | Language | Description |
|---|---|---|
| NUnit Test Fixture | C# | An NUnit unit test class |
| NUnit Test Fixture | Visual Basic | An NUnit unit test class |
| NUnit SetUp Fixture | C# | Code that runs before and after all the tests in the assembly |
| NUnit SetUp Fixture | Visual Basic | Code that runs before and after all the tests in the assembly |
| Snippet | Shortcut | Language | Comment |
|---|---|---|---|
| Test Fixture | ntestfixture | C# | |
| Test Method | ntest | C# | |
| Test Case | ntestcase | C# | |
| Test Case Source | ntestcasesource | C# | Form 1 |
| Test Case Source | ntestcasesource2 | C# | Form 2 |
| Test Case Source | ntestcasesource3 | C# | Form 3 |
| Test Case Source | ntestcasesource4 | C# | Form 3 with testdata |
| Assert.Multiple | nmultiple | C# | Surround snippet |
Note: "Form": Refer to documentation for details
Don't see the template you need or your favorite code snippet? All you need to do is fork the repository, add it and create a pull request. We love help and contributions.
For information on how to add templates and snippets, head over to the SideWaffle Documentation.
There is also a great walkthrough on creating templates in the June 2015 MSDN Magazine.
We highly recommend that you use the following extensions for Visual Studio when working on this project.
- SideWaffle (Not needed, now included as nuget package) - Adds the templates and functionality you will need to work on this project.
- Snippet Designer - Provides a friendly UI for editing code snippets.
- EditorConfig - Configures tabs and spaces to the project defaults.
- Rebracer - Configures code formating to the NUnit project defaults in Visual Studio.
- Add a new project that will serve as your template
- Modify the project to ensure it builds and produces the correct output
- Right click on the nunit.templates project and select Add | Add Template Reference (SideWaffle project).
- Select your project from the dropdown and add it.
- Your project will have two new files added,
_Definitions\_project.vstemplate.xmland_preprocess.xml. - Edit both of these files using those from other projects as a reference.
- Delete sw-file-icon.png from your project.
- Copy nunit.png from nunit-tests.csharp into your project directory, but don't add it to your project.
- Remove packages.config and edit the project file to remove all of your NuGet references.
- Add NuGet packages to your vstemplate file. See the other vstemplate files and NuGet docs for more information.
- If the NuGet package isn't already in the
nunit.templates\Packagesdirectory, you will have to add it, set it as Include in VSIX and add it to the vsixmanifest file. - Test your project template by compiling and running the project. This will open an experimental instance of Visual Studio with the extension installed for testing.
- Once you are happy with your project, remove it from all build configurations.- Add your project template to README.md
- Push your branch to GitHub and create a Pull Request
- Right-click on the ItemTemplates\Test folder in the nunit.templates project, Add | New Item... and add a SideWaffle Item Template. Don't worry about the name, it is not used
- This will create a CSharp folder, rename it for your template
- Add your source file into your new folder and set the Build Action in properties to Content
- Replace your namespace with $rootnamespace$ and your class name with $safeitemname$
- Four vstemplate files were created in a Definitions sub-folder. Delete any for languages your template does not support and then rename the remaining from *.vstemplat- to *.vstemplate
- Fill in the vstemplate files using existing templates as a reference
- Delete the readme.txt file and overwrite icon.png with an existing NUnit icon from another template.
- Test your item template by compiling and running the project. This will open an experimental instance of Visual Studio with the extension installed for testing.
- Add your item template to README.md
- Push your branch to GitHub and create a Pull Request
- In the language specific Snippets folder of the nunit.templates project, right click on the Test folder and Add | New item...*
- Search for snippet and add a new Code Snippet
- Make sure the build type for your new snippet is set to Content in the properties
- Edit your snippet making sure to give it a unique shortcut. We are currently starting all NUnit snippets with the letter n
- Test your snippet by compiling and running the project. This will open an experimental instance of Visual Studio with the extension installed for testing.
- Add your snippet to README.md
- Push your branch to GitHub and create a Pull Request