testfixtures

Prepare for 12.2.0 release

Prepare for 12.1.0 release

Prepare for 12.0.1 release

Prepare for 12.0.0 release

Prepare for 11.0.0 release

Prepare for 10.0.0 release

Prepare for 9.2.0 release

Prepare for 9.1.0 release

Prepare for 9.0.1 release

• Python 3.11 is now the minimum supported version.

• A show_whitespace parameter has been added to ShouldAssert.

• testfixtures is now fully typed, checked with mypy and is distributed with a py.typed marker file.

• ShouldRaise now supports ExceptionGroup.

• Fixed bug where ~testfixtures.comparers.compare_generator did not respect strict=True.

• Fixed bug in the type annotations for ShouldRaise and ~testfixtures.comparers.compare_exception.

• LogCapture will now raise an exception if closed while still installed. This can be a source of particularly confusing bugs.

• The strict option is now correctly respected when comparing nested objects.

• When comparing ~datetime.datetime or ~datetime.time instances, if the fold is the only thing that's different, it's now shown in the output.

• A more detailed exception is now raised when resolving a replacement doesn't give what's expected.

• Replacement of methods on instances is now prevented when strict=True.

• An exception is now raised when mocking and the original is not in the __dict__ of its containing objects.

• Fix bug where replacement of methods on subclasses failed when using Replacer.on_class.

• Implement strict comparison as an option for ~datetime.datetime and ~datetime.time.

• Retire zope.component helpers.

• Support bytes in popen.MockPopen commands.

• Allow TempDirectory instances to be traversed as ~pathlib.Path objects.

• Use the system default encoding where possible in TempDirectory.

• Add TempDirectory option to manage current working directory.

• Allow string class attributes to be replaced with Replacer and friends.

• Fix nasty bug meaning some ~Replacer.on_class and ~Replacer.in_module replacements weren't restored.

• Allow an alternative separator to be used for traversal during replacement with Replacer and friends.

• Officially support Python 3.12.

• Drop support Python 3.6.

• Fix bug in support for os.PathLike arguments to popen.MockPopen.

• Added missing support for os.PathLike arguments to popen.MockPopen.

• Add order_matters parameter to ShouldWarn.

Thanks to Jan Musílek for the implementation!

• Implement new IDE and static-analysis ways of mocking including additional parameters to ~Replacer.replace along with the replace_on_class, replace_in_module and replace_in_environ context managers.

• Remove py.typed file: neither mypy nor testfixtures are ready for this file to be present.

• Further bugfixes around self-referential datastructures and compare.

• Reinstate support for self-referential data structures in compare. The new implementation provides more clarity about what's going on and also ignores more immutable data types.

• Remove non-functional support for self-referential data structures in compare. The functionality didn't work but did cause erroneous reported equality of values in dictionaries that were actually not equal.

• Refresh documentation.

• Add type annotations.

• Drop support for Python 2. The minimum supported Python version is now 3.6.

• Sybil 3 is now the minimum supported version if you use ~.sybil.FileParser.

• Rename and refactor the date and time mocks, they are now mock_date, mock_datetime and mock_time. test_date, test_datetime and test_time are still present as aliases but are now deprecated.

• Add TempDirectory.as_string, TempDirectory.as_path and TempDirectory.as_local. TempDirectory.getpath is now deprecated.

• TempDirectory can now be used to wrap existing directories.

• Fixed a bug where OutputCapture.captured returned bytes instead of a string with fd=True.

• The deprecated strict option to Comparison has been removed, use the partial option instead.

• The deprecated TempDirectory.check, TempDirectory.check_dir and TempDirectory.check_all methods have been removed.

• Fix bug in detection of Mock backport.

• Ensure compatibility with Sybil 2 and Sybil 3 along with pytest 6 and pytest 7.

• Fix bug when using compare on two regular expressions that have very long patterns.

Thanks to Christoph Ludwig for the report.

• Fix bug that meant LogCapture didn't preserve or provide a clean testing environment for filters.

Thanks to Jesse Rittner for the fix.

• Fix bug when showing differences between mappings found by compare when mismatching values contained the same number more than once.

• Add support for lazy resolution of prefix and suffix when using compare.

• Fix bug where bug where duplicated entries in an ordered but partial SequenceComparison could result in a failed match.

• Add simpler flag support to StringComparison.

• Fix deprecation warning about invalid escape sequence.

Thanks to Wim Glenn for the deprecation warning fix.

• Simplify and clarify the documentation of timezones when using test_datetime .

• api has been re-arranged to make it easier to browse.

• The strict parameter to Comparison has been deprecated in favour of partial.

• Add SequenceComparison, Subset and Permutation objects.

• Add MappingComparison objects.

• Officially support Python 3.9.

• Add support to LogCapture for making sure log entries above a specified level have been checked.

Thanks to Zoltan Farkas for the implementation.

• Fix bug where ignore_eq had no effect on nested objects when using compare.

Thanks to Grégoire Payen de La Garanderie for the fix.

• Fix bugs in comparison of ~unittest.mock.call objects where the repr of the ~unittest.mock.call arguments were the same even when their attributes were not.

• Add support for non-deterministic logging order when using twisted.LogCapture.

• Fix for using compare to compare two-element ~unittest.mock.call objects.

Thanks to Daniel Fortunov for the fix.

• Allow any attributes that need to be ignored to be specified directly when calling ~testfixtures.comparers.compare_object. This is handy when writing comparers for compare.

• Fix a bug that occured when using compare to compare a string with a slotted object that had the same repr as the string.

• Add support for universal_newlines, text, encoding and errors to popen.MockPopen, but only for Python 3.

• decimal.Decimal now has better representation when compare displays a failed comparison, particularly on Python 2.

• Add support to compare for explicitly naming objects to be compared as x and y. This allows symmetry with the x_label and y_label parameters that are now documented.

• Restore ability for Comparison to compare properties and methods, although these uses are not recommended.

Thanks to Daniel Fortunov for all of the above.

• Fix bug where new-style classes had their attributes checked with compare even when they were of different types.

• Fix bugs in compare when comparing objects which have both __slots__ and a __dict__.

• Fix edge case where string interning made dictionary comparison output much less useful.

• Better feedback where objects do not compare equal but do have the same representation.

• Fix deprecation warning relating to getargspec.

• Improve mocking docs.

• Added strip_whitespace option to OutputCapture.

• When separate is used with OutputCapture, differences in stdout and stderr are now given in the same AssertionError.

• ShouldRaise no longer catches exceptions that are not of the required type.

• Fixed a problem that resulted in unhelpful compare failures when ~unittest.mock.call was involved and Python 3.6.7 was used.

Thanks to Łukasz Rogalski for the deprecation warning fix.

Thanks to Wim Glenn for the ShouldRaise idea.

• Fix handling of the latest releases of the mock backport.

• Fix bogus import in OutputCapture.

• Allow OutputCapture to capture the underlying file descriptors for sys.stdout and sys.stderr.

• Silence DeprecationWarning relating to collections.abc on Python 3.7.

Thanks to Tom Hendrikx for the fix.

• Add twisted.LogCapture.raise_logged_failure debugging helper.

• popen.MockPopen.set_command is now symmetrical with popen.MockPopen process instantiation in that both can be called with either lists or strings, in the same way as subprocess.Popen.

• Fixed bugs where using not_there to ensure a key or attribute was not there but would be set by a test would result in the test attribute or key being left behind.

• Add support for comparing ~functools.partial instances and fix comparison of functions and other objects where vars() returns an empty dict.

• Add the ability to ignore attributes of particular object types when using compare.

• Fix bug when compare was used with objects that had __slots__ inherited from a base class but where their __slots__ was an empty sequence.

• Fix bug when compare was used with objects that had __slots__ inherited from a base class.

• Experimental support for making assertions about events logged with Twisted's logging framework.

• Fix problems on Python 2 when the rolling backport of mock was not installed.