Added withName and updated $name in MwStack

`$name` is now an optional parameter in the MwStack

Signed-off-by: RJ Garcia <rj@bighead.net>

CHANGELOG.md

@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
+### Added
+
+- Added `withName` func to MwStack
+- Made the `$name` parameter optional in the MwStack
 
 ## [0.4.1] - 2017-01-19
 ### Added

doc/api.rst

@@ -232,6 +232,8 @@ Closure compose(callable $last = null)
     Composes the stack into a handler.
 Generator getEntries()
     Yields the raw stack entries in the order they were added.
+MwStack withName($name)
+    Creates a clone of the current stack with an updated name.
 MwStack withContext(Context $ctx)
     Creates a clone of the current stack with an updated context
 MwStack withLinkClass($class)

src/MwStack.php

@@ -15,7 +15,7 @@ class MwStack implements Countable
     private $heap;
     private $name_map;
 
-    public function __construct($name, Context $ctx = null, $link_class = Link::class) {
+    public function __construct($name = null, Context $ctx = null, $link_class = Link::class) {
         $this->name = $name;
         $this->ctx = $ctx;
         $this->link_class = $link_class;
@@ -167,6 +167,11 @@ public function compose($last = null) {
         return compose($this->normalize(), $this->ctx, $last, $this->link_class);
     }
 
+    public function withName($name) {
+        $stack = clone $this;
+        $stack->name = $name;
+        return $stack;
+    }
     public function withContext(Context $ctx) {
         $stack = clone $this;
         $stack->ctx = $ctx;
@@ -189,7 +194,7 @@ public function getEntries() {
         }
     }
 
-    public static function createFromEntries($name, $entries, Context $ctx = null, $link_class = Link::class) {
+    public static function createFromEntries($name = null, $entries, Context $ctx = null, $link_class = Link::class) {
         $stack = new static($name, $ctx, $link_class);
         foreach ($entries as $entry) {
             $stack->insertEntry($entry, 'array_push');

src/mw.php

@@ -142,7 +142,7 @@ function stackEntry($mw, $sort = 0, $name = null) {
     return [$mw, $sort, $name];
 }
 
-function stack($name, array $entries = [], Context $context = null, $link_class = Link::class) {
+function stack($name = null, array $entries = [], Context $context = null, $link_class = Link::class) {
     return MwStack::createFromEntries($name, $entries, $context, $link_class);
 }
 

test/mw.spec.php

@@ -182,6 +182,10 @@ function() { return 1; },
             $handler = $stack->compose();
             assert($handler(2) === 1);
         });
+        it('allows you to change name', function() {
+            $stack = mw\stack()->withName('Stack');
+            assert($stack->getName() == 'Stack');
+        });
         it('allows you to change context', function() {
             $stack = mw\stack('stack')->withContext(new Mw\Context\StdContext(function() { return 1; }));
             $stack->push(id());