docs updated

Author: davert

src/Codeception/Module/SOAP.php

@@ -283,6 +283,46 @@ public function seeSoapResponseContainsStructure($xml) {
 
     }
 
+    /**
+     * Checks XML response with XPath locator
+     *
+     * ``` php
+     * <?php
+     * $I->seeSoapResponseContainsXPath('//root/user[@id=1]');
+     * ?>
+     * ```
+     *
+     * @param $xpath
+     */
+    public function seeSoapResponseContainsXPath($xpath)
+    {
+        $path = new \DOMXPath($this->xmlResponse);
+        $res = $path->query($xpath);
+        if ($res === false) $this->fail("XPath selector is malformed");
+        $this->assertGreaterThen(0, $res->length);
+    }
+
+    /**
+     * Checks XML response doesn't contain XPath locator
+     *
+     * ``` php
+     * <?php
+     * $I->dontSeeSoapResponseContainsXPath('//root/user[@id=1]');
+     * ?>
+     * ```
+     *
+     * @param $xpath
+     */
+    public function dontSeeSoapResponseContainsXPath($xpath)
+    {
+        $path = new \DOMXPath($this->xmlResponse);
+        $res = $path->query($xpath);
+        if ($res === false) $this->fail("XPath selector is malformed");
+        $this->assertEquals(0, $res->length);
+    }
+
+
+
     /**
      * Checks response code from server.
      *

tests/unit/Codeception/Module/SoapTest.php

@@ -77,7 +77,24 @@ public function testSeeXmlIncludes() {
         $dom->loadXML('<?xml version="1.0" encoding="UTF-8"?>    <doc> <a a2="2" a1="1" >123</a>  </doc>');
         $this->module->seeSoapResponseIncludes('<a    a2="2"      a1="1" >123</a>');
     }
-    
+
+    public function testSeeXmlContainsXPath() {
+        $dom = new DOMDocument();
+        $this->module->xmlResponse = $dom;
+        $dom->preserveWhiteSpace = false;
+        $dom->loadXML('<?xml version="1.0" encoding="UTF-8"?>    <doc> <a a2="2" a1="1" >123</a>  </doc>');
+        $this->module->seeSoapResponseContainsXPath('//doc/a[@a2=2 and @a1=1]');
+    }
+
+    public function testSeeXmlNotContainsXPath() {
+        $dom = new DOMDocument();
+        $this->module->xmlResponse = $dom;
+        $dom->preserveWhiteSpace = false;
+        $dom->loadXML('<?xml version="1.0" encoding="UTF-8"?>    <doc> <a a2="2" a1="1" >123</a>  </doc>');
+        $this->module->dontSeeSoapResponseContainsXPath('//doc/a[@a2=2 and @a31]');
+    }
+
+
     public function testSeeXmlEquals() {
         $dom = new DOMDocument();
         $this->module->xmlResponse = $dom;
@@ -106,8 +123,6 @@ public function testGrabTextFrom() {
         $this->assertEquals('123', $res);
         $res = $this->module->grabTextContentFrom('descendant-or-self::doc/descendant::node');
         $this->assertEquals('123', $res);
-
-
     }
 
 }