twisted.trial.unittest.SynchronousTestCase.callDeprecated(self, version, f, *args, **kwargs) method documentationtwisted.trial.unittest.SynchronousTestCase
View Source
Call a function that should have been deprecated at a specific version and in favor of a specific alternative, and assert that it was thusly deprecated.
| Parameters | version | A 2-sequence of (since, replacement), where since is a the first version that f should have been deprecated since, and replacement is a suggested replacement for the deprecated functionality, as described by twisted.python.deprecate.deprecated. If there is no suggested replacement, this parameter may also be simply a version by itself. |
| f | The deprecated function to call. | |
| args | The arguments to pass to f. | |
| kwargs | The keyword arguments to pass to f. | |
| Returns | Whatever f returns. | |
| Raises | Whatever f raises. If any exception is raised by f, though, no assertions will be made about emitted deprecations. | |
| FailTest | if no warnings were emitted by f, or if the DeprecationWarning emitted did not produce the canonical please-use-something-else message that is standard for Twisted deprecations according to the given version and replacement. | |