xref: /aosp_15_r20/external/bazel-skylib/docs/diff_test_doc.md (revision bcb5dc7965af6ee42bf2f21341a2ec00233a8c8a)
1<!-- Generated with Stardoc: http://skydoc.bazel.build -->
2
3A test rule that compares two binary files.
4
5The rule uses a Bash command (diff) on Linux/macOS/non-Windows, and a cmd.exe
6command (fc.exe) on Windows (no Bash is required).
7
8<a id="diff_test"></a>
9
10## diff_test
11
12<pre>
13diff_test(<a href="#diff_test-name">name</a>, <a href="#diff_test-file1">file1</a>, <a href="#diff_test-file2">file2</a>, <a href="#diff_test-failure_message">failure_message</a>, <a href="#diff_test-kwargs">kwargs</a>)
14</pre>
15
16A test that compares two files.
17
18The test succeeds if the files' contents match.
19
20
21**PARAMETERS**
22
23
24| Name  | Description | Default Value |
25| :------------- | :------------- | :------------- |
26| <a id="diff_test-name"></a>name |  The name of the test rule.   |  none |
27| <a id="diff_test-file1"></a>file1 |  Label of the file to compare to `file2`.   |  none |
28| <a id="diff_test-file2"></a>file2 |  Label of the file to compare to `file1`.   |  none |
29| <a id="diff_test-failure_message"></a>failure_message |  Additional message to log if the files' contents do not match.   |  `None` |
30| <a id="diff_test-kwargs"></a>kwargs |  The [common attributes for tests](https://bazel.build/reference/be/common-definitions#common-attributes-tests).   |  none |
31
32
33