« back to all changes in this revision
Viewing changes to bzrlib/tests/__init__.py
- browse files at revision 2566
- compare with another revision
- compare with revision 2052.6.2
- download diff
- download tarball
- view history from revision 2566
- Committer: Canonical.com Patch Queue Manager
- Date: 2007-06-29 15:01:44 UTC
- mfrom: (2399.1.17 doc-cleanup)
- Revision ID: pqm@pqm.ubuntu.com-20070629150144-xoeghcfb52pit8tv
(John Arbash Meinel) Improve 'make api-docs' output.
- files modified:
- bzrlib/add.py
added
removed
bzrlib/tests/__init__.py
884
884
excName = str(excClass)
885
885
raise self.failureException, "%s not raised" % excName
886
886
887
def assertRaises(self, excClass, func, *args, **kwargs):
887
def assertRaises(self, excClass, callableObj, *args, **kwargs):
888
888
"""Assert that a callable raises a particular exception.
889
889
890
890
:param excClass: As for the except statement, this may be either an
891
exception class, or a tuple of classes.
891
exception class, or a tuple of classes.
892
:param callableObj: A callable, will be passed ``*args`` and
893
``**kwargs``.
892
894
893
895
Returns the exception so that you can examine it.
894
896
"""
895
897
try:
896
func(*args, **kwargs)
898
callableObj(*args, **kwargs)
897
899
except excClass, e:
898
900
return e
899
901
else:
978
980
:param args: The positional arguments for the callable
979
981
:param kwargs: The keyword arguments for the callable
980
982
:return: A tuple (warnings, result). result is the result of calling
981
a_callable(*args, **kwargs).
983
a_callable(``*args``, ``**kwargs``).
982
984
"""
983
985
local_warnings = []
984
986
def capture_warnings(msg, cls=None, stacklevel=None):
1001
1003
not other callers that go direct to the warning module.
1002
1004
1003
1005
:param deprecation_format: The deprecation format that the callable
1004
should have been deprecated with. This is the same type as the
1005
parameter to deprecated_method/deprecated_function. If the
1006
should have been deprecated with. This is the same type as the
1007
parameter to deprecated_method/deprecated_function. If the
1006
1008
callable is not deprecated with this format, an assertion error
1007
1009
will be raised.
1008
1010
:param a_callable: A callable to call. This may be a bound method or
1009
a regular function. It will be called with *args and **kwargs.
1011
a regular function. It will be called with ``*args`` and
1012
``**kwargs``.
1010
1013
:param args: The positional arguments for the callable
1011
1014
:param kwargs: The keyword arguments for the callable
1012
:return: The result of a_callable(*args, **kwargs)
1015
:return: The result of a_callable(``*args``, ``**kwargs``)
1013
1016
"""
1014
1017
call_warnings, result = self._capture_warnings(a_callable,
1015
1018
*args, **kwargs)
1327
1330
overall behavior of the bzr application (rather than a unit test
1328
1331
or a functional test of the library.)
1329
1332
1330
:param stdin: A string to be used as stdin for the command.
1331
:param retcode: The status code the command should return;
1333
This sends the stdout/stderr results into the test's log,
1334
where it may be useful for debugging. See also run_captured.
1335
1336
:keyword stdin: A string to be used as stdin for the command.
1337
:keyword retcode: The status code the command should return;
1332
1338
default 0.
1333
:param working_dir: The directory to run the command in
1334
:param error_regexes: A list of expected error messages. If
1335
specified they must be seen in the error output of the command.
1339
:keyword working_dir: The directory to run the command in
1340
:keyword error_regexes: A list of expected error messages. If
1341
specified they must be seen in the error output of the command.
1336
1342
"""
1337
1343
retcode = kwargs.pop('retcode', 0)
1338
1344
encoding = kwargs.pop('encoding', None)
1368
1374
1369
1375
def run_bzr_error(self, error_regexes, *args, **kwargs):
1370
1376
"""Run bzr, and check that stderr contains the supplied regexes
1371
1372
:param error_regexes: Sequence of regular expressions which
1377
1378
:param error_regexes: Sequence of regular expressions which
1373
1379
must each be found in the error output. The relative ordering
1374
1380
is not enforced.
1375
1381
:param args: command-line arguments for bzr
1376
1382
:param kwargs: Keyword arguments which are interpreted by run_bzr
1377
1383
This function changes the default value of retcode to be 3,
1378
1384
since in most cases this is run when you expect bzr to fail.
1379
:return: (out, err) The actual output of running the command (in case you
1380
want to do more inspection)
1381
1382
Examples of use:
1385
:return: (out, err) The actual output of running the command (in case
1386
you want to do more inspection)
1387
1388
Examples of use::
1389
1383
1390
# Make sure that commit is failing because there is nothing to do
1384
1391
self.run_bzr_error(['no changes to commit'],
1385
1392
'commit', '-m', 'my commit comment')
1402
1409
handling, or early startup code, etc. Subprocess code can't be
1403
1410
profiled or debugged so easily.
1404
1411
1405
:param retcode: The status code that is expected. Defaults to 0. If
1412
:keyword retcode: The status code that is expected. Defaults to 0. If
1406
1413
None is supplied, the status code is not checked.
1407
:param env_changes: A dictionary which lists changes to environment
1414
:keyword env_changes: A dictionary which lists changes to environment
1408
1415
variables. A value of None will unset the env variable.
1409
1416
The values must be strings. The change will only occur in the
1410
1417
child, so you don't need to fix the environment after running.
1411
:param universal_newlines: Convert CRLF => LF
1412
:param allow_plugins: By default the subprocess is run with
1418
:keyword universal_newlines: Convert CRLF => LF
1419
:keyword allow_plugins: By default the subprocess is run with
1413
1420
--no-plugins to ensure test reproducibility. Also, it is possible
1414
1421
for system-wide plugins to create unexpected output on stderr,
1415
1422
which can cause unnecessary test failures.
1439
1446
profiled or debugged so easily.
1440
1447
1441
1448
:param process_args: a list of arguments to pass to the bzr executable,
1442
for example `['--version']`.
1449
for example ``['--version']``.
1443
1450
:param env_changes: A dictionary which lists changes to environment
1444
1451
variables. A value of None will unset the env variable.
1445
1452
The values must be strings. The change will only occur in the
1765
1772
capabilities of the local filesystem, but it might actually be a
1766
1773
MemoryTransport or some other similar virtual filesystem.
1767
1774
1768
This is the backing transport (if any) of the server returned by
1775
This is the backing transport (if any) of the server returned by
1769
1776
get_url and get_readonly_url.
1770
1777
1771
1778
:param relpath: provides for clients to get a path relative to the base
1772
1779
url. These should only be downwards relative, not upwards.
1780
:return: A URL
1773
1781
"""
1774
1782
base = self.get_vfs_only_server().get_url()
1775
1783
return self._adjust_url(base, relpath)
1923
1931
This assumes that all the elements in the tree being built are new.
1924
1932
1925
1933
This doesn't add anything to a branch.
1934
1926
1935
:param line_endings: Either 'binary' or 'native'
1927
in binary mode, exact contents are written
1928
in native mode, the line endings match the
1929
default platform endings.
1930
1931
:param transport: A transport to write to, for building trees on
1932
VFS's. If the transport is readonly or None,
1933
"." is opened automatically.
1936
in binary mode, exact contents are written in native mode, the
1937
line endings match the default platform endings.
1938
:param transport: A transport to write to, for building trees on VFS's.
1939
If the transport is readonly or None, "." is opened automatically.
1940
:return: None
1934
1941
"""
1935
1942
# It's OK to just create them using forward slashes on windows.
1936
1943
if transport is None or transport.is_readonly():
Loggerhead is a web-based interface for Breezy
Version: 2.0.1