Tests: Make $_path support dots in paths (#28917)

`$_path` is used by documentation tests to ignore a value from a
response, for example:

```
[source,js]
----
{
  "count": 1,
  "datafeeds": [
    {
      "datafeed_id": "datafeed-total-requests",
      "state": "started",
      "node": {
        ...
        "attributes": {
          "ml.machine_memory": "17179869184",
          "ml.max_open_jobs": "20",
          "ml.enabled": "true"
        }
      },
      "assignment_explanation": ""
    }
  ]
}
----
// TESTRESPONSE[s/"17179869184"/$body.$_path/]
```

That example shows `17179869184` in the compiled docs but when it runs
the tests generated by that doc it ignores `17179869184` and asserts
instead that there is a value in that field. This is required because we
can't predict things like "how many milliseconds will this take?" and
"how much memory will this take?".

Before this change it was impossible to use `$_path` when any component
of the path contained a `.`. This fixes the `$_path` evaluator to
properly escape `.`.

Closes #28770

Author: nik9000

test/framework/src/main/java/org/elasticsearch/test/rest/yaml/Stash.java

@@ -184,10 +184,10 @@ private Object getValue(List<Object> path, String key) throws IOException {
         StringBuilder pathBuilder = new StringBuilder();
         Iterator<Object> element = path.iterator();
         if (element.hasNext()) {
-            pathBuilder.append(element.next());
+            pathBuilder.append(element.next().toString().replace(".", "\\."));
             while (element.hasNext()) {
                 pathBuilder.append('.');
-                pathBuilder.append(element.next());
+                pathBuilder.append(element.next().toString().replace(".", "\\."));
             }
         }
         String builtPath = Matcher.quoteReplacement(pathBuilder.toString());

test/framework/src/test/java/org/elasticsearch/test/rest/yaml/StashTests.java

@@ -119,16 +119,22 @@ public void testReplaceStashedValuesStashKeyInList() throws IOException {
 
     public void testPathInList() throws IOException {
         Stash stash = new Stash();
-        stash.stashValue("body", singletonMap("foo", Arrays.asList("a", "b")));
+        String topLevelKey;
+        if (randomBoolean()) {
+            topLevelKey = randomAlphaOfLength(2) + "." + randomAlphaOfLength(2);
+        } else {
+            topLevelKey = randomAlphaOfLength(5);
+        }
+        stash.stashValue("body", singletonMap(topLevelKey, Arrays.asList("a", "b")));
 
         Map<String, Object> expected;
         Map<String, Object> map;
         if (randomBoolean()) {
-            expected = singletonMap("foo", Arrays.asList("test", "boooooh!"));
-            map = singletonMap("foo", Arrays.asList("test", "${body.$_path}oooooh!"));
+            expected = singletonMap(topLevelKey, Arrays.asList("test", "boooooh!"));
+            map = singletonMap(topLevelKey, Arrays.asList("test", "${body.$_path}oooooh!"));
         } else {
-            expected = singletonMap("foo", Arrays.asList("test", "b"));
-            map = singletonMap("foo", Arrays.asList("test", "$body.$_path"));
+            expected = singletonMap(topLevelKey, Arrays.asList("test", "b"));
+            map = singletonMap(topLevelKey, Arrays.asList("test", "$body.$_path"));
         }
 
         Map<String, Object> actual = stash.replaceStashedValues(map);
@@ -138,21 +144,26 @@ public void testPathInList() throws IOException {
 
     public void testPathInMapValue() throws IOException {
         Stash stash = new Stash();
-        stash.stashValue("body", singletonMap("foo", singletonMap("a", "b")));
+        String topLevelKey;
+        if (randomBoolean()) {
+            topLevelKey = randomAlphaOfLength(2) + "." + randomAlphaOfLength(2);
+        } else {
+            topLevelKey = randomAlphaOfLength(5);
+        }
+        stash.stashValue("body", singletonMap(topLevelKey, singletonMap("a", "b")));
 
         Map<String, Object> expected;
         Map<String, Object> map;
         if (randomBoolean()) {
-            expected = singletonMap("foo", singletonMap("a", "boooooh!"));
-            map = singletonMap("foo", singletonMap("a", "${body.$_path}oooooh!"));
+            expected = singletonMap(topLevelKey, singletonMap("a", "boooooh!"));
+            map = singletonMap(topLevelKey, singletonMap("a", "${body.$_path}oooooh!"));
         } else {
-            expected = singletonMap("foo", singletonMap("a", "b"));
-            map = singletonMap("foo", singletonMap("a", "$body.$_path"));
+            expected = singletonMap(topLevelKey, singletonMap("a", "b"));
+            map = singletonMap(topLevelKey, singletonMap("a", "$body.$_path"));
         }
 
         Map<String, Object> actual = stash.replaceStashedValues(map);
         assertEquals(expected, actual);
         assertThat(actual, not(sameInstance(map)));
     }
-
 }