-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/

-- | Path
--   
--   Path
@package path
@version 0.5.3

-- | Internal types and functions.
module Path.Internal

-- | Path of some base and type.
--   
--   Internally is a string. The string can be of two formats only:
--   
--   
--   
- File format: file.txt, foo/bar.txt,
--   /foo/bar.txt
--   
- Directory format: foo/, /foo/bar/
--   
--   
--   All directories end in a trailing separator. There are no duplicate
--   path separators //, no .., no ./, no
--   ~/, etc.
newtype Path b t
Path :: FilePath -> Path b t
instance GHC.Classes.Eq (Path.Internal.Path b t)
instance GHC.Classes.Ord (Path.Internal.Path b t)
instance GHC.Show.Show (Path.Internal.Path b t)

-- | A normalizing well-typed path type.
module Path

-- | Path of some base and type.
--   
--   Internally is a string. The string can be of two formats only:
--   
--   
--   
- File format: file.txt, foo/bar.txt,
--   /foo/bar.txt
--   
- Directory format: foo/, /foo/bar/
--   
--   
--   All directories end in a trailing separator. There are no duplicate
--   path separators //, no .., no ./, no
--   ~/, etc.
data Path b t

-- | An absolute path.
data Abs

-- | A relative path; one without a root.
data Rel

-- | A file path.
data File

-- | A directory path.
data Dir

-- | Get a location for an absolute directory. Produces a normalized path
--   which always ends in a path separator.
--   
--   Throws: PathParseException
parseAbsDir :: MonadThrow m => FilePath -> m (Path Abs Dir)

-- | Get a location for a relative directory. Produces a normalized path
--   which always ends in a path separator.
--   
--   Throws: PathParseException
parseRelDir :: MonadThrow m => FilePath -> m (Path Rel Dir)

-- | Get a location for an absolute file.
--   
--   Throws: PathParseException
parseAbsFile :: MonadThrow m => FilePath -> m (Path Abs File)

-- | Get a location for a relative file.
--   
--   Throws: PathParseException
parseRelFile :: MonadThrow m => FilePath -> m (Path Rel File)

-- | Exception when parsing a location.
data PathParseException

-- | Make a 'Path Abs Dir'.
--   
--   Remember: due to the nature of absolute paths this (e.g.
--   /home/foo) may compile on your platform, but it may not
--   compile on another platform (Windows).
mkAbsDir :: FilePath -> Q Exp

-- | Make a 'Path Rel Dir'.
mkRelDir :: FilePath -> Q Exp

-- | Make a 'Path Abs File'.
--   
--   Remember: due to the nature of absolute paths this (e.g.
--   /home/foo) may compile on your platform, but it may not
--   compile on another platform (Windows).
mkAbsFile :: FilePath -> Q Exp

-- | Make a 'Path Rel File'.
mkRelFile :: FilePath -> Q Exp

-- | Append two paths.
--   
--   The following cases are valid and the equalities hold:
--   
--   
--   $(mkAbsDir x) </> $(mkRelDir y) = $(mkAbsDir (x ++ "/" ++ y))
--   
--   
--   
--   $(mkAbsDir x) </> $(mkRelFile y) = $(mkAbsFile (x ++ "/" ++ y))
--   
--   
--   
--   $(mkRelDir x) </> $(mkRelDir y) = $(mkRelDir (x ++ "/" ++ y))
--   
--   
--   
--   $(mkRelDir x) </> $(mkRelFile y) = $(mkRelFile (x ++ "/" ++ y))
--   
--   
--   The following are proven not possible to express:
--   
--   
--   $(mkAbsFile …) </> x
--   
--   
--   
--   $(mkRelFile …) </> x
--   
--   
--   
--   x </> $(mkAbsFile …)
--   
--   
--   
--   x </> $(mkAbsDir …)
--   
(</>) :: Path b Dir -> Path Rel t -> Path b t

-- | Strip directory from path, making it relative to that directory.
--   Returns Nothing if directory is not a parent of the path.
--   
--   The following properties hold:
--   
--   
--   stripDir x (x </> y) = y
--   
--   
--   Cases which are proven not possible:
--   
--   
--   stripDir (a :: Path Abs …) (b :: Path Rel …)
--   
--   
--   
--   stripDir (a :: Path Rel …) (b :: Path Abs …)
--   
--   
--   In other words the bases must match.
--   
--   Throws: Couldn'tStripPrefixDir
stripDir :: MonadThrow m => Path b Dir -> Path b t -> m (Path Rel t)

-- | Is p a parent of the given location? Implemented in terms of
--   stripDir. The bases must match.
isParentOf :: Path b Dir -> Path b t -> Bool

-- | Take the absolute parent directory from the absolute path.
--   
--   The following properties hold:
--   
--   
--   parent (x </> y) == x
--   
--   
--   On the root, getting the parent is idempotent:
--   
--   
--   parent (parent "/") = "/"
--   
parent :: Path Abs t -> Path Abs Dir

-- | Extract the file part of a path.
--   
--   The following properties hold:
--   
--   
--   filename (p </> a) == filename a
--   
filename :: Path b File -> Path Rel File

-- | Extract the last directory name of a path.
--   
--   The following properties hold:
--   
--   
--   dirname (p </> a) == dirname a
--   
dirname :: Path b Dir -> Path Rel Dir

-- | Convert to a FilePath type.
--   
--   All directories have a trailing slash, so if you want no trailing
--   slash, you can use dropTrailingPathSeparator from the filepath
--   package.
toFilePath :: Path b t -> FilePath

-- | Convert absolute path to directory to FilePath type.
fromAbsDir :: Path Abs Dir -> FilePath

-- | Convert relative path to directory to FilePath type.
fromRelDir :: Path Rel Dir -> FilePath

-- | Convert absolute path to file to FilePath type.
fromAbsFile :: Path Abs File -> FilePath

-- | Convert relative path to file to FilePath type.
fromRelFile :: Path Rel File -> FilePath
instance GHC.Show.Show Path.PathParseException
instance GHC.Exception.Exception Path.PathParseException
