Rename googletest::test to googletest::gtest, and make test an alias for gtest

As we were adopting Googletest Rust within Google, we received feedback that
`#[googletest::test]` is too long, inconvenient to type, that it repeats the
word "test" twice, or that it is too much detail for a user to care about.

Thus, we decided to rename `#[googletest::test]` to `#[gtest]`, also adding it
to the prelude. This is consistent with existing practice in other Rust crates
that enhance the testing experience, for example, `#[rstest]`.

This commit starts a multi-commit chain.

We are not deprecating `#[googletest::test]`, because this spelling is useful
for compatibility with the rstest crate.

PiperOrigin-RevId: 660991306

Author: gribozavr

googletest/src/lib.rs

@@ -58,6 +58,7 @@ pub mod prelude {
     };
 }
 
+pub use googletest_macro::gtest;
 pub use googletest_macro::test;
 
 use internal::test_outcome::{TestAssertionFailure, TestOutcome};

googletest_macro/src/lib.rs

@@ -68,7 +68,7 @@ use syn::{parse_macro_input, Attribute, DeriveInput, ItemFn, ReturnType};
 ///
 /// [`googletest::Result`]: type.Result.html
 #[proc_macro_attribute]
-pub fn test(
+pub fn gtest(
     _args: proc_macro::TokenStream,
     input: proc_macro::TokenStream,
 ) -> proc_macro::TokenStream {
@@ -149,6 +149,31 @@ pub fn test(
     output.into()
 }
 
+/// Alias for [`googletest::gtest`].
+///
+/// Generally, prefer using `#[gtest]` to mark googletest-based tests.
+///
+/// Use `#[googletest::test]` instead of `#[gtest]` to satisfy compatibility
+/// requirements. For example, the rstest crate can be composed with other test
+/// attributes but it requires the attribute to be named `test`.
+///
+/// ```ignore
+/// #[rstest]
+/// #[googletest::test]
+/// fn rstest_with_googletest() -> Result<()> {
+///   verify_that!(1, eq(1))
+/// }
+/// ```
+///
+/// [`googletest::gtest`]: attr.gtest.html
+#[proc_macro_attribute]
+pub fn test(
+    args: proc_macro::TokenStream,
+    input: proc_macro::TokenStream,
+) -> proc_macro::TokenStream {
+    gtest(args, input)
+}
+
 fn is_test_attribute(attr: &Attribute) -> bool {
     let first_segment = match attr.path().segments.first() {
         Some(first_segment) => first_segment,