An attempt at an abstract Path type that allows for a common subset of operations to be made cross platform.
This path type is “lexical” in that it is not concerned with actual existing paths, but just the names/spelling of those paths. The most relevant part of this is that symlinks are not followed as that would require querying the actual underlying filesystem.
Note: realpath denotes these types of paths as --logical as it resolves .. before symlinks.
A path is an array of components, which are just strings. When a
path is represented by a string, each component is separated by a path
separator (which is usually / or \). For this library, path separators
only matter when parsing or rendering a path from or to a string.
(For these examples assume that / is the path separator.)
- A component consisting of a single
.has no effect on the path:foo/./bar == foo/bar - A component consisting of
..is a traversal to the previous component:foo/../bar == bar - Trailing separators have no effect on the path:
foo/bar/ == foo/bar - Paths are case sensitive:
foo/Bar ~= foo/bar - Repeated separators/empty components have no effect on the path:
foo//bar == foo/bar
A path may be either “absolute” or “relative”. For Unix platforms, an absolute path will start with a “/”, and Windows absolute paths will start with “\” and maybe a drive letter like “C:\”.
Additionally, a path may be “rooted”. A root is analogous to a drive letter on Windows or a chroot on Unix. Roots are also “lexical” in the sense that they are only used for comparison and don't necessarily reflect any filesystem behavior.
Both relativity and roots are only used for comparison. See documentation 5EB9 of individual functions/methods to see how relativity and roots affect the results.
Two functions are provided to parse paths:
from_unix: uses/as a path separator, doesn't produce rooted pathsfrom_windows: uses both/and\as path separators, may produce rooted paths for drive letters, UNC paths, etc.
Additionally, a from_os function is provided which detects whether the unix or windows parser should be used from package.config
from_components is provided if you need to roll your own parser. This takes
an array of strings to serve as the components, an optional root, and a boolean
for if the path is absolute. Note that this function will normalize the
resulting path according to the assumptions about .., ., empty components,
etc.