9337ad5bae
trace_macro: Show both the macro call and its expansion. #42072. See #42072 for the initial motivation behind this. The change is not the minimal fix, but I want this behavior almost every time I use `trace_macros`. |
||
---|---|---|
.. | ||
borrowck | ||
check_match | ||
codemap_tests | ||
compare-method | ||
cross-crate-macro-backtrace | ||
did_you_mean | ||
dropck | ||
fmt | ||
hello_world | ||
impl-trait | ||
invalid-module-declaration | ||
issue-37311-type-length-limit | ||
issue-40402-ref-hints | ||
issue-41652 | ||
lifetime-errors | ||
lifetimes | ||
lint | ||
macros | ||
mismatched_types | ||
missing-items | ||
print_type_sizes | ||
print-fuel | ||
pub | ||
reachable | ||
resolve | ||
span | ||
suggestions | ||
token | ||
type-check | ||
coercion-missing-tail-expected-type.rs | ||
coercion-missing-tail-expected-type.stderr | ||
fn_once-moved.rs | ||
fn_once-moved.stderr | ||
loop-break-value-no-repeat.rs | ||
loop-break-value-no-repeat.stderr | ||
README.md | ||
regions-fn-subtyping-return-static.rs | ||
regions-fn-subtyping-return-static.stderr | ||
static-lifetime.rs | ||
static-lifetime.stderr | ||
update-all-references.sh | ||
update-references.sh |
Guide to the UI Tests
The UI tests are intended to capture the compiler's complete output,
so that we can test all aspects of the presentation. They work by
compiling a file (e.g., hello_world/main.rs
), capturing the output,
and then applying some normalization (see below). This normalized
result is then compared against reference files named
hello_world/main.stderr
and hello_world/main.stdout
. If either of
those files doesn't exist, the output must be empty. If the test run
fails, we will print out the current output, but it is also saved in
build/<target-triple>/test/ui/hello_world/main.stdout
(this path is
printed as part of the test failure mesage), so you can run diff
and
so forth.
Editing and updating the reference files
If you have changed the compiler's output intentionally, or you are
making a new test, you can use the script update-references.sh
to
update the references. When you run the test framework, it will report
various errors: in those errors is a command you can use to run the
update-references.sh
script, which will then copy over the files
from the build directory and use them as the new reference. You can
also just run update-all-references.sh
. In both cases, you can run
the script with --help
to get a help message.
Normalization
The normalization applied is aimed at filenames:
- the test directory is replaced with
$DIR
- all backslashes () are converted to forward slashes (/) (for windows)