[ADD] Methods Map::appendMap() and Map::prependMap(), to append or pr…

…epend the definitions from another map.

src/Aura/Router/Map.php

@@ -156,6 +156,52 @@ public function attach($path_prefix, $spec)
         );
     }
 
+    /**
+     * 
+     * Appends the definitions of another map to this map.
+     * 
+     * @param Map $map The map to append.
+     * 
+     * @return void
+     * 
+     */
+    public function appendMap(Map $map)
+    {
+        // append the map
+        $this->definitions = array_merge(
+            $this->definitions,
+            $map->definitions
+        );
+
+        // reset existing routes and tracking properties
+        $this->attach_common = null;
+        $this->attach_routes = null;
+        $this->routes = [];
+    }
+
+    /**
+     * 
+     * Prepends the definitions of another map to this map.
+     * 
+     * @param Map $map The map to prepend.
+     * 
+     * @return void
+     * 
+     */
+    public function prependMap(Map $map)
+    {
+        // prepend the map
+        $this->definitions = array_merge(
+            $map->definitions,
+            $this->definitions
+        );
+
+        // reset existing routes and tracking properties
+        $this->attach_common = null;
+        $this->attach_routes = null;
+        $this->routes = [];
+    }
+
     /**
      * 
      * Gets a route that matches a given path and other server conditions.

tests/Aura/Router/MapTest.php

@@ -856,4 +856,30 @@ public function testGetLog()
         // this is weak. we should actually see if the log contains anything.
         $this->assertSame([], $this->map->getLog());
     }
+
+    public function testAppendMap()
+    {
+        $append_map = $this->newMap();
+        $append_map->add('bar', '/path/to/bar');
+
+        $this->map->add('foo', '/path/to/foo');
+        $this->map->appendMap($append_map);
+
+        $actual = array_keys($this->map->getRoutes());
+        $expect = ['foo', 'bar'];
+        $this->assertSame($expect, $actual);
+    }
+
+    public function testPrependMap()
+    {
+        $prepend_map = $this->newMap();
+        $prepend_map->add('bar', '/path/to/bar');
+
+        $this->map->add('foo', '/path/to/foo');
+        $this->map->prependMap($prepend_map);
+
+        $actual = array_keys($this->map->getRoutes());
+        $expect = ['bar', 'foo'];
+        $this->assertSame($expect, $actual);
+    }
 }