Add immediateDescendants/getImmediateDescendants query scope and getter.

README.md

@@ -368,6 +368,7 @@ remember to call `get()` or `first()`.
 * `leaves()`: Instance scope targeting all of its nested children which do not have children.
 * `descendantsAndSelf()`: Scope targeting itself and all of its nested children.
 * `descendants()`: Set of all children & nested children.
+* `immediateDescendants()`: Set of all children nodes (non-recursive).
 
 Second, as **methods** which return actual `Baum\Node` instances.
 
@@ -379,6 +380,7 @@ Second, as **methods** which return actual `Baum\Node` instances.
 * `getLeaves()`: Return all of its nested children which do not have children.
 * `getDescendantsAndSelf()`: Retrieve all nested children and self.
 * `getDescendants()`: Retrieve all of its children & nested children.
+* `getImmediateDescendants()`: Retrieve all of its children nodes (non-recursive).
 
 Here's a simple example for iterating a node's descendants (provided a name
 attribute is available):

src/Baum/Node.php

@@ -462,6 +462,25 @@ public function getDescendants($columns = array('*')) {
     return $this->descendants()->get($columns);
   }
 
+  /**
+   * Set of "immediate" descendants (aka children), alias for the children relation.
+   *
+   * @return \Illuminate\Database\Query\Builder
+   */
+  public function immediateDescendants() {
+    return $this->children();
+  }
+
+  /**
+   * Retrive all of its "immediate" descendants.
+   *
+   * @param array   $columns
+   * @return \Illuminate\Database\Eloquent\Collection
+   */
+  public function getImmediateDescendants($columns = array('*')) {
+    return $this->children()->get($columns);
+  }
+
   /**
   * Returns the level of this node in the tree.
   * Root level is 0.

tests/BaumTest.php

@@ -271,6 +271,16 @@ public function testChildrenRespectDefaultOrdering() {
     $this->assertEquals($children[2], $this->categories('Child 3'));
   }
 
+  public function testGetImmediateDescendants() {
+    $expected = array($this->categories('Child 1'), $this->categories('Child 2'), $this->categories('Child 3'));
+
+    $this->assertEquals($expected, $this->categories('Root 1')->getImmediateDescendants()->all());
+
+    $this->assertEquals(array($this->categories('Child 2.1')), $this->categories('Child 2')->getImmediateDescendants()->all());
+
+    $this->assertEmpty($this->categories('Root 2')->getImmediateDescendants()->all());
+  }
+
   public function testIsSelfOrAncestorOf() {
     $this->assertTrue($this->categories('Root 1')->isSelfOrAncestorOf($this->categories('Child 1')));
     $this->assertTrue($this->categories('Root 1')->isSelfOrAncestorOf($this->categories('Child 2.1')));