IO package:path-io

module Path.IO
path-io
This module provides an interface to System.Directory for users of the Path module. It also implements some extra functionality like recursive scanning and copying of directories, working with temporary files/directories, etc.
package path-io
Uses
Interface to ‘directory’ package for users of ‘path’ Interface to ‘directory’ package for users of ‘path’.
data () => Permissions
path-io Path.IO
data WalkAction b
path-io Path.IO
Action returned by the traversal handler function. The action controls how the traversal will proceed. Note: in version 1.4.0 the type was adjusted to have the b type parameter.
copyPermissions :: MonadIO m => Path b0 t0 -> Path b1 t1 -> m ()
path-io Path.IO
Set permissions for the object found on second given path so they match permissions of the object on the first path.
emptyPermissions :: Permissions
path-io Path.IO
getModificationTime :: MonadIO m => Path b t -> m UTCTime
path-io Path.IO
Obtain the time at which the file or directory was last modified. The operation may fail with:
  • isPermissionError if the user is not permitted to read the modification time; or
  • isDoesNotExistError if the file or directory does not exist.
Caveat for POSIX systems: This function returns a timestamp with sub-second resolution only if this package is compiled against unix-2.6.0.0 or later and the underlying filesystem supports them.
getPermissions :: MonadIO m => Path b t -> m Permissions
path-io Path.IO
The getPermissions operation returns the permissions for the file or directory. The operation may fail with:
  • isPermissionError if the user is not permitted to access the permissions; or
  • isDoesNotExistError if the file or directory does not exist.
isLocationOccupied :: MonadIO m => Path b t -> m Bool
path-io Path.IO
Check if there is a file or directory on specified path.
setModificationTime :: MonadIO m => Path b t -> UTCTime -> m ()
path-io Path.IO
Change the time at which the file or directory was last modified. The operation may fail with:
  • isPermissionError if the user is not permitted to alter the modification time; or
  • isDoesNotExistError if the file or directory does not exist.
Some caveats for POSIX systems:
  • Not all systems support utimensat, in which case the function can only emulate the behavior by reading the access time and then setting both the access and modification times together. On systems where utimensat is supported, the modification time is set atomically with nanosecond precision.
  • If compiled against a version of unix prior to 2.7.0.0, the function would not be able to set timestamps with sub-second resolution. In this case, there would also be loss of precision in the access time.
Note: this is a piece of conditional API, only available if directory-1.2.3.0 or later is used.
setPermissions :: MonadIO m => Path b t -> Permissions -> m ()
path-io Path.IO
The setPermissions operation sets the permissions for the file or directory. The operation may fail with:
  • isPermissionError if the user is not permitted to set the permissions; or
  • isDoesNotExistError if the file or directory does not exist.