rbtools.testing.testcase¶

Base test cases for RBTools unit tests.

Classes

class rbtools.testing.testcase.TestCase(methodName='runTest')[source]¶

Bases: TestCase

The base class for RBTools test cases.

This provides helpful utility functions, environment management, and better docstrings to help craft unit tests for RBTools functionality. All RBTools unit tests should use this this class or a subclass of it as the base class.

ws_re = re.compile('\\s+')[source]¶

default_text_editor = '/Users/chipx86/buildroots/rbtools-5.0/bin/python3.10 /private/var/folders/34/6wkbp94x5g79sbk8kfrscpzw0000gn/T/beanbag-tools.wdcv04tv/rbtools/testing/scripts/editor.py'[source]¶

maxDiff = 10000[source]¶

TEST_SERVER_URL = 'https://reviews.example.com/'[source]¶

A sample test URL for a Review Board server.

New in version 3.1.

needs_temp_home: bool = False¶

Whether individual unit tests need a new temporary HOME directory.

If set, a directory will be created at test startup, and will be set as the home directory.

New in version 3.0.

classmethod setUpClass()[source]¶

Hook method for setting up class fixture before running tests in the class.

classmethod tearDownClass()[source]¶

Hook method for deconstructing the class fixture after running all tests in the class.

setUp()[source]¶

Hook method for setting up the test fixture before exercising it.

tearDown()[source]¶

Hook method for deconstructing the test fixture after testing it.

shortDescription()[source]¶

Returns the description of the current test.

This changes the default behavior to replace all newlines with spaces, allowing a test description to span lines. It should still be kept short, though.

Returns:

The descriptive text for the current unit test.

Return type:

unicode

get_user_home()[source]¶

Return the user’s current home directory.

New in version 3.0.

Returns:

The current home directory.

Return type:

unicode

set_user_home(path)[source]¶

Set the user’s current home directory.

This will be unset when the unit test has finished.

New in version 3.0.

Parameters:

path (unicode) – The new home directory.

chdir_tmp()[source]¶

Create a temporary directory and set it as the working directory.

The directory will be deleted after the test has finished.

New in version 3.0.

Returns:

The path to the temp directory.

Return type:

unicode

precreate_tempfiles(count)[source]¶

Pre-create a specific number of temporary files.

This will call make_tempfile() the specified number of times, returning the list of generated temp file paths, and will then spy that function to return those temp files.

Once each pre-created temp file is used up, any further calls to make_tempfile() will result in an error, failing the test.

This is useful in unit tests that need to script a series of expected calls using kgb (such as through kgb.ops.SpyOpMatchInOrder) that need to know the names of temporary filenames up-front.

Unit test suites that use this must mix in kgb.SpyAgency.

New in version 3.0.

Parameters:

count (int) – The number of temporary filenames to pre-create.

Raises:

AssertionError – The test suite class did not mix in kgb.SpyAgency.

precreate_tempdirs(count)[source]¶

Pre-create a specific number of temporary directories.

This will call make_tempdir() the specified number of times, returning the list of generated temp paths, and will then spy that function to return those temp paths.

Once each pre-created temp path is used up, any further calls to make_tempdir() will result in an error, failing the test.

This is useful in unit tests that need to script a series of expected calls using kgb (such as through kgb.ops.SpyOpMatchInOrder) that need to know the names of temporary filenames up-front.

Unit test suites that use this must mix in kgb.SpyAgency.

New in version 3.0.

Parameters:

count (int) – The number of temporary directories to pre-create.

Raises:

AssertionError – The test suite class did not mix in kgb.SpyAgency.

assertDiffEqual(diff, expected_diff)[source]¶

Assert that two diffs are equal.

Parameters:

• diff (bytes) – The generated diff.

• expected_diff (bytes) – The expected diff.

Raises:

AssertionError – The diffs aren’t equal or of the right type.

assertRaisesMessage(expected_exception, expected_message)[source]¶

Assert that a call raises an exception with the given message.

Parameters:

• expected_exception (type) – The type of exception that’s expected to be raised.

• expected_message (unicode) – The expected exception message.

Raises:

AssertionError – The assertion failure, if the exception and message isn’t raised.

create_rbclient()[source]¶

Return a RBClient for testing.

This will set up a URLMapTransport. It’s recommended that the caller access it via get_rbclient_transport().

New in version 3.1.

Parameters:

transport (rbtools.api.transport.Transport, optional) – An explicit transport instance to use

Returns:

The client for testing purposes.

Return type:

rbtools.api.client.RBClient

get_rbclient_transport(client)[source]¶

Return the transport associated with a RBClient.

This allows tests to avoid reaching into RBClient internals in order to get the transport.

New in version 3.1.

Parameters:

client (rbtools.api.client.RBClient) – The client instance.

Returns:

The client’s transport.

Return type:

rbtools.api.transport.Transport

write_reviewboardrc(config: Union[str, Dict[str, object]] = {}, *, parent_dir: Optional[str] = None, filename: str = '.reviewboardrc') → str[source]¶

Write a .reviewboardrc file to a directory.

This allows for control over where the file is written, what it’s named, and the serialization of the contents of the file.

New in version 5.0.

Parameters:

• config (dict or str) – A dictionary of settings to write, or a string payload for the entire file.

• parent_dir (str, optional) –

  The directory where the configuration file should go.

  This will default to the current directory.

• filename (str, optional) –

  The name of the configuration file.

  This defaults to .reviewboardrc.

Returns:

The resulting path to the configuration file.

Return type:

str

reviewboardrc(config, use_temp_dir=False)[source]¶

Populate a temporary .reviewboardrc file.

This will create a .reviewboardrc file, either in the current directory or in a new temporary directory (if use_temp_dir is set). The file will contain the provided configuration.

New in version 3.0.

Parameters:

• config (dict) –

  A dictionary of key-value pairs to write into the .reviewboardrc file.

  A best effort attempt will be made to write each configuration to the file.

• use_temp_dir (bool, optional) – Whether a temporary directory should be created and set as the current directory. If set, the file will be written there, and the directory will be removed after the context manager finishes.

Context:

The code being run will have a .reviewboardrc in the current directory.