native string utils cheatcodes

crates/cheatcodes/spec/src/vm.rs

@@ -1077,6 +1077,22 @@ interface Vm {
     #[cheatcode(group = String)]
     function parseBool(string calldata stringifiedValue) external pure returns (bool parsedValue);
 
+    /// Converts the given `string` value to Lowercase.
+    #[cheatcode(group = String)]
+    function toLowercase(string calldata stringifiedValue) external pure returns (string memory stringifiedValue);
+    /// Converts the given `string` value to Uppercase.
+    #[cheatcode(group = String)]
+    function toUppercase(string calldata stringifiedValue) external pure returns (string memory stringifiedValue);
+    /// Trims leading and trailing whitespace from the given `string` value.
+    #[cheatcode(group = String)]
+    function trim(string calldata stringifiedValue) external pure returns (string memory stringifiedValue);
+    /// Replaces occurrences of `from` in the given `string` with `to`.
+    #[cheatcode(group = String)]
+    function replace(string calldata stringifiedValue, string calldata from, string calldata to) external pure returns (string memory stringifiedValue);
+    /// Splits the given `string` into an array of strings divided by the `delimiter`.
+    #[cheatcode(group = String)]
+    function split(string calldata stringifiedValue, string calldata delimiter) external pure returns (string[] memory stringifiedValues);
+
     // ======== JSON Parsing and Manipulation ========
 
     // -------- Reading --------

crates/cheatcodes/src/string.rs

@@ -94,6 +94,47 @@ impl Cheatcode for parseBoolCall {
     }
 }
 
+// toLowercase
+impl Cheatcode for toLowercaseCall {
+    fn apply(&self, _state: &mut Cheatcodes) -> Result {
+        let Self { stringifiedValue } = self;
+        Ok(stringifiedValue.to_lowercase().abi_encode())
+    }
+}
+
+// toUppercase
+impl Cheatcode for toUppercaseCall {
+    fn apply(&self, _state: &mut Cheatcodes) -> Result {
+        let Self { stringifiedValue } = self;
+        Ok(stringifiedValue.to_uppercase().abi_encode())
+    }
+}
+
+// trim
+impl Cheatcode for trimCall {
+    fn apply(&self, _state: &mut Cheatcodes) -> Result {
+        let Self { stringifiedValue } = self;
+        Ok(stringifiedValue.trim().abi_encode())
+    }
+}
+
+// Replace
+impl Cheatcode for replaceCall {
+    fn apply(&self, _state: &mut Cheatcodes) -> Result {
+        let Self { stringifiedValue, from, to } = self;
+        Ok(stringifiedValue.replace(from, to).abi_encode())
+    }
+}
+
+// Split
+impl Cheatcode for splitCall {
+    fn apply(&self, _state: &mut Cheatcodes) -> Result {
+        let Self { stringifiedValue, delimiter } = self;
+        let parts: Vec<&str> = stringifiedValue.split(delimiter).collect();
+        Ok(parts.abi_encode())
+    }
+}
+
 pub(super) fn parse(s: &str, ty: &DynSolType) -> Result {
     parse_value(s, ty).map(|v| v.abi_encode())
 }