Added 'String::with[out]LeadingSlash'

Author: sebastianfeldmann

src/Util/String.php

@@ -184,6 +184,28 @@ public static function withoutTrailingSlash($string)
         return strlen($string) > 1 && substr($string, -1) === '/' ? substr($string, 0, -1) : $string;
     }
 
+    /**
+     * Adds leading slash to a string/path if not already there.
+     *
+     * @param  string $string
+     * @return string
+     */
+    public static function withLeadingSlash($string)
+    {
+        return (substr($string, 0, 1) !== '/' ? '/' : '') . $string;
+    }
+
+    /**
+     * Removes the leading slash from a string/path.
+     *
+     * @param  string $string
+     * @return string
+     */
+    public static function withoutLeadingSlash($string)
+    {
+        return substr($string, 0, 1) === '/' ? substr($string, 1) : $string;
+    }
+
     /**
      * Appends a plural "s" or "'s".
      *

tests/phpbu/Util/StringTest.php

@@ -208,6 +208,27 @@ public function testWithoutTrailingSlash()
         $this->assertEquals('/', String::withoutTrailingSlash('/'), '/ should be stay /');
     }
 
+    /**
+     * Test with trailing slash.
+     */
+    public function testWithLeadingSlash()
+    {
+        $this->assertEquals('/foo', String::withLeadingSlash('foo'), 'should be /foo');
+        $this->assertEquals('/foo/bar', String::withLeadingSlash('foo/bar'), 'should be /foo/bar');
+        $this->assertEquals('/baz', String::withLeadingSlash('/baz'), 'should be baz/');
+    }
+
+    /**
+     * Test without trailing slash.
+     */
+    public function testWithoutLeadingSlash()
+    {
+        $this->assertEquals('foo', String::withoutLeadingSlash('/foo'), 'should be foo');
+        $this->assertEquals('foo/bar', String::withoutLeadingSlash('/foo/bar'), 'should be foo/bar');
+        $this->assertEquals('baz', String::withoutLeadingSlash('baz'), 'should be baz');
+        $this->assertEquals('', String::withoutLeadingSlash('/'), 'slash should be removed');
+    }
+
     /**
      * Tests String::appendPluralS
      */