/
changes.txt
686 lines (448 loc) · 19.8 KB
/
changes.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
Changes
=======
.. currentmodule:: testfixtures
4.13.1 (2 November 2016)
------------------------
- When ``ignore_eq`` is used with :func:`compare`, fall back to comparing by
hash if not type-specific comparer can be found.
4.13.0 (2 November 2016)
------------------------
- Add support to :func:`compare` for ignoring broken ``__eq__`` implementations.
4.12.0 (18 October 2016)
------------------------
- Add support for specifying a callable to extract rows from log records
when using :class:`LogCapture`.
- Add support for recursive comparison of log messages with :class:`LogCapture`.
4.11.0 (12 October 2016)
-------------------------
- Allow the attributes returned in :meth:`LogCapture.actual` rows to be
specified.
- Allow a default to be specified for encoding in :meth:`TempDirectory.read` and
:meth:`TempDirectory.write`.
4.10.1 (5 September 2016)
-------------------------
- Better docs for :meth:`TempDirectory.compare`.
- Remove the need for expected paths supplied to :meth:`TempDirectory.compare`
to be in sorted order.
- Document a good way of restoring ``stdout`` when in a debugger.
- Fix handling of trailing slashes in :meth:`TempDirectory.compare`.
Thanks to Maximilian Albert for the :meth:`TempDirectory.compare` docs.
4.10.0 (17 May 2016)
--------------------
- Fixed examples in documentation broken in 4.5.1.
- Add :class:`RangeComparison` for comparing against values that fall in a
range.
- Add :meth:`~popen.MockPopen.set_default` to :class:`~popen.MockPopen`.
Thanks to Asaf Peleg for the :class:`RangeComparison` implementation.
4.9.1 (19 February 2016)
------------------------
- Fix for use with PyPy, broken since 4.8.0.
Thanks to Nicola Iarocci for the pull request to fix.
4.9.0 (18 February 2016)
------------------------
- Added the `suffix` parameter to :func:`compare` to allow failure messages
to include some additional context.
- Update package metadata to indicate Python 3.5 compatibility.
Thanks for Felix Yan for the metadata patch.
Thanks to Wim Glenn for the suffix patch.
4.8.0 (2 February 2016)
-----------------------
- Introduce a new :class:`Replace` context manager and make :class:`Replacer`
callable. This gives more succinct and easy to read mocking code.
- Add :class:`ShouldWarn` and :class:`ShouldNotWarn` context managers.
4.7.0 (10 December 2015)
------------------------
- Add the ability to pass ``raises=False`` to :func:`compare` to just get
and resulting message back rather than having an exception raised.
4.6.0 (3 December 2015)
------------------------
- Fix a bug that mean symlinked directories would never show up when using
:meth:`TempDirectory.compare` and friends.
- Add the ``followlinks`` parameter to :meth:`TempDirectory.compare` to
indicate that symlinked or hard linked directories should be recursed into
when using ``recursive=True``.
4.5.1 (23 November 2015)
------------------------
- Switch from :class:`cStringIO` to :class:`StringIO` in :class:`OutputCapture`
to better handle unicode being written to `stdout` or `stderr`.
Thanks to "tell-k" for the patch.
4.5.0 (13 November 2015)
------------------------
- :class:`LogCapture`, :class:`OutputCapture` and :class:`TempDirectory` now
explicitly show what is expected versus actual when reporting differences.
Thanks to Daniel Fortunov for the pull request.
4.4.0 (1 November 2015)
-----------------------
- Add support for labelling the arguments passed to :func:`compare`.
- Allow ``expected`` and ``actual`` keyword parameters to be passed to
:func:`compare`.
- Fix ``TypeError: unorderable types`` when :func:`compare` found multiple
differences in sets and dictionaries on Python 3.
- Add official support for Python 3.5.
- Drop official support for Python 2.6.
Thanks to Daniel Fortunov for the initial ideas for explicit ``expected`` and
``actual`` support in :func:`compare`.
4.3.3 (15 September 2015)
-------------------------
- Add wheel distribution to release.
- Attempt to fix up various niggles from the move to Travis CI for doing
releases.
4.3.2 (15 September 2015)
-------------------------
- Fix broken 4.3.1 tag.
4.3.1 (15 September 2015)
-------------------------
- Fix build problems introduced by moving the build process to Travis CI.
4.3.0 (15 September 2015)
-------------------------
- Add :meth:`TempDirectory.compare` with a cleaner, more explicit API that
allows comparison of only the files in a temporary directory.
- Deprecate :meth:`TempDirectory.check`, :meth:`TempDirectory.check_dir`
and :meth:`TempDirectory.check_all`
- Relax absolute-path rules so that if it's inside the :class:`TempDirectory`,
it's allowed.
- Allow :class:`OutputCapture` to separately check output to ``stdout`` and
``stderr``.
4.2.0 (11 August 2015)
----------------------
- Add :class:`~testfixtures.popen.MockPopen`, a mock helpful when testing
code that uses :class:`subprocess.Popen`.
- :class:`ShouldRaise` now subclasses :class:`object`, so that subclasses of it
may use :meth:`super()`.
- Drop official support for Python 3.2.
Thanks to BATS Global Markets for donating the code for
:class:`~testfixtures.popen.MockPopen`.
4.1.2 (30 January 2015)
-----------------------
- Clarify documentation for ``name`` parameter to :class:`LogCapture`.
- :class:`ShouldRaise` now shows different output when two exceptions have
the same representation but still differ.
- Fix bug that could result in a :class:`dict` comparing equal to a
:class:`list`.
Thanks to Daniel Fortunov for the documentation clarification.
4.1.1 (30 October 2014)
-------------------------
- Fix bug that prevented logger propagation to be controlled by the
:class:`log_capture` decorator.
Thanks to John Kristensen for the fix.
4.1.0 (14 October 2014)
-------------------------
- Fix :func:`compare` bug when :class:`dict` instances with
:class:`tuple` keys were not equal.
- Allow logger propagation to be controlled by :class:`LogCapture`.
- Enabled disabled loggers if a :class:`LogCapture` is attached to them.
Thanks to Daniel Fortunov for the :func:`compare` fix.
4.0.2 (10 September 2014)
-------------------------
- Fix "maximum recursion depth exceeded" when comparing a string with
bytes that did not contain the same character.
4.0.1 (4 August 2014)
---------------------
- Fix bugs when string compared equal and options to :func:`compare`
were used.
- Fix bug when strictly comparing two nested structures containing
identical objects.
4.0.0 (22 July 2014)
--------------------
- Moved from buildout to virtualenv for development.
- The ``identity`` singleton is no longer needed and has been
removed.
- :func:`compare` will now work recursively on data structures for
which it has registered comparers, giving more detailed feedback on
nested data structures. Strict comparison will also be applied
recursively.
- Re-work the interfaces for using custom comparers with
:func:`compare`.
- Better feedback when comparing :func:`collections.namedtuple`
instances.
- Official support for Python 3.4.
Thanks to Yevgen Kovalienia for the typo fix in :doc:`datetime`.
3.1.0 (25 May 2014)
-------------------
- Added :class:`RoundComparison` helper for comparing numerics to a
specific precision.
- Added ``unless`` parameter to :class:`ShouldRaise` to cover
some very specific edge cases.
- Fix missing imports that showed up :class:`TempDirectory` had to do
the "convoluted folder delete" dance on Windows.
Thanks to Jon Thompson for the :class:`RoundComparison` implementation.
Thanks to Matthias Lehmann for the import error reports.
3.0.2 (7 April 2014)
--------------------
- Document :attr:`ShouldRaise.raised` and make it part of the official
API.
- Fix rare failures when cleaning up :class:`TempDirectory` instances
on Windows.
3.0.1 (10 June 2013)
--------------------
- Some documentation tweaks and clarifications.
- Fixed a bug which masked exceptions when using :func:`compare` with
a broken generator.
- Fixed a bug when comparing a generator with a non-generator.
- Ensure :class:`LogCapture` cleans up global state it may effect.
- Fixed replacement of static methods using a :class:`Replacer`.
3.0.0 (5 March 2013)
--------------------
- Added compatibility with Python 3.2 and 3.3.
- Dropped compatibility with Python 2.5.
- Removed support for the following obscure uses of
:class:`should_raise`:
.. code-block:: python
should_raise(x, IndexError)[1]
should_raise(x, KeyError)['x']
- Dropped the `mode` parameter to :meth:`TempDirectory.read`.
- :meth:`TempDirectory.makedir` and :meth:`TempDirectory.write` no
longer accept a `path` parameter.
- :meth:`TempDirectory.read` and :meth:`TempDirectory.write` now
accept an `encoding` parameter to control how non-byte data is
decoded and encoded respectively.
- Added the `prefix` parameter to :func:`compare` to allow failure
messages to be made more informative.
- Fixed a problem when using sub-second deltas with :func:`test_time`.
2.3.5 (13 August 2012)
----------------------
- Fixed a bug in :func:`~testfixtures.comparison.compare_dict` that
mean the list of keys that were the same was returned in an unsorted
order.
2.3.4 (31 January 2012)
-----------------------
- Fixed compatibility with Python 2.5
- Fixed compatibility with Python 2.7
- Development model moved to continuous integration using Jenkins.
- Introduced `Tox`__ based testing to ensure packaging and
dependencies are as expected.
__ http://tox.testrun.org/latest/
- 100% line and branch coverage with tests.
- Mark :class:`test_datetime`, :class:`test_date` and
:class:`test_time` such that nose doesn't mistake them as tests.
2.3.3 (12 December 2011)
-------------------------
- Fixed a bug where when a target was replaced more than once using a
single :class:`Replacer`, :meth:`~Replacer.restore` would not
correctly restore the original.
2.3.2 (10 November 2011)
-------------------------
- Fixed a bug where attributes and keys could not be
removed by a :class:`Replacer` as described in
:ref:`removing_attr_and_item` if the attribute or key might not be
there, such as where a test wants to ensure an ``os.environ``
variable is not set.
2.3.1 (8 November 2011)
-------------------------
- Move to use `nose <http://readthedocs.org/docs/nose/>`__ for running
the TestFixtures unit tests.
- Fixed a bug where :meth:`tdatetime.now` returned an instance of the
wrong type when `tzinfo` was passed in
:ref:`strict mode <strict-dates-and-times>`.
2.3.0 (11 October 2011)
-------------------------
- :class:`Replacer`, :class:`TempDirectory`, :class:`LogCapture` and
:class:`~components.TestComponents` instances will now warn if the
process they are created in exits without them being cleaned
up. Instances of these classes should be cleaned up at the end of
each test and these warnings serve to point to a cause for possible
mysterious failures elsewhere.
2.2.0 (4 October 2011)
-------------------------
- Add a :ref:`strict mode <strict-dates-and-times>` to
:class:`test_datetime` and :class:`test_date`.
When used, instances returned from the mocks are instances of those
mocks. The default behaviour is now to return instances of the real
:class:`~datetime.datetime` and :class:`~datetime.date` classes
instead, which is usually much more useful.
2.1.0 (29 September 2011)
-------------------------
- Add a :ref:`strict mode <strict-comparison>` to
:func:`compare`. When used, it ensures that
the values compared are not only equal but also of the same
type. This mode is not used by default, and the default mode
restores the more commonly useful functionality where values of
similar types but that aren't equal give useful feedback about
differences.
2.0.1 (23 September 2011)
-------------------------
- add back functionality to allow comparison of generators with
non-generators.
2.0.0 (23 September 2011)
-------------------------
- :func:`compare` now uses a registry of comparers that can be
modified either by passing a `registry` option to :func:`compare`
or, globally, using the :func:`~comparison.register` function.
- added a comparer for :class:`set` instances to :func:`compare`.
- added a new `show_whitespace` parameter to
:func:`~comparison.compare_text`, the comparer used when comparing
strings and unicodes with :func:`compare`.
- The internal queue for :class:`test_datetime` is now considered to
be in local time. This has implication on the values returned from
both :meth:`~tdatetime.now` and :meth:`~tdatetime.utcnow` when
`tzinfo` is passed to the :class:`test_datetime` constructor.
- :meth:`set` and :meth:`add` on :class:`test_date`,
:class:`test_datetime` and :class:`test_time` now accept instances
of the appropriate type as an alternative to just passing in the
parameters to create the instance.
- Refactored the monolithic ``__init__.py`` into modules for each
type of functionality.
1.12.0 (16 August 2011)
-----------------------
- Add a :attr:`~OutputCapture.captured` property to
:class:`OutputCapture` so that more complex assertion can be made
about the output that has been captured.
- :class:`OutputCapture` context managers can now be temporarily
disabled using their :meth:`~OutputCapture.disable` method.
- Logging can now be captured only when it exceeds a specified logging
level.
- The handling of timezones has been reworked in both
:func:`test_datetime` and :func:`test_time`. This is not backwards
compatible but is much more useful and correct.
1.11.3 (3 August 2011)
----------------------
- Fix bugs where various :meth:`test_date`, :meth:`test_datetime` and
:meth:`test_time` methods didn't accept keyword parameters.
1.11.2 (28 July 2011)
---------------------
- Fix for 1.10 and 1.11 releases that didn't include non-.py files as
a result of the move from subversion to git.
1.11.1 (28 July 2011)
---------------------
- Fix bug where :meth:`tdatetime.now` didn't accept the `tz`
parameter that :meth:`datetime.datetime.now` did.
1.11.0 (27 July 2011)
---------------------
- Give more useful output when comparing dicts and their subclasses.
- Turn :class:`should_raise` into a decorator form of
:class:`ShouldRaise` rather than the rather out-moded wrapper
function that it was.
1.10.0 (19 July 2011)
---------------------
- Remove dependency on :mod:`zope.dottedname`.
- Implement the ability to mock out :class:`dict` and :class:`list`
items using :class:`~testfixtures.Replacer` and
:func:`~testfixtures.replace`.
- Implement the ability to remove attributes and :class:`dict`
items using :class:`~testfixtures.Replacer` and
:func:`~testfixtures.replace`.
1.9.2 (20 April 2011)
---------------------
- Fix for issue #328: :meth:`~tdatetime.utcnow` of :func:`test_datetime`
now returns items from the internal queue in the same way as
:meth:`~tdatetime.now`.
1.9.1 (11 March 2011)
------------------------
- Fix bug when :class:`ShouldRaise` context managers incorrectly
reported what exception was incorrectly raised when the incorrectly
raised exception was a :class:`KeyError`.
1.9.0 (11 February 2011)
------------------------
- Added :class:`~components.TestComponents` for getting a sterile
registry when testing code that uses :mod:`zope.component`.
1.8.0 (14 January 2011)
-----------------------
- Added full Sphinx-based documentation.
- added a `Manuel <http://packages.python.org/manuel/>`__ plugin for
reading and writing files into a :class:`TempDirectory`.
- any existing log handlers present when a :class:`LogCapture` is
installed for a particular logger are now removed.
- fix the semantics of :class:`should_raise`, which should always
expect an exception to be raised!
- added the :class:`ShouldRaise` context manager.
- added recursive support to :meth:`TempDirectory.listdir` and added
the new :meth:`TempDirectory.check_all` method.
- added support for forward-slash separated paths to all relevant
:class:`TempDirectory` methods.
- added :meth:`TempDirectory.getpath` method.
- allow files and directories to be ignored by a regular expression
specification when using :class:`TempDirectory`.
- made :class:`Comparison` objects work when the attributes expected
might be class attributes.
- re-implement :func:`test_time` so that it uses the correct way to
get timezone-less time.
- added :meth:`~tdatetime.set` along with `delta` and `delta_type`
parameters to :func:`test_date`, :func:`test_datetime` and
:func:`test_time`.
- allow the date class returned by the :meth:`tdatetime.date` method
to be configured.
- added the :class:`OutputCapture` context manager.
- added the :class:`StringComparison` class.
- added options to ignore trailing whitespace and blank lines when
comparing multi-line strings with :func:`compare`.
- fixed bugs in the handling of some exception types when using
:class:`Comparison`, :class:`ShouldRaise` or :class:`should_raise`.
- changed :func:`wrap` to correctly set __name__, along with some
other attributes, which should help when using the decorators with
certain testing frameworks.
1.7.0 (20 January 2010)
-----------------------
- fixed a bug where the @replace decorator passed a classmethod
rather than the replacment to the decorated callable when replacing
a classmethod
- added set method to test_date, test_datetime and test_time to allow
setting the parameters for the next instance to be returned.
- added delta and delta_type parameters to test_date,test_datetime and
test_time to control the intervals between returned instances.
1.6.2 (23 September 2009)
-------------------------
- changed Comparison to use __eq__ and __ne__ instead of the
deprecated __cmp__
- documented that order matters when using Comparisons with objects
that implement __eq__ themselves, such as instances of Django
models.
1.6.1 (06 September 2009)
-------------------------
- @replace and Replacer.replace can now replace attributes that may
not be present, provided the `strict` parameter is passed as False.
- should_raise now catches BaseException rather than Exception so
raising of SystemExit and KeyboardInterrupt can be tested.
1.6.0 (09 May 2009)
-------------------
- added support for using TempDirectory, Replacer and LogCapture as
context managers.
- fixed test failure in Python 2.6.
1.5.4 (11 Feb 2009)
-------------------
- fix bug where should_raise didn't complain when no exception
was raised but one was expected.
- clarified that the return of a should_raise call will be None
in the event that an exception is raised but no expected
exception is specified.
1.5.3 (17 Dec 2008)
-------------------
- should_raise now supports methods other than __call__
1.5.2 (14 Dec 2008)
-------------------
- added `makedir` and `check_dir` methods to TempDirectory and added
support for sub directories to `read` and `write`
1.5.1 (12 Dec 2008)
-------------------
- added `path` parameter to `write` method of TempDirectory so
that the full path of the file written can be easilly obtained
1.5.0 (12 Dec 2008)
-------------------
- added handy `read` and `write` methods to TempDirectory for
creating and reading files in the temporary directory
- added support for rich comparison of objects that don't support
vars()
1.4.0 (12 Dec 2008)
-------------------
- improved representation of failed Comparison
- improved representation of failed compare with sequences
1.3.1 (10 Dec 2008)
-------------------
- fixed bug that occurs when directory was deleted by a test that
use tempdir or TempDirectory
1.3.0 (9 Dec 2008)
------------------
- added TempDirectory helper
- added tempdir decorator
1.2.0 (3 Dec 2008)
------------------
- LogCaptures now auto-install on creation unless configured otherwise
- LogCaptures now have a clear method
- LogCaptures now have a class method uninstall_all that uninstalls
all instances of LogCapture. Handy for a tearDown method in doctests.
1.1.0 (3 Dec 2008)
------------------
- add support to Comparisons for only comparing some attributes
- move to use zope.dottedname
1.0.0 (26 Nov 2008)
-------------------
- Initial Release