wmde / hamcrest-html-matchers

src/TagMatcher.php

Indentation +3 added lines, -3 removed lines

@@ -6,8 +6,8 @@
 
 abstract class TagMatcher extends TypeSafeDiagnosingMatcher {
 
-	public function __construct() {
-		parent::__construct( self::TYPE_OBJECT, \DOMElement::class );
-	}
+    public function __construct() {
+        parent::__construct( self::TYPE_OBJECT, \DOMElement::class );
+    }
 
 }

src/XmlNodeRecursiveIterator.php

Indentation +20 added lines, -20 removed lines

@@ -4,27 +4,27 @@
 
 class XmlNodeRecursiveIterator extends \ArrayIterator {
 
-	public function __construct( \DOMNodeList $nodeList ) {
-		$queue = $this->addElementsToQueue( [], $nodeList );
-		parent::__construct( $queue );
-	}
+    public function __construct( \DOMNodeList $nodeList ) {
+        $queue = $this->addElementsToQueue( [], $nodeList );
+        parent::__construct( $queue );
+    }
 
-	/**
-	 * @param \DOMNode[] $queue
-	 * @param \DOMNodeList $nodeList
-	 *
-	 * @return \DOMNode[] New queue
-	 */
-	private function addElementsToQueue( array $queue, \DOMNodeList $nodeList ) {
-		/** @var \DOMNode $node */
-		foreach ( $nodeList as $node ) {
-			$queue[] = $node;
-			if ( $node->childNodes !== null ) {
-				$queue = $this->addElementsToQueue( $queue, $node->childNodes );
-			}
-		}
+    /**
+     * @param \DOMNode[] $queue
+     * @param \DOMNodeList $nodeList
+     *
+     * @return \DOMNode[] New queue
+     */
+    private function addElementsToQueue( array $queue, \DOMNodeList $nodeList ) {
+        /** @var \DOMNode $node */
+        foreach ( $nodeList as $node ) {
+            $queue[] = $node;
+            if ( $node->childNodes !== null ) {
+                $queue = $this->addElementsToQueue( $queue, $node->childNodes );
+            }
+        }
 
-		return $queue;
-	}
+        return $queue;
+    }
 
 }

src/functions.php

Indentation +58 added lines, -58 removed lines

@@ -3,87 +3,87 @@
 use Hamcrest\Matcher;
 
 if ( !function_exists( 'htmlPiece' ) ) {
-	/**
-	 * @param Matcher|null $elementMatcher
-	 *
-	 * @return \WMDE\HamcrestHtml\HtmlMatcher
-	 */
-	function htmlPiece( Matcher $elementMatcher = null ) {
-		return \WMDE\HamcrestHtml\HtmlMatcher::htmlPiece( $elementMatcher );
-	}
+    /**
+     * @param Matcher|null $elementMatcher
+     *
+     * @return \WMDE\HamcrestHtml\HtmlMatcher
+     */
+    function htmlPiece( Matcher $elementMatcher = null ) {
+        return \WMDE\HamcrestHtml\HtmlMatcher::htmlPiece( $elementMatcher );
+    }
 }
 
 if ( !function_exists( 'havingRootElement' ) ) {
-	function havingRootElement( Matcher $matcher = null ) {
-		return \WMDE\HamcrestHtml\RootElementMatcher::havingRootElement( $matcher );
-	}
+    function havingRootElement( Matcher $matcher = null ) {
+        return \WMDE\HamcrestHtml\RootElementMatcher::havingRootElement( $matcher );
+    }
 }
 
 if ( !function_exists( 'havingDirectChild' ) ) {
-	function havingDirectChild( Matcher $elementMatcher = null ) {
-		return \WMDE\HamcrestHtml\DirectChildElementMatcher::havingDirectChild( $elementMatcher );
-	}
+    function havingDirectChild( Matcher $elementMatcher = null ) {
+        return \WMDE\HamcrestHtml\DirectChildElementMatcher::havingDirectChild( $elementMatcher );
+    }
 }
 
 if ( !function_exists( 'havingChild' ) ) {
-	function havingChild( Matcher $elementMatcher = null ) {
-		return \WMDE\HamcrestHtml\ChildElementMatcher::havingChild( $elementMatcher );
-	}
+    function havingChild( Matcher $elementMatcher = null ) {
+        return \WMDE\HamcrestHtml\ChildElementMatcher::havingChild( $elementMatcher );
+    }
 }
 
 if ( !function_exists( 'withTagName' ) ) {
-	/**
-	 * @param Matcher|string $tagName
-	 *
-	 * @return \WMDE\HamcrestHtml\TagNameMatcher
-	 */
-	function withTagName( $tagName ) {
-		return \WMDE\HamcrestHtml\TagNameMatcher::withTagName( $tagName );
-	}
+    /**
+     * @param Matcher|string $tagName
+     *
+     * @return \WMDE\HamcrestHtml\TagNameMatcher
+     */
+    function withTagName( $tagName ) {
+        return \WMDE\HamcrestHtml\TagNameMatcher::withTagName( $tagName );
+    }
 }
 
 if ( !function_exists( 'withAttribute' ) ) {
-	/**
-	 * @param Matcher|string $attributeName
-	 *
-	 * @return \WMDE\HamcrestHtml\AttributeMatcher
-	 */
-	function withAttribute( $attributeName ) {
-		return \WMDE\HamcrestHtml\AttributeMatcher::withAttribute( $attributeName );
-	}
+    /**
+     * @param Matcher|string $attributeName
+     *
+     * @return \WMDE\HamcrestHtml\AttributeMatcher
+     */
+    function withAttribute( $attributeName ) {
+        return \WMDE\HamcrestHtml\AttributeMatcher::withAttribute( $attributeName );
+    }
 }
 
 if ( !function_exists( 'withClass' ) ) {
-	/**
-	 * @param Matcher|string $class
-	 *
-	 * @return \WMDE\HamcrestHtml\ClassMatcher
-	 */
-	function withClass( $class ) {
-		// TODO don't allow to call with empty string
+    /**
+     * @param Matcher|string $class
+     *
+     * @return \WMDE\HamcrestHtml\ClassMatcher
+     */
+    function withClass( $class ) {
+        // TODO don't allow to call with empty string
 
-		return \WMDE\HamcrestHtml\ClassMatcher::withClass( $class );
-	}
+        return \WMDE\HamcrestHtml\ClassMatcher::withClass( $class );
+    }
 }
 
 if ( !function_exists( 'havingTextContents' ) ) {
-	/**
-	 * @param Matcher|string $text
-	 *
-	 * @return \WMDE\HamcrestHtml\TextContentsMatcher
-	 */
-	function havingTextContents( $text ) {
-		return \WMDE\HamcrestHtml\TextContentsMatcher::havingTextContents( $text );
-	}
+    /**
+     * @param Matcher|string $text
+     *
+     * @return \WMDE\HamcrestHtml\TextContentsMatcher
+     */
+    function havingTextContents( $text ) {
+        return \WMDE\HamcrestHtml\TextContentsMatcher::havingTextContents( $text );
+    }
 }
 
 if ( !function_exists( 'tagMatchingOutline' ) ) {
-	/**
-	 * @param string $htmlOutline
-	 *
-	 * @return \WMDE\HamcrestHtml\ComplexTagMatcher
-	 */
-	function tagMatchingOutline( $htmlOutline ) {
-		return \WMDE\HamcrestHtml\ComplexTagMatcher::tagMatchingOutline( $htmlOutline );
-	}
+    /**
+     * @param string $htmlOutline
+     *
+     * @return \WMDE\HamcrestHtml\ComplexTagMatcher
+     */
+    function tagMatchingOutline( $htmlOutline ) {
+        return \WMDE\HamcrestHtml\ComplexTagMatcher::tagMatchingOutline( $htmlOutline );
+    }
 }

src/AttributeMatcher.php

Indentation +66 added lines, -66 removed lines

@@ -8,80 +8,80 @@
 
 class AttributeMatcher extends TagMatcher {
 
-	/**
-	 * @var Matcher
-	 */
-	private $attributeNameMatcher;
+    /**
+     * @var Matcher
+     */
+    private $attributeNameMatcher;
 
-	/**
-	 * @var Matcher|null
-	 */
-	private $valueMatcher;
+    /**
+     * @var Matcher|null
+     */
+    private $valueMatcher;
 
-	/**
-	 * @param Matcher|string $attributeName
-	 *
-	 * @return self
-	 */
-	public static function withAttribute( $attributeName ) {
-		return new static( Util::wrapValueWithIsEqual( $attributeName ) );
-	}
+    /**
+     * @param Matcher|string $attributeName
+     *
+     * @return self
+     */
+    public static function withAttribute( $attributeName ) {
+        return new static( Util::wrapValueWithIsEqual( $attributeName ) );
+    }
 
-	/**
-	 * @param Matcher $attributeNameMatcher
-	 */
-	public function __construct( Matcher $attributeNameMatcher ) {
-		parent::__construct();
+    /**
+     * @param Matcher $attributeNameMatcher
+     */
+    public function __construct( Matcher $attributeNameMatcher ) {
+        parent::__construct();
 
-		$this->attributeNameMatcher = $attributeNameMatcher;
-	}
+        $this->attributeNameMatcher = $attributeNameMatcher;
+    }
 
-	/**
-	 * @param Matcher|string $value
-	 *
-	 * @return AttributeMatcher
-	 */
-	public function havingValue( $value ) {
-		// TODO: Throw exception if value is set
-		$result = clone $this;
-		$result->valueMatcher = Util::wrapValueWithIsEqual( $value );
+    /**
+     * @param Matcher|string $value
+     *
+     * @return AttributeMatcher
+     */
+    public function havingValue( $value ) {
+        // TODO: Throw exception if value is set
+        $result = clone $this;
+        $result->valueMatcher = Util::wrapValueWithIsEqual( $value );
 
-		return $result;
-	}
+        return $result;
+    }
 
-	public function describeTo( Description $description ) {
-		$description->appendText( 'with attribute ' )
-			->appendDescriptionOf( $this->attributeNameMatcher );
-		if ( $this->valueMatcher ) {
-			$description->appendText( ' having value ' )
-				->appendDescriptionOf( $this->valueMatcher );
-		}
-	}
+    public function describeTo( Description $description ) {
+        $description->appendText( 'with attribute ' )
+            ->appendDescriptionOf( $this->attributeNameMatcher );
+        if ( $this->valueMatcher ) {
+            $description->appendText( ' having value ' )
+                ->appendDescriptionOf( $this->valueMatcher );
+        }
+    }
 
-	/**
-	 * @param \DOMElement $item
-	 * @param Description $mismatchDescription
-	 *
-	 * @return bool
-	 */
-	protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
-		/** @var \DOMAttr $attribute */
-		foreach ( $item->attributes as $attribute ) {
-			if ( $this->valueMatcher ) {
-				if (
-					$this->attributeNameMatcher->matches( $attribute->name )
-					&& $this->valueMatcher->matches( $attribute->value )
-				) {
-					return true;
-				}
-			} else {
-				if ( $this->attributeNameMatcher->matches( $attribute->name ) ) {
-					return true;
-				}
-			}
-		}
+    /**
+     * @param \DOMElement $item
+     * @param Description $mismatchDescription
+     *
+     * @return bool
+     */
+    protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
+        /** @var \DOMAttr $attribute */
+        foreach ( $item->attributes as $attribute ) {
+            if ( $this->valueMatcher ) {
+                if (
+                    $this->attributeNameMatcher->matches( $attribute->name )
+                    && $this->valueMatcher->matches( $attribute->value )
+                ) {
+                    return true;
+                }
+            } else {
+                if ( $this->attributeNameMatcher->matches( $attribute->name ) ) {
+                    return true;
+                }
+            }
+        }
 
-		return false;
-	}
+        return false;
+    }
 
 }

src/ClassMatcher.php

Indentation +41 added lines, -41 removed lines

@@ -8,46 +8,46 @@
 
 class ClassMatcher extends TagMatcher {
 
-	/**
-	 * @var Matcher
-	 */
-	private $classMatcher;
-
-	/**
-	 * @param Matcher|string $class
-	 *
-	 * @return self
-	 */
-	public static function withClass( $class ) {
-		return new static( Util::wrapValueWithIsEqual( $class ) );
-	}
-
-	public function __construct( Matcher $class ) {
-		parent::__construct();
-		$this->classMatcher = $class;
-	}
-
-	public function describeTo( Description $description ) {
-		$description->appendText( 'with class ' )->appendDescriptionOf( $this->classMatcher );
-	}
-
-	/**
-	 * @param \DOMElement $item
-	 * @param Description $mismatchDescription
-	 *
-	 * @return bool
-	 */
-	protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
-		$classAttribute = $item->getAttribute( 'class' );
-
-		$classes = preg_split( '/\s+/u', $classAttribute );
-		foreach ( $classes as $class ) {
-			if ( $this->classMatcher->matches( $class ) ) {
-				return true;
-			}
-		}
-
-		return false;
-	}
+    /**
+     * @var Matcher
+     */
+    private $classMatcher;
+
+    /**
+     * @param Matcher|string $class
+     *
+     * @return self
+     */
+    public static function withClass( $class ) {
+        return new static( Util::wrapValueWithIsEqual( $class ) );
+    }
+
+    public function __construct( Matcher $class ) {
+        parent::__construct();
+        $this->classMatcher = $class;
+    }
+
+    public function describeTo( Description $description ) {
+        $description->appendText( 'with class ' )->appendDescriptionOf( $this->classMatcher );
+    }
+
+    /**
+     * @param \DOMElement $item
+     * @param Description $mismatchDescription
+     *
+     * @return bool
+     */
+    protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
+        $classAttribute = $item->getAttribute( 'class' );
+
+        $classes = preg_split( '/\s+/u', $classAttribute );
+        foreach ( $classes as $class ) {
+            if ( $this->classMatcher->matches( $class ) ) {
+                return true;
+            }
+        }
+
+        return false;
+    }
 
 }

src/TextContentsMatcher.php

Indentation +32 added lines, -32 removed lines

@@ -8,37 +8,37 @@
 
 class TextContentsMatcher extends TagMatcher {
 
-	/**
-	 * @var Matcher
-	 */
-	private $matcher;
-
-	/**
-	 * @param Matcher|string $text
-	 *
-	 * @return self
-	 */
-	public static function havingTextContents( $text ) {
-		return new static( Util::wrapValueWithIsEqual( $text ) );
-	}
-
-	public function __construct( Matcher $matcher ) {
-		parent::__construct();
-		$this->matcher = $matcher;
-	}
-
-	public function describeTo( Description $description ) {
-		$description->appendText( 'having text contents ' )->appendDescriptionOf( $this->matcher );
-	}
-
-	/**
-	 * @param \DOMElement $item
-	 * @param Description $mismatchDescription
-	 *
-	 * @return bool
-	 */
-	protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
-		return $this->matcher->matches( $item->textContent );
-	}
+    /**
+     * @var Matcher
+     */
+    private $matcher;
+
+    /**
+     * @param Matcher|string $text
+     *
+     * @return self
+     */
+    public static function havingTextContents( $text ) {
+        return new static( Util::wrapValueWithIsEqual( $text ) );
+    }
+
+    public function __construct( Matcher $matcher ) {
+        parent::__construct();
+        $this->matcher = $matcher;
+    }
+
+    public function describeTo( Description $description ) {
+        $description->appendText( 'having text contents ' )->appendDescriptionOf( $this->matcher );
+    }
+
+    /**
+     * @param \DOMElement $item
+     * @param Description $mismatchDescription
+     *
+     * @return bool
+     */
+    protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
+        return $this->matcher->matches( $item->textContent );
+    }
 
 }

src/RootElementMatcher.php

Indentation +48 added lines, -48 removed lines

@@ -8,60 +8,60 @@
 
 class RootElementMatcher extends TypeSafeDiagnosingMatcher {
 
-	/**
-	 * @var Matcher
-	 */
-	private $tagMatcher;
+    /**
+     * @var Matcher
+     */
+    private $tagMatcher;
 
-	/**
-	 * @param Matcher|null $tagMatcher
-	 *
-	 * @return static
-	 */
-	public static function havingRootElement( Matcher $tagMatcher = null ) {
-		return new static( $tagMatcher );
-	}
+    /**
+     * @param Matcher|null $tagMatcher
+     *
+     * @return static
+     */
+    public static function havingRootElement( Matcher $tagMatcher = null ) {
+        return new static( $tagMatcher );
+    }
 
-	public function __construct( Matcher $tagMatcher = null ) {
-		parent::__construct( self::TYPE_OBJECT, \DOMDocument::class );
-		$this->tagMatcher = $tagMatcher;
-	}
+    public function __construct( Matcher $tagMatcher = null ) {
+        parent::__construct( self::TYPE_OBJECT, \DOMDocument::class );
+        $this->tagMatcher = $tagMatcher;
+    }
 
-	public function describeTo( Description $description ) {
-		$description->appendText( 'having root element ' );
-		if ( $this->tagMatcher ) {
-			$description->appendDescriptionOf( $this->tagMatcher );
-		}
-	}
+    public function describeTo( Description $description ) {
+        $description->appendText( 'having root element ' );
+        if ( $this->tagMatcher ) {
+            $description->appendDescriptionOf( $this->tagMatcher );
+        }
+    }
 
-	/**
-	 * @param \DOMDocument $item
-	 * @param Description $mismatchDescription
-	 *
-	 * @return bool
-	 */
-	protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
-		$DOMNodeList = $item->documentElement->childNodes->item( 0 )->childNodes;
-		if ( $DOMNodeList->length > 1 ) {
-			// TODO Test this description
-			$mismatchDescription->appendText( 'having ' . $DOMNodeList->length . ' root elements ' );
-			return false;
-		}
+    /**
+     * @param \DOMDocument $item
+     * @param Description $mismatchDescription
+     *
+     * @return bool
+     */
+    protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
+        $DOMNodeList = $item->documentElement->childNodes->item( 0 )->childNodes;
+        if ( $DOMNodeList->length > 1 ) {
+            // TODO Test this description
+            $mismatchDescription->appendText( 'having ' . $DOMNodeList->length . ' root elements ' );
+            return false;
+        }
 
-		$target = $DOMNodeList->item( 0 );
-		if ( !$target ) {
-			// TODO Reproduce?
-			$mismatchDescription->appendText( 'having no root elements ' );
-			return false;
-		}
+        $target = $DOMNodeList->item( 0 );
+        if ( !$target ) {
+            // TODO Reproduce?
+            $mismatchDescription->appendText( 'having no root elements ' );
+            return false;
+        }
 
-		if ( $this->tagMatcher ) {
-			$mismatchDescription->appendText( 'root element ' );
-			$this->tagMatcher->describeMismatch( $target, $mismatchDescription );
-			return $this->tagMatcher->matches( $target );
-		}
+        if ( $this->tagMatcher ) {
+            $mismatchDescription->appendText( 'root element ' );
+            $this->tagMatcher->describeMismatch( $target, $mismatchDescription );
+            return $this->tagMatcher->matches( $target );
+        }
 
-		return true;
-	}
+        return true;
+    }
 
 }

src/DirectChildElementMatcher.php

Indentation +56 added lines, -56 removed lines

@@ -8,61 +8,61 @@
 
 class DirectChildElementMatcher extends TypeSafeDiagnosingMatcher {
 
-	/**
-	 * @var Matcher
-	 */
-	private $matcher;
-
-	public static function havingDirectChild( Matcher $elementMatcher = null ) {
-		return new static( $elementMatcher );
-	}
-
-	public function __construct( Matcher $matcher = null ) {
-		parent::__construct( \DOMNode::class );
-		$this->matcher = $matcher;
-	}
-
-	public function describeTo( Description $description ) {
-		$description->appendText( 'having direct child ' );
-		if ( $this->matcher ) {
-			$description->appendDescriptionOf( $this->matcher );
-		}
-	}
-
-	/**
-	 * @param \DOMDocument|\DOMNode $item
-	 * @param Description $mismatchDescription
-	 *
-	 * @return bool
-	 */
-	protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
-		if ( $item instanceof \DOMDocument ) {
-			$item = $item->documentElement->childNodes->item( 0 );
-		}
-		$directChildren = $item->childNodes;
-
-		if ( $directChildren->length === 0 ) {
-			$mismatchDescription->appendText( 'with no direct children' );
-			return false;
-		}
-
-		$childWord = $directChildren->length === 1 ? 'child' : 'children';
-
-		$mismatchDescription->appendText( "with direct {$childWord} " );
-
-		if ( !$this->matcher ) {
-			return $directChildren->length !== 0;
-		}
-
-		foreach ( $directChildren as $child ) {
-			if ( $this->matcher->matches( $child ) ) {
-				return true;
-			}
-		}
-
-		$this->matcher->describeMismatch( $child, $mismatchDescription );
-
-		return false;
-	}
+    /**
+     * @var Matcher
+     */
+    private $matcher;
+
+    public static function havingDirectChild( Matcher $elementMatcher = null ) {
+        return new static( $elementMatcher );
+    }
+
+    public function __construct( Matcher $matcher = null ) {
+        parent::__construct( \DOMNode::class );
+        $this->matcher = $matcher;
+    }
+
+    public function describeTo( Description $description ) {
+        $description->appendText( 'having direct child ' );
+        if ( $this->matcher ) {
+            $description->appendDescriptionOf( $this->matcher );
+        }
+    }
+
+    /**
+     * @param \DOMDocument|\DOMNode $item
+     * @param Description $mismatchDescription
+     *
+     * @return bool
+     */
+    protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
+        if ( $item instanceof \DOMDocument ) {
+            $item = $item->documentElement->childNodes->item( 0 );
+        }
+        $directChildren = $item->childNodes;
+
+        if ( $directChildren->length === 0 ) {
+            $mismatchDescription->appendText( 'with no direct children' );
+            return false;
+        }
+
+        $childWord = $directChildren->length === 1 ? 'child' : 'children';
+
+        $mismatchDescription->appendText( "with direct {$childWord} " );
+
+        if ( !$this->matcher ) {
+            return $directChildren->length !== 0;
+        }
+
+        foreach ( $directChildren as $child ) {
+            if ( $this->matcher->matches( $child ) ) {
+                return true;
+            }
+        }
+
+        $this->matcher->describeMismatch( $child, $mismatchDescription );
+
+        return false;
+    }
 
 }

src/ChildElementMatcher.php

Indentation +44 added lines, -44 removed lines

@@ -8,57 +8,57 @@
 
 class ChildElementMatcher extends TypeSafeDiagnosingMatcher {
 
-	/**
-	 * @var Matcher|null
-	 */
-	private $matcher;
+    /**
+     * @var Matcher|null
+     */
+    private $matcher;
 
-	public static function havingChild( Matcher $elementMatcher = null ) {
-		return new static( $elementMatcher );
-	}
+    public static function havingChild( Matcher $elementMatcher = null ) {
+        return new static( $elementMatcher );
+    }
 
-	public function __construct( Matcher $matcher = null ) {
-		parent::__construct( \DOMNode::class );
-		$this->matcher = $matcher;
-	}
+    public function __construct( Matcher $matcher = null ) {
+        parent::__construct( \DOMNode::class );
+        $this->matcher = $matcher;
+    }
 
-	public function describeTo( Description $description ) {
-		$description->appendText( 'having child ' );
-		if ( $this->matcher ) {
-			$description->appendDescriptionOf( $this->matcher );
-		}
-	}
+    public function describeTo( Description $description ) {
+        $description->appendText( 'having child ' );
+        if ( $this->matcher ) {
+            $description->appendDescriptionOf( $this->matcher );
+        }
+    }
 
-	/**
-	 * @param \DOMDocument|\DOMNode $item
-	 * @param Description $mismatchDescription
-	 *
-	 * @return bool
-	 */
-	protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
-		if ( $item instanceof \DOMDocument ) {
-			$directChildren = $item->documentElement->childNodes->item( 0 )->childNodes;
-		} else {
-			$directChildren = $item->childNodes;
-		}
+    /**
+     * @param \DOMDocument|\DOMNode $item
+     * @param Description $mismatchDescription
+     *
+     * @return bool
+     */
+    protected function matchesSafelyWithDiagnosticDescription( $item, Description $mismatchDescription ) {
+        if ( $item instanceof \DOMDocument ) {
+            $directChildren = $item->documentElement->childNodes->item( 0 )->childNodes;
+        } else {
+            $directChildren = $item->childNodes;
+        }
 
-		if ( $directChildren->length === 0 ) {
-			$mismatchDescription->appendText( 'having no children' );
-			return false;
-		}
+        if ( $directChildren->length === 0 ) {
+            $mismatchDescription->appendText( 'having no children' );
+            return false;
+        }
 
-		if ( !$this->matcher ) {
-			return $directChildren->length > 0;
-		}
+        if ( !$this->matcher ) {
+            return $directChildren->length > 0;
+        }
 
-		foreach ( new XmlNodeRecursiveIterator( $directChildren ) as $child ) {
-			if ( $this->matcher->matches( $child ) ) {
-				return true;
-			}
-		}
+        foreach ( new XmlNodeRecursiveIterator( $directChildren ) as $child ) {
+            if ( $this->matcher->matches( $child ) ) {
+                return true;
+            }
+        }
 
-		$mismatchDescription->appendText( 'having no children ' )->appendDescriptionOf( $this->matcher );
-		return false;
-	}
+        $mismatchDescription->appendText( 'having no children ' )->appendDescriptionOf( $this->matcher );
+        return false;
+    }
 
 }