217 lines
		
	
	
		
			6.7 KiB
		
	
	
	
		
			Haskell
		
	
	
	
	
	
			
		
		
	
	
			217 lines
		
	
	
		
			6.7 KiB
		
	
	
	
		
			Haskell
		
	
	
	
	
	
{-|
 | 
						||
 | 
						||
Standard imports and utilities which are useful everywhere, or needed low
 | 
						||
in the module hierarchy. This is the bottom of hledger's module graph.
 | 
						||
 | 
						||
-}
 | 
						||
 | 
						||
module Hledger.Utils (---- provide these frequently used modules - or not, for clearer api:
 | 
						||
                          -- module Control.Monad,
 | 
						||
                          -- module Data.List,
 | 
						||
                          -- module Data.Maybe,
 | 
						||
                          -- module Data.Time.Calendar,
 | 
						||
                          -- module Data.Time.Clock,
 | 
						||
                          -- module Data.Time.LocalTime,
 | 
						||
                          -- module Data.Tree,
 | 
						||
                          -- module Text.RegexPR,
 | 
						||
                          -- module Test.HUnit,
 | 
						||
                          -- module Text.Printf,
 | 
						||
                          ---- all of this one:
 | 
						||
                          module Hledger.Utils,
 | 
						||
                          module Hledger.Utils.Debug,
 | 
						||
                          module Hledger.Utils.Parse,
 | 
						||
                          module Hledger.Utils.Regex,
 | 
						||
                          module Hledger.Utils.String,
 | 
						||
                          module Hledger.Utils.Text,
 | 
						||
                          module Hledger.Utils.Test,
 | 
						||
                          module Hledger.Utils.Color,
 | 
						||
                          module Hledger.Utils.Tree,
 | 
						||
                          -- Debug.Trace.trace,
 | 
						||
                          -- module Data.PPrint,
 | 
						||
                          -- module Hledger.Utils.UTF8IOCompat
 | 
						||
                          SystemString,fromSystemString,toSystemString,error',userError',usageError,
 | 
						||
                          -- the rest need to be done in each module I think
 | 
						||
                          )
 | 
						||
where
 | 
						||
import Control.Monad (liftM)
 | 
						||
-- import Data.Char
 | 
						||
import Data.Default
 | 
						||
import Data.List
 | 
						||
-- import Data.Maybe
 | 
						||
-- import Data.PPrint
 | 
						||
import Data.Text (Text)
 | 
						||
import qualified Data.Text.IO as T
 | 
						||
import Data.Time.Clock
 | 
						||
import Data.Time.LocalTime
 | 
						||
-- import Data.Text (Text)
 | 
						||
-- import qualified Data.Text as T
 | 
						||
import System.Directory (getHomeDirectory)
 | 
						||
import System.FilePath((</>), isRelative)
 | 
						||
import System.IO
 | 
						||
-- import Text.Printf
 | 
						||
-- import qualified Data.Map as Map
 | 
						||
 | 
						||
import Hledger.Utils.Debug
 | 
						||
import Hledger.Utils.Parse
 | 
						||
import Hledger.Utils.Regex
 | 
						||
import Hledger.Utils.String
 | 
						||
import Hledger.Utils.Text
 | 
						||
import Hledger.Utils.Test
 | 
						||
import Hledger.Utils.Color
 | 
						||
import Hledger.Utils.Tree
 | 
						||
-- import Prelude hiding (readFile,writeFile,appendFile,getContents,putStr,putStrLn)
 | 
						||
-- import Hledger.Utils.UTF8IOCompat   (readFile,writeFile,appendFile,getContents,putStr,putStrLn)
 | 
						||
import Hledger.Utils.UTF8IOCompat (SystemString,fromSystemString,toSystemString,error',userError',usageError)
 | 
						||
 | 
						||
 | 
						||
-- tuples
 | 
						||
 | 
						||
first3  (x,_,_) = x
 | 
						||
second3 (_,x,_) = x
 | 
						||
third3  (_,_,x) = x
 | 
						||
 | 
						||
first4  (x,_,_,_) = x
 | 
						||
second4 (_,x,_,_) = x
 | 
						||
third4  (_,_,x,_) = x
 | 
						||
fourth4 (_,_,_,x) = x
 | 
						||
 | 
						||
first5  (x,_,_,_,_) = x
 | 
						||
second5 (_,x,_,_,_) = x
 | 
						||
third5  (_,_,x,_,_) = x
 | 
						||
fourth5 (_,_,_,x,_) = x
 | 
						||
fifth5  (_,_,_,_,x) = x
 | 
						||
 | 
						||
first6  (x,_,_,_,_,_) = x
 | 
						||
second6 (_,x,_,_,_,_) = x
 | 
						||
third6  (_,_,x,_,_,_) = x
 | 
						||
fourth6 (_,_,_,x,_,_) = x
 | 
						||
fifth6  (_,_,_,_,x,_) = x
 | 
						||
sixth6  (_,_,_,_,_,x) = x
 | 
						||
 | 
						||
-- lists
 | 
						||
 | 
						||
splitAtElement :: Eq a => a -> [a] -> [[a]]
 | 
						||
splitAtElement x l =
 | 
						||
  case l of
 | 
						||
    []          -> []
 | 
						||
    e:es | e==x -> split es
 | 
						||
    es          -> split es
 | 
						||
  where
 | 
						||
    split es = let (first,rest) = break (x==) es
 | 
						||
               in first : splitAtElement x rest
 | 
						||
 | 
						||
-- text
 | 
						||
 | 
						||
-- time
 | 
						||
 | 
						||
getCurrentLocalTime :: IO LocalTime
 | 
						||
getCurrentLocalTime = do
 | 
						||
  t <- getCurrentTime
 | 
						||
  tz <- getCurrentTimeZone
 | 
						||
  return $ utcToLocalTime tz t
 | 
						||
 | 
						||
getCurrentZonedTime :: IO ZonedTime
 | 
						||
getCurrentZonedTime = do
 | 
						||
  t <- getCurrentTime
 | 
						||
  tz <- getCurrentTimeZone
 | 
						||
  return $ utcToZonedTime tz t
 | 
						||
 | 
						||
-- misc
 | 
						||
 | 
						||
instance Default Bool where def = False
 | 
						||
 | 
						||
isLeft :: Either a b -> Bool
 | 
						||
isLeft (Left _) = True
 | 
						||
isLeft _        = False
 | 
						||
 | 
						||
isRight :: Either a b -> Bool
 | 
						||
isRight = not . isLeft
 | 
						||
 | 
						||
-- | Apply a function the specified number of times. Possibly uses O(n) stack ?
 | 
						||
applyN :: Int -> (a -> a) -> a -> a
 | 
						||
applyN n f = (!! n) . iterate f
 | 
						||
-- from protolude, compare
 | 
						||
-- applyN :: Int -> (a -> a) -> a -> a
 | 
						||
-- applyN n f = X.foldr (.) identity (X.replicate n f)
 | 
						||
 | 
						||
-- | Convert a possibly relative, possibly tilde-containing file path to an absolute one,
 | 
						||
-- given the current directory. ~username is not supported. Leave "-" unchanged.
 | 
						||
-- Can raise an error.
 | 
						||
expandPath :: FilePath -> FilePath -> IO FilePath -- general type sig for use in reader parsers
 | 
						||
expandPath _ "-" = return "-"
 | 
						||
expandPath curdir p = (if isRelative p then (curdir </>) else id) `liftM` expandPath' p
 | 
						||
  where
 | 
						||
    expandPath' ('~':'/':p)  = (</> p) <$> getHomeDirectory
 | 
						||
    expandPath' ('~':'\\':p) = (</> p) <$> getHomeDirectory
 | 
						||
    expandPath' ('~':_)      = ioError $ userError "~USERNAME in paths is not supported"
 | 
						||
    expandPath' p            = return p
 | 
						||
 | 
						||
firstJust ms = case dropWhile (==Nothing) ms of
 | 
						||
    [] -> Nothing
 | 
						||
    (md:_) -> md
 | 
						||
 | 
						||
-- | Read a file in universal newline mode, handling any of the usual line ending conventions.
 | 
						||
readFile' :: FilePath -> IO Text
 | 
						||
readFile' name =  do
 | 
						||
  h <- openFile name ReadMode
 | 
						||
  hSetNewlineMode h universalNewlineMode
 | 
						||
  T.hGetContents h
 | 
						||
 | 
						||
-- | Read a file in universal newline mode, handling any of the usual line ending conventions.
 | 
						||
readFileAnyLineEnding :: FilePath -> IO Text
 | 
						||
readFileAnyLineEnding path =  do
 | 
						||
  h <- openFile path ReadMode
 | 
						||
  hSetNewlineMode h universalNewlineMode
 | 
						||
  T.hGetContents h
 | 
						||
 | 
						||
-- | Read the given file, or standard input if the path is "-", using
 | 
						||
-- universal newline mode.
 | 
						||
readFileOrStdinAnyLineEnding :: String -> IO Text
 | 
						||
readFileOrStdinAnyLineEnding f = do
 | 
						||
  h <- fileHandle f
 | 
						||
  hSetNewlineMode h universalNewlineMode
 | 
						||
  T.hGetContents h
 | 
						||
  where
 | 
						||
    fileHandle "-" = return stdin
 | 
						||
    fileHandle f = openFile f ReadMode
 | 
						||
 | 
						||
-- | Total version of maximum, for integral types, giving 0 for an empty list.
 | 
						||
maximum' :: Integral a => [a] -> a
 | 
						||
maximum' [] = 0
 | 
						||
maximum' xs = maximumStrict xs
 | 
						||
 | 
						||
-- | Strict version of sum that doesn’t leak space
 | 
						||
{-# INLINABLE sumStrict #-}
 | 
						||
sumStrict :: Num a => [a] -> a
 | 
						||
sumStrict = foldl' (+) 0
 | 
						||
 | 
						||
-- | Strict version of maximum that doesn’t leak space
 | 
						||
{-# INLINABLE maximumStrict #-}
 | 
						||
maximumStrict :: Ord a => [a] -> a
 | 
						||
maximumStrict = foldl1' max
 | 
						||
 | 
						||
-- | Strict version of minimum that doesn’t leak space
 | 
						||
{-# INLINABLE minimumStrict #-}
 | 
						||
minimumStrict :: Ord a => [a] -> a
 | 
						||
minimumStrict = foldl1' min
 | 
						||
 | 
						||
-- | This is a version of sequence based on difference lists. It is
 | 
						||
-- slightly faster but we mostly use it because it uses the heap
 | 
						||
-- instead of the stack. This has the advantage that Neil Mitchell’s
 | 
						||
-- trick of limiting the stack size to discover space leaks doesn’t
 | 
						||
-- show this as a false positive.
 | 
						||
{-# INLINABLE sequence' #-}
 | 
						||
sequence' :: Monad f => [f a] -> f [a]
 | 
						||
sequence' ms = do
 | 
						||
  h <- go id ms
 | 
						||
  return (h [])
 | 
						||
  where
 | 
						||
    go h [] = return h
 | 
						||
    go h (m:ms) = do
 | 
						||
      x <- m
 | 
						||
      go (h . (x :)) ms
 | 
						||
 | 
						||
{-# INLINABLE mapM' #-}
 | 
						||
mapM' :: Monad f => (a -> f b) -> [a] -> f [b]
 | 
						||
mapM' f = sequence' . map f
 |