feat(cheatcodes): implement new cheatcode to check if a string contains another string

crates/cheatcodes/spec/src/vm.rs

@@ -1522,6 +1522,10 @@ interface Vm {
         string calldata error
     ) external pure;
 
+    /// Returns true if the left string contains the right string, otherwise returns false.
+    #[cheatcode(group = Testing, safety = Safe)]
+    function assertContains(string calldata left, string calldata right) external returns (bool result);
+
     // ======== OS and Filesystem ========
 
     // -------- Metadata --------

crates/cheatcodes/src/test/assert.rs

@@ -1,5 +1,6 @@
-use crate::{CheatcodesExecutor, CheatsCtxt, Result, Vm::*};
+use crate::{Cheatcode, Cheatcodes, CheatcodesExecutor, CheatsCtxt, Result, Vm::*};
 use alloy_primitives::{hex, I256, U256};
+use alloy_sol_types::SolValue;
 use foundry_evm_core::{
     abi::{format_units_int, format_units_uint},
     backend::GLOBAL_FAIL_SLOT,
@@ -447,6 +448,13 @@ impl_assertions! {
     (assertApproxEqRelDecimal_2Call, assertApproxEqRelDecimal_3Call),
 }
 
+impl Cheatcode for assertContainsCall {
+    fn apply(&self, _state: &mut Cheatcodes) -> Result {
+        let Self { left, right } = self;
+        Ok(left.contains(right).abi_encode())
+    }
+}
+
 fn assert_true(condition: bool) -> Result<Vec<u8>, SimpleAssertionError> {
     if condition {
         Ok(Default::default())

testdata/default/cheats/Assert.t.sol

@@ -822,4 +822,12 @@ contract AssertionsTest is DSTest {
 
         vm.assertApproxEqRel(uint256(0), uint256(0), uint256(0));
     }
+
+    function testAssertContains() public {
+        string memory str1 = "this is a test";
+        string memory str2 = "test";
+        string memory str3 = "foundry";
+        assert(vm.assertContains(str1, str2));
+        assert(!vm.assertContains(str1, str3));
+    }
 }