Added Path.Parents() function

Author: cmaglie

paths.go

@@ -444,6 +444,25 @@ func (p *Path) EquivalentTo(other *Path) bool {
 	return p.Clean().path == other.Clean().path
 }
 
+// Parents returns all the parents directories of the current path. If the path is absolute
+// it starts from the current path to the root, if the path is relative is starts from the
+// current path to the current directory.
+// The path should be clean for this method to work properly (no .. or . or other shortcuts).
+// This function does not performs any check on the returned paths.
+func (p *Path) Parents() []*Path {
+	res := []*Path{}
+	dir := p
+	for {
+		res = append(res, dir)
+		parent := dir.Parent()
+		if parent.EquivalentTo(dir) {
+			break
+		}
+		dir = parent
+	}
+	return res
+}
+
 func (p *Path) String() string {
 	return p.path
 }

paths_test.go

@@ -225,3 +225,21 @@ func TestCopyDir(t *testing.T) {
 	err = src.Join("file").CopyDirTo(tmp.Join("dest2"))
 	require.Error(t, err, "copying file as dir")
 }
+
+func TestParents(t *testing.T) {
+	parents := New("/a/very/long/path").Parents()
+	require.Len(t, parents, 5)
+	require.Equal(t, "/a/very/long/path", parents[0].String())
+	require.Equal(t, "/a/very/long", parents[1].String())
+	require.Equal(t, "/a/very", parents[2].String())
+	require.Equal(t, "/a", parents[3].String())
+	require.Equal(t, "/", parents[4].String())
+
+	parents2 := New("a/very/relative/path").Parents()
+	require.Len(t, parents, 5)
+	require.Equal(t, "a/very/relative/path", parents2[0].String())
+	require.Equal(t, "a/very/relative", parents2[1].String())
+	require.Equal(t, "a/very", parents2[2].String())
+	require.Equal(t, "a", parents2[3].String())
+	require.Equal(t, ".", parents2[4].String())
+}