Add a googletest::prelude that can easily be included at the beginning of tests.

PiperOrigin-RevId: 529702708

Author: bjacotg

README.md

@@ -50,7 +50,7 @@ Fatal assertions are analogous to the `ASSERT_*` family of macros in GoogleTest.
 For example, for fatal assertions:
 
 ```rust
-use googletest::{matchers::eq, verify_that, Result};
+use googletest::prelude::*;
 
 #[test]
 fn more_than_one_failure() -> Result<()> {
@@ -73,7 +73,7 @@ This library includes a rich set of matchers, covering:
 Matchers are composable:
 
 ```rust
-use googletest::{matchers::{contains, ge}, verify_that, Result};
+use googletest::prelude::*;
 
 #[test]
 fn contains_at_least_one_item_at_least_3() -> Result<()> {
@@ -85,7 +85,7 @@ fn contains_at_least_one_item_at_least_3() -> Result<()> {
 They can also be logically combined:
 
 ```rust
-use googletest::{matchers::{gt, lt, not, AndMatcherExt}, verify_that, Result};
+use googletest::prelude::*;
 
 #[test]
 fn strictly_between_9_and_11() -> Result<()> {
@@ -100,12 +100,7 @@ One can use the macro [`matches_pattern!`] to create a composite matcher for a
 struct or enum that matches fields with other matchers:
 
 ```rust
-use googletest::{
-    matchers::{contains_substring, eq, gt},
-    matches_pattern,
-    verify_that,
-    Result,
-};
+use googletest::prelude::*;
 
 struct AStruct {
     a_field: i32,
@@ -188,7 +183,7 @@ also be marked with [`googletest::test`] instead of the Rust-standard `#[test]`.
 It must return [`Result<()>`].
 
 ```rust
-use googletest::{expect_that, matchers::eq, Result};
+use googletest::prelude::*;
 
 #[googletest::test]
 fn more_than_one_failure() -> Result<()> {

googletest/integration_tests/assertion_failure_in_subroutine.rs

@@ -16,11 +16,9 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::matchers;
-    use googletest::{google_test, verify_that, Result};
-    use matchers::eq;
+    use googletest::prelude::*;
 
-    #[google_test]
+    #[test]
     fn should_fail_in_subroutine() -> Result<()> {
         assert_that_things_are_okay(2)
     }

googletest/integration_tests/async_test_with_expect_that.rs

@@ -17,9 +17,7 @@ fn main() {}
 #[deny(warnings)]
 #[cfg(test)]
 mod tests {
-    use googletest::matchers;
-    use googletest::{expect_that, verify_that, Result};
-    use matchers::eq;
+    use googletest::prelude::*;
     use std::time::Duration;
     use tokio::time::sleep;
 

googletest/integration_tests/custom_error_message.rs

@@ -16,9 +16,7 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::matchers;
-    use googletest::{verify_that, GoogleTestSupport, Result};
-    use matchers::eq;
+    use googletest::prelude::*;
 
     #[test]
     fn should_fail_with_custom_error_message() -> Result<()> {

googletest/integration_tests/expect_pred_failure.rs

@@ -16,9 +16,9 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::{expect_pred, google_test, Result};
+    use googletest::prelude::*;
 
-    #[google_test]
+    #[googletest::test]
     fn verify_predicate_with_failure() -> Result<()> {
         let a = 1;
         let b = 2;

googletest/integration_tests/expect_that_failure.rs

@@ -16,11 +16,9 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::matchers;
-    use googletest::{expect_that, google_test, Result};
-    use matchers::eq;
+    use googletest::prelude::*;
 
-    #[google_test]
+    #[googletest::test]
     fn should_fail_but_not_abort() -> Result<()> {
         let value = 2;
         expect_that!(value, eq(3));

googletest/integration_tests/failure_due_to_fail_macro.rs

@@ -16,7 +16,7 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::{fail, Result};
+    use googletest::prelude::*;
 
     #[test]
     fn just_fails() -> Result<()> {

googletest/integration_tests/failure_due_to_fail_macro_with_empty_message.rs

@@ -16,9 +16,9 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::{fail, google_test, GoogleTestSupport, Result};
+    use googletest::prelude::*;
 
-    #[google_test]
+    #[googletest::test]
     fn just_fails() -> Result<()> {
         fail!().and_log_failure();
         Ok(())

googletest/integration_tests/failure_due_to_fail_macro_with_format_arguments.rs

@@ -16,9 +16,9 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::{fail, google_test, GoogleTestSupport, Result};
+    use googletest::prelude::*;
 
-    #[google_test]
+    #[googletest::test]
     fn just_fails() -> Result<()> {
         let argument = "An argument";
         fail!("Failure message with argument: {argument}").and_log_failure();

googletest/integration_tests/first_failure_aborts.rs

@@ -16,11 +16,9 @@ fn main() {}
 
 #[cfg(test)]
 mod tests {
-    use googletest::matchers;
-    use googletest::{google_test, verify_that, GoogleTestSupport, Result};
-    use matchers::eq;
+    use googletest::prelude::*;
 
-    #[google_test]
+    #[test]
     fn first_failure_aborts() -> Result<()> {
         let value = 2;
         verify_that!(value, eq(3))?;