[DependencyInjection] Adding a NodeBuilder::addNodeBuilder() method t…

…hat helps achieve a fluid interface when a pre-built NodeBuilder needs to be added.

src/Symfony/Component/Config/Definition/Builder/NodeBuilder.php

@@ -101,6 +101,29 @@ public function node($name, $type)
         return $this->children[$name] = $node;
     }
 
+    /**
+     * Add a NodeBuilder instance directly.
+     *
+     * This helps achieve a fluid interface when a method on your Configuration
+     * class returns a pre-build NodeBuilder instance on your behalf:
+     *
+     *     $root = new NodeBuilder();
+     *         ->node('foo', 'scalar')
+     *         ->addNodeBuilder($this->getBarNodeBuilder())
+     *         ->node('baz', 'scalar')
+     *     ;
+     *
+     * @return Symfony\Component\DependencyInjection\Configuration\Builder\NodeBuilder This builder node
+     */
+    public function addNodeBuilder(NodeBuilder $node)
+    {
+        $node->parent = $this;
+
+        $this->children[$node->name] = $node;
+
+        return $this;
+    }
+
     /**
      * Creates a child array node
      *

tests/Symfony/Tests/Component/DependencyInjection/Configuration/Builder/NodeBuilderTest.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Symfony\Tests\Component\DependencyInjection\Configuration;
+
+use Symfony\Component\DependencyInjection\Configuration\Builder\NodeBuilder;
+
+class NodeBuilderTest extends \PHPUnit_Framework_TestCase
+{
+    public function testAddNodeBuilder()
+    {
+        $nodeBuilder = new NodeBuilder('root', array());
+        $childNode = new NodeBuilder('child', array());
+
+        $ret = $nodeBuilder->addNodeBuilder($childNode);
+        $this->assertEquals(array('child' => $childNode), $nodeBuilder->children);
+        $this->assertEquals($nodeBuilder, $ret);
+    }
+}