Framework Release Notes

NUnit 3.7.1 - June 6, 2017

This is a hotfix release that addresses occasional hangs when using test parallization and fixes crashes in NCrunch prior to version 3.9.

Issues Resolved

• 2205 Ncrunch: System.Xml.XmlException: Root element is missing, when adding NUnit 3.7.0
• 2209 NUnit occasionally hangs when parallelizable TestFixture has OneTimeSetUp and OneTimeTearDown

NUnit 3.7 - May 29, 2017

This release of NUnit expands on parallel test execution to allow test methods to be run in parallel. Please see the Parallelizable Attribute for more information.

NUnit 3.7 also drops the Portable build of the framework and replaces it with a .NET Standard 1.3 version to compliment the .NET Standard 1.6 version. This change enables several constraints and other features in the .NET Standard builds that weren't available in portable like Path and Directory based asserts.

The AssertionHelper class has been deprecated because it is seldom used and has not received any of the updates that Asserts and Constraints receive. If your code is using the AssertionHelper class, we recommend that you migrate your asserts.

Issues Resolved

• 164 Run test methods within a fixture in parallel
• 391 Multiple Assertions
• 652 Add ability to execute test actions before SetUp or OneTimeSetUp
• 1000 Support multiple Author attributes per test
• 1096 Treat OneTimeSetup and OneTimeTearDown as separate work items
• 1143 NUnitLite - Explore flag does not apply where filter to output
• 1238 Feature request: Print LoaderExceptions when fixture loading fails
• 1363 Make Timeouts work without running test on its own thread
• 1474 Several SetUpFixtures at the same level may be active at the same time
• 1819 TestContext.Progress.Write writes new line
• 1830 Add --labels switch changes to nunilite and nunitlite tests
• 1859 ConcurrentQueue is duplicate with System.Threading.dll package
• 1877 Resolve differences between NUnit Console and NUnitLite implementations of @filename
• 1885 Test parameter containing a semicolon
• 1896 Test has passed however Reason with an empty message is printed in the xml
• 1918 Changing DefaultFloatingPointTolerance breaks tests running in parallel
• 1932 NUnit Warn class should be removed from stack trace by filter
• 1934 NullReferenceException when null arguments are used in TestFixtureAttribute
• 1952 TestContext.Out null when used in task with .NET Core
• 1963 Investigate removing SpecialValue
• 1965 TestContext does not flow in async method
• 1971 Switch CHANGES.txt to Markdown
• 1973 Implemented TestExecutionContext to use AsyncLocal<> for NETSTANDARD1_6
• 1975 TestFixtureSource doesn't work with a class that has no namespace
• 1983 Add missing ConstraintExpression.Contain overload
• 1990 Add namespace filter
• 1997 Remove unused --verbose and --full command line options
• 1999 Author Tests assume ICustomAttributeProvider.GetCustomAttributes return order is defined
• 2003 Better user info about ParallelizableAttribute and ParallelScope
• 2005 Exclude empty failure messages from results xml
• 2007 3.6 Multiple assertion backwards compatibility
• 2010 Add DelayedConstraint in NetStandard 1.6 build
• 2020 Better message when timeout fails
• 2023 Ability to abort threads running a message pump
• 2025 NullReferenceException using Is.EqualTo on two unequal strings
• 2030 Add method to mark tests as invalid with a reason
• 2031 Limit Language level to C#6
• 2034 Remove silverlight project - no longer used
• 2035 NullReferenceException inside failing Assert.That call
• 2040 Cannot catch AssertionException
• 2045 NUnitlite-runner crashes if no file is provided
• 2050 Creation of TestExecutionContext should be explicit
• 2052 NullReferenceException with TestCaseSource if a property has no setter
• 2061 TestContext.WorkDirectory not initialized during build process
• 2079 Make TestMethod.Arguments public or otherwise accessible (e.g. TestContext)
• 2080 Allow comments in @FILE files
• 2087 Enhance error message: Test is not runnable in single-threaded context. Timeout
• 2092 Convert Portable library to .NET Standard 1.3
• 2095 Extend use of tolerance to ComparisonConstraints
• 2099 Include type in start-suite/start-test report elements
• 2110 NullReferenceException when getting TestDirectory from TestContext
• 2115 Mark AssertionHelper as Obsolete
• 2121 Chained PropertyConstraint constraints report incorrect ActualValue
• 2131 Remove "Version 3" suffix from NUnitLite NuGet Package
• 2132 TestFixtureTests.CapturesArgumentsForConstructorWithMultipleArgsSupplied assumes order of custom attributes
• 2143 Non-parallel fixture with parallel children runs in parallel with other fixtures
• 2147 Test Assembly using NUnitLite & Nunit 3.6.1 hangs under .NET Core when --timeout is supplied on command line
• 2150 Add portable-slow-tests to Cake file
• 2152 Allow attaching files to TestResults
• 2154 Fix execution of non-parallel test fixtures
• 2157 Getting WorkerId inside Assert.Throws / DoesNotThrow returns null instead of previous non-null value
• 2158 Update SetupFixtureAttribute XML Docs
• 2159 Prevent crash in .NET standard with log file path
• 2165 Trying to install NUnit 3.6.1 on .NET Framework asks for download of 20 more packages
• 2169 Incorrect xmldocs for SetUpAttribute
• 2170 Cake build fails if only Visual Studio 2017 installed
• 2173 Remove PreTestAttribute and PostTestAttribute
• 2186 Replace special characters as part of converting branch names to package versions
• 2191 System.Reflection.TargetInvocationException with nunit3-console --debug on Mono

NUnit 3.6.1 - February 26, 2017

This is a hotfix release of the framework that addresses critical issues found in the 3.6 release.

Issues Resolved

• 1962 A Theory with no data passes
• 1986 NUnitLite ignores --workers option
• 1994 NUnitLite runner crashing when --trace is specified
• 2017 Two NUnit project's tests fail on systems with comma decimal mark settings
• 2043 Regression in 3.6.0 when catching AssertionException

NUnit 3.6 - January 9, 2017

This release of the framework no longer includes builds for Compact Framework or for SilverLight, but adds a .NET Standard 1.6 build. If anyone still using Compact Framework or SilverLight and would like to continue development on those versions of the framework, please contact the NUnit team.

Framework

• .NET Standard 1.6 is now supported
• Adds support for Multiple Assert blocks
• Added the --params option to NUnitLite
• Theories now support Nullable enums
• Improved assert error messages to help differentiate differences in values
• Added warnings with Warn.If(), Warn.Unless() and Assert.Warn()
• Enabled Path, File and Directory Asserts/Contraints for .NET Core testing
• Added NonTestAssemblyAttribute for use by third-party developers to indicate that their assemblies reference the NUnit framework, but do not contain tests

Issues Resolved

• 406 Warning-level Assertions
• 890 Allow file references anywhere in the command line.
• 1380 Appveyor Failures when branch name is too long
• 1589 Split the nunit repository into multiple repositories
• 1599 Move Compact Framework to separate project
• 1601 Move Silverlight to a separate project
• 1609 Upgrade Cake build to latest version
• 1661 Create .NET Standard Framework Build
• 1668 Need implementation-independent way to test number of items in a collection
• 1743 Provide multiple results for a test case in the XML output
• 1758 No direct inverse for Contains.Key
• 1765 TestCaseSourceAttribute constructor for method with parameters
• 1802 Design Multiple Assert syntax as seen by users
• 1808 Disambiguate error messages from EqualConstraint
• 1811 Build.ps1 fails if spaces in path
• 1823 Remove engine nuspecs and old global.json
• 1827 Remove unused repository paths from repositories.config
• 1828 Add Retry for failed tests only
• 1829 NUnitLite accepts --params option but does not make any use of it.
• 1836 Support nullable enums in Theories
• 1837 [Request] AfterContraint to support more readable usage
• 1840 Remove SL and CF #Defined source
• 1866 [Request] More readable way to set polling interval in After constraint
• 1870 EqualConstraint result failure message for DateTime doesn't show sufficient resolution
• 1872 Parameterized method being called with no parameter
• 1876 What should we do about Env.cs
• 1880 AttributeUsage for various Attributes
• 1889 Modify nunitlite to display multiple assert information
• 1891 TestContext.Progress and TestContext.Error silently drop text that is not properly XML encoded
• 1901 Make nunitlite-runner Prefer32Bit option consistent across Debug/Release
• 1904 Add .NET Standard 1.6 Dependencies to the Nuspec Files
• 1907 Handle early termination of multiple assert block
• 1911 Changing misleading comment that implies that every ICollection is a list
• 1912 Add new warning status and result state
• 1913 Report Warnings in NUnitLite
• 1914 Extra AssertionResult entries in TestResults
• 1915 Enable Path, File and Directory Assert/Constraints in the .NET Standard Build
• 1917 Use of IsolatedContext breaks tests in user-created AppDomain
• 1924 Run tests using the NUnit Console Runner
• 1929 Rename zip and remove source zip
• 1933 Tests should pass if test case source provides 0 test cases
• 1941 Use dictionary-based property for test run parameters
• 1945 Use high-quality icon for nuspecs
• 1947 Add NonTestAssemblyAttribute
• 1954 Change Error Message for Assert.Equals
• 1960 Typo fixes
• 1966 Xamarin Runner cannot reference NUnit NuGet Package

Earlier Releases

• Release Notes for NUnit 2.9.1 through 3.5
• Release Notes for NUnit 2.6 through 2.6.4
• Release Notes for NUnit 2.5 through 2.5.10
• Release Notes for NUnit 2.4 through 2.4.8
• Release Notes for NUnit 2.0 through 2.2.10