Filesystem.Path

A file path with no root, directory, or filename

Retrieves the FilePath’s root.

Retrieves the FilePath’s directory. If the path is already a directory, it is returned unchanged.

Retrieves the FilePath’s parent directory.

Retrieve a FilePath’s filename component.

filename "foo/bar.txt" == "bar.txt"

Retrieve a FilePath’s directory name. This is only the file name of the directory, not its full path.

dirname "foo/bar/baz.txt" == "bar"
dirname "/" == ""

Since: 0.4.1

Retrieve a FilePath’s basename component.

basename "foo/bar.txt" == "bar"

Test whether a path is absolute.

Test whether a path is relative.

Appends two FilePaths. If the second path is absolute, it is returned unchanged.

An alias for append.

A fold over append.

Find the greatest common prefix between a list of FilePaths.

Remove a prefix from a path.

stripPrefix "/foo/" "/foo/bar/baz.txt" == Just "bar/baz.txt"
stripPrefix "/foo/" "/bar/baz.txt" == Nothing

This function operates on logical prefixes, rather than by counting characters. The prefix "/foo/bar/baz" is interpreted the path ("/foo/bar/", "baz"), and will be stripped accordingly:

stripPrefix "/foo/bar/baz" "/foo/bar/baz/qux" == Nothing
stripPrefix "/foo/bar/baz" "/foo/bar/baz.txt" == Just ".txt"

Since: 0.4.1

Remove intermediate "." and ".." directories from a path.

collapse "/foo/./bar" == "/foo/bar"
collapse "/foo/bar/../baz" == "/foo/baz"
collapse "/foo/../../bar" == "/bar"
collapse "./foo/bar" == "./foo/baz"

Note that if any of the elements are symbolic links, collapse may change which file the path resolves to.

Since: 0.2

expand a FilePath into a list of the root name, directories, and file name

Since: 0.4.7

Get a FilePath’s last extension, or Nothing if it has no extensions.

Get a FilePath’s full extension list.

Get whether a FilePath’s last extension is the predicate.

Append an extension to the end of a FilePath.

An alias for addExtension.

Remove a FilePath’s last extension.

Replace a FilePath’s last extension.

Append many extensions to the end of a FilePath.

Remove all extensions from a FilePath.

Remove all extensions from a FilePath, and replace them with a new list.