added .parent method

Author: Rct567

README.md

@@ -56,6 +56,7 @@ echo $links->get(-1)->textContent; // output 3
 
 - `.find( selector )`
 - `.children( [selector] )`
+- `.parent( [selector] )`
 - `.next( [selector] )`
 - `.prev( [selector] )`
 

src/Rct567/DomQuery/DomQuery.php

@@ -367,6 +367,33 @@ public function children($selector='*') {
 
 		}
 
+		/**
+		 * Get parent
+		 * Get the parent of each element in the current set of matched elements, optionally filtered by a selector
+		 * @return self|void
+		 */
+		public function parent($selector=null) {
+			
+			if (isset($this->document) && $this->length > 0) {
+			
+				$result = new self($this->document);
+				
+				foreach($this->nodes as $node) {
+					
+					if (!is_null($node->parentNode)) {
+						$result->addDomNode($node->parentNode);
+					}
+					
+				}
+
+				if ($selector) $result = $result->filter($selector);
+				
+				return $result;
+			
+			}
+			
+		}
+
 		/**
 		 * Reduce the set of matched elements to those that match the selector 
 		 *
@@ -494,7 +521,6 @@ public function last($selector=null) {
 		/**
 		 * Returns DomQuery with immediately following sibling of all nodes
 		 * jQuery: Get the immediately following sibling of each element in the set of matched elements.
-		 * @todo: If a selector is provided, it retrieves the previous sibling only if it matches that selector.
 		 * @return self|void
 		 */
 		public function next($selector=null) {
@@ -522,7 +548,6 @@ public function next($selector=null) {
 		/**
 		 * Returns DomQuery with immediately preceding sibling of all nodes
 		 * jQuery: Get the immediately preceding sibling of each element in the set of matched elements. 
-		 * @todo If a selector is provided, it retrieves the previous sibling only if it matches that selector.
 		 * @return self|void
 		 */
 		public function prev($selector=null) {

tests/Rct567/DomQuery/Tests/DomQueryTest.php

@@ -64,6 +64,21 @@ public function testFirstLast() {
 
 		}
 
+		/*
+		 *  Test get parent
+		 */
+		public function testParent() {
+
+			$dom = new DomQuery('<a></a><a></a><a class="link">
+				<b><span></span></b>
+			</a>');
+
+			$this->assertEquals('b', $dom->find('span')->parent()->tagName);
+			$this->assertEquals('link', $dom->find('span')->parent('b')->parent('a')->class);
+			$this->assertEquals(0, $dom->find('span')->parent('div')->length);
+
+		}
+
 		/*
 		 * Test traversing nodes from readme
 		 */