Crate run_make_support

run-make-support is a support library for run-make tests. It provides command wrappers and convenience utility functions to help test writers reduce duplication. The support library notably is built via cargo: this means that if your test wants some non-trivial utility, such as object or wasmparser, they can be re-exported and be made available through this library.

Re-exports

• pub use cc::cc;
• pub use cc::extra_c_flags;
• pub use cc::extra_cxx_flags;
• pub use cc::Cc;
• pub use clang::clang;
• pub use clang::Clang;
• pub use diff::diff;
• pub use diff::Diff;
• pub use llvm::llvm_filecheck;
• pub use llvm::llvm_objdump;
• pub use llvm::llvm_profdata;
• pub use llvm::llvm_readobj;
• pub use llvm::LlvmFilecheck;
• pub use llvm::LlvmObjdump;
• pub use llvm::LlvmProfdata;
• pub use llvm::LlvmReadobj;
• pub use run::cmd;
• pub use run::run;
• pub use run::run_fail;
• pub use run::run_with_args;
• pub use rustc::aux_build;
• pub use rustc::bare_rustc;
• pub use rustc::rustc;
• pub use rustc::Rustc;
• pub use rustdoc::bare_rustdoc;
• pub use rustdoc::rustdoc;
• pub use rustdoc::Rustdoc;
• pub use bstr;
• pub use gimli;
• pub use object;
• pub use regex;
• pub use wasmparser;

Modules

• cc
• clang
• command 🔒
• diff
• drop_bomb 🔒
  This module implements “drop bombs” intended for use by command wrappers to ensure that the constructed commands are eventually executed. This is exactly like rustc_errors::Diag where we force every Diag to be consumed or we emit a bug, but we panic instead.
• fs_wrapper
• llvm
• run
• rustc
• rustdoc

Macros

• impl_common_helpers 🔒
  Implement common helpers for command wrappers. This assumes that the command wrapper is a struct containing a cmd: Command field. The provided helpers are:

Functions

• ar
  AR
• assert_contains
  Check that haystack contains needle. Panic otherwise.
• assert_equals
  Check that actual is equal to expected. Panic otherwise.
• assert_not_contains
  Check that haystack does not contain needle. Panic otherwise.
• bin_name
  Construct the binary name based on platform.
• copy_dir_all
  Copy a directory into another.
• count_regex_matches_in_files_with_extension
  Gathers all files in the current working directory that have the extension ext, and counts the number of lines within that contain a match with the regex pattern re.
• create_symlink
  Creates a new symlink to a path on the filesystem, adjusting for Windows or Unix.
• cwd
  Return the current working directory.
• cygpath_windows
  Use cygpath -w on a path to get a Windows path string back. This assumes that cygpath is available on the platform!
• dynamic_lib_extension
• dynamic_lib_name
  Construct the dynamic library name based on the platform.
• env_var
• env_var_os
• filename_not_in_denylist
  Returns true if the filename at path is not in expected.
• handle_failed_output 🔒
• has_extension
  Returns true if the filename at path has the extension extension.
• has_prefix
  Returns true if the filename at path starts with prefix.
• htmldocck
• invalid_utf8_contains
  Read the contents of a file that cannot simply be read by read_to_string, due to invalid utf8 data, then assert that it contains expected.
• invalid_utf8_not_contains
  Read the contents of a file that cannot simply be read by read_to_string, due to invalid utf8 data, then assert that it does not contain expected.
• is_darwin
  Check if target uses macOS.
• is_msvc
  Check if target uses msvc.
• is_windows
  Check if target is windows-like.
• not_contains
  Returns true if the filename at path does not contain expected.
• path
  Returns the path for a local test file.
• python_command
• read_dir
• recursive_diff
  Check that all files in dir1 exist and have the same content in dir2. Panic otherwise.
• run_in_tmpdir
  This function is designed for running commands in a temporary directory that is cleared after the function ends.
• rust_lib_name
  Generate the name a rust library (rlib) would have.
• set_host_rpath
  Set the runtime library path as needed for running the host rustc/rustdoc/etc.
• shallow_find_files
  Browse the directory path non-recursively and return all files which respect the parameters outlined by closure.
• source_root
  Path to the root rust-lang/rust source checkout.
• static_lib_name
  Construct the static library name based on the platform.
• target
  TARGET
• test_while_readonly
  Ensure that the path P is read-only while the test runs, and restore original permissions at the end so compiletest can clean up. This will panic on Windows if the path is a directory (as it would otherwise do nothing)
• uname
  Run uname. This assumes that uname is available on the platform!