feat: string to json (#238)

* feat: string to json

Solves #237

* docs: update strings references

docs/src/references/Strings.md

@@ -56,3 +56,7 @@ Parses a bytes32 string.
 
 Parses a boolean string.
 
+### **parseJson(string value) → (JsonResult)**
+
+Parses a JSON string.
+

src/_internal/Strings.sol

@@ -1,7 +1,8 @@
 // SPDX-License-Identifier: MIT
 pragma solidity >=0.8.13 <0.9.0;
 
-import "./Vulcan.sol";
+import {vulcan} from "./Vulcan.sol";
+import {json, JsonResult} from "./Json.sol";
 import {fmt} from "./Fmt.sol";
 
 library strings {
@@ -92,4 +93,10 @@ library strings {
     function parseBool(string memory value) internal pure returns (bool) {
         return vulcan.hevm.parseBool(value);
     }
+
+    /// @dev Parses a JSON string.
+    /// @param value The string to parse
+    function parseJson(string memory value) internal returns (JsonResult) {
+        return json.create(value);
+    }
 }

test/modules/Strings.t.sol

@@ -79,4 +79,10 @@ contract StringsTest is Test {
 
         expect(value.parseBool()).toBeFalse();
     }
+
+    function testItCanParseJson() external {
+        string memory value = '{"foo": "bar"}';
+
+        expect(value.parseJson().expect("Invalid JSON").getString(".foo")).toEqual("bar");
+    }
 }