yi-0.3: Yi/Dired.hs
{-# LANGUAGE DeriveDataTypeable #-}
-- Copyright (c) 2007, 2008 Ben Moseley
-- | A Simple Dired Implementation for Yi
-- TODO
-------
-- Support Symlinks
-- Mark operations
-- - rename
-- - delete
-- - search
-- set 'bmode' in buffer - ReadOnly
-- Improve the colouring to show
-- - loaded buffers
-- - .hs files
-- - marked files
-- Fix old mod dates (> 6months) to show year
-- Fix the 'number of links' field to show actual values not just 1...
-- Automatic support for browsing .zip, .gz files etc...
module Yi.Dired (
dired
,diredDir
,diredDirBuffer
,fnewE
) where
import Control.Monad.Trans
import Data.List
import qualified Data.Map as M
import Data.Typeable
import System.Directory
import System.FilePath
import System.Locale
import System.Posix.Files
import System.Posix.Types
import System.Posix.User
-- currently used to lookup the usernames for file owners. Any
-- suggestions on how to drop the dependency welcome.
import System.Time
import Text.Printf
import Text.Regex.Posix
import Yi.Keymap.Emacs.Keys (rebind)
import Yi.MiniBuffer (withMinibuffer)
import Control.Monad
import Yi.Buffer
import Yi.Buffer.HighLevel
import Yi.Core
import Yi.Editor
import Yi.Buffer.Region
import Yi.Style
import Yi.Syntax ( Highlighter, ExtHL(..) )
import Yi.Syntax.Table ( highlighters )
------------------------------------------------
-- | If file exists, read contents of file into a new buffer, otherwise
-- creating a new empty buffer. Replace the current window with a new
-- window onto the new buffer.
--
-- Need to clean up semantics for when buffers exist, and how to attach
-- windows to buffers.
--
fnewE :: FilePath -> YiM ()
fnewE f = do
bufs <- withEditor getBuffers
-- The file names associated with the list of current buffers
let bufsWithThisFilename = filter ((== Just f) . file) bufs
-- The names of the existing buffers
currentBufferNames = map name bufs
-- The new name for the buffer
bufferName = bestNewName currentBufferNames
b <- case bufsWithThisFilename of
[] -> do
fe <- lift $ doesFileExist f
de <- lift $ doesDirectoryExist f
newBufferForPath bufferName fe de
_ -> return (bkey $ head bufsWithThisFilename)
withGivenBuffer b $ setfileB f -- associate buffer with file
withGivenBuffer b $ setSyntaxB (highlighters M.! (syntaxFromExtension $ takeExtension f))
withEditor $ switchToBufferE b
where
-- The first argument is the buffer name the second argument is
-- whether or not the file currently exists and the third argument
-- is whether or not the file is a directory that exists.
newBufferForPath :: String -> Bool -> Bool -> YiM BufferRef
newBufferForPath bufferName True _ =
fileToNewBuffer bufferName f -- Load the file into a new buffer
newBufferForPath _bufferName False True = diredDirBuffer f
newBufferForPath bufferName False False =
withEditor $ stringToNewBuffer bufferName [] -- Create new empty buffer
{-
Working out the name of the syntax from the extension of
the file. Some of these are a little questionably haskell
relatex. For example ".x" is an alex lexer specification
I dare say that there are other file types that use ".x"
as the file extension.
For now though this is probably okay given the users of
'yi' are mostly haskell hackers, as of yet.
-}
syntaxFromExtension :: String -> String
syntaxFromExtension ".hs" = "haskell"
syntaxFromExtension ".x" = "haskell"
syntaxFromExtension ".lhs" = "lithaskell"
-- haskell include files such as Yi/Syntax/alex.hsinc
syntaxFromExtension ".hsinc" = "haskell"
syntaxFromExtension ".cabal" = "cabal"
syntaxFromExtension ".tex" = "latex"
syntaxFromExtension ".sty" = "latex"
syntaxFromExtension ".cxx" = "cplusplus"
syntaxFromExtension ".cpp" = "cplusplus"
syntaxFromExtension ".h" = "cplusplus"
-- I treat c file as cpp files, most users are smart enough
-- to allow for that.
syntaxFromExtension ".c" = "cplusplus"
-- pepa is a subset of srmc
syntaxFromExtension ".pepa" = "srmc"
syntaxFromExtension ".srmc" = "srmc"
syntaxFromExtension _ = "none"
-- The first argument is the buffer name
fileToNewBuffer :: String -> FilePath -> YiM BufferRef
fileToNewBuffer bufferName path = do
contents <- liftIO $ readFile path
withEditor $ stringToNewBuffer bufferName contents
-- Given the desired buffer name, plus a list of current buffer
-- names returns the best name for the new buffer. This will
-- be the desired one in the case that it doesn't currently exist.
-- Otherwise we will suffix it with <n> where n is one more than the
-- current number of suffixed similar names.
-- IOW if we want "file.hs" but one already exists then we'll create
-- "file.hs<1>" but if that already exists then we'll create "file.hs<2>"
-- and so on.
desiredBufferName = takeFileName f
bestNewName :: [ String ] -> String
bestNewName currentBufferNames
| elem desiredBufferName currentBufferNames = addSuffixBName 1
| otherwise = desiredBufferName
where
addSuffixBName :: Int -> String
addSuffixBName i
| elem possibleName currentBufferNames = addSuffixBName (i + 1)
| otherwise = possibleName
where
possibleName = concat [ desiredBufferName
, "<"
, show i
, ">"
]
------------------------------------------------
data DiredFileInfo = DiredFileInfo { permString :: String
, numLinks :: Integer
, owner :: String
, grp :: String
, sizeInBytes :: Integer
, modificationTimeString :: String
}
deriving (Show, Eq, Typeable)
data DiredEntry = DiredFile DiredFileInfo
| DiredDir DiredFileInfo
| DiredSymLink DiredFileInfo String
| DiredSocket DiredFileInfo
| DiredBlockDevice DiredFileInfo
| DiredCharacterDevice DiredFileInfo
| DiredNamedPipe DiredFileInfo
| DiredNoInfo
deriving (Show, Eq, Typeable)
data DiredState = DiredState
{ diredPath :: FilePath -- ^ The full path to the directory being viewed
-- FIXME Choose better data structure for Marks...
, diredMarks :: M.Map Char [FilePath] -- ^ Map values are just leafnames, not full paths
, diredEntries :: M.Map FilePath DiredEntry -- ^ keys are just leafnames, not full paths
, diredFilePoints :: [(Point,Point,FilePath)] -- ^ position in the buffer where filename is
}
deriving (Show, Eq, Typeable)
instance Initializable DiredState where
initial = DiredState { diredPath = ""
, diredMarks = M.empty
, diredEntries = M.empty
, diredFilePoints = []
}
diredKeymap :: Keymap -> Keymap
diredKeymap = do
(rebind [
("p", write $ lineUp),
("n", write $ lineDown),
("b", write $ leftB),
("f", write $ rightB),
("m", write $ diredMark),
("d", write $ diredMarkDel),
("g", write $ diredRefresh),
("^", write $ diredUpDir),
("+", write $ diredCreateDir),
("RET", write $ diredLoad),
("SPC", write $ lineDown),
("BACKSP", write $ diredUnmark)
])
dired :: YiM ()
dired = do
msgEditor "Dired..."
dir <- liftIO getCurrentDirectory
fnewE dir
diredDir :: FilePath -> YiM ()
diredDir dir = diredDirBuffer dir >> return ()
diredDirBuffer :: FilePath -> YiM BufferRef
diredDirBuffer dir = do
b <- withEditor $ stringToNewBuffer ("dired-"++dir) ""
withGivenBuffer b (setfileB dir) -- associate the buffer with the dir
withEditor $ switchToBufferE b
diredLoadNewDir dir
setBufferKeymap b diredKeymap
return b
diredRefresh :: YiM ()
diredRefresh = do
-- Clear buffer
withBuffer $ do end <- sizeB
deleteRegionB (mkRegion 0 end)
-- Write Header
Just dir <- withBuffer getfileB
withBuffer $ insertN $ dir ++ ":\n"
p <- withBuffer pointB
withBuffer $ (addOverlayB 0 (p-2) headStyle)
-- Scan directory
di <- lift $ diredScanDir dir
let ds = DiredState { diredPath = dir
, diredMarks = M.empty
, diredEntries = di
, diredFilePoints = []
}
withBuffer $ setDynamicB ds
-- Display results
dlines <- linesToDisplay
let (strss, stys, strs) = unzip3 dlines
strss' = transpose $ map doPadding $ transpose $ strss
ptsList <- mapM insertDiredLine $ zip3 strss' stys strs
withBuffer $ do setDynamicB ds{diredFilePoints=ptsList}
moveTo p
return ()
where
headStyle = Style grey defaultbg
doPadding :: [DRStrings] -> [String]
doPadding drs = map (pad ((maximum . map drlength) drs)) drs
pad _n (DRPerms s) = s
pad n (DRLinks s) = (replicate (max 0 (n - length s)) ' ') ++ s
pad n (DROwners s) = s ++ (replicate (max 0 (n - length s)) ' ') ++ " "
pad n (DRGroups s) = s ++ (replicate (max 0 (n - length s)) ' ')
pad n (DRSizes s) = (replicate (max 0 (n - length s)) ' ') ++ s
pad n (DRDates s) = (replicate (max 0 (n - length s)) ' ') ++ s
pad _n (DRFiles s) = s -- Don't right-justify the filename
drlength = length . undrs
-- | Returns a tuple containing the textual region (the end of) which is used for 'click' detection
-- and the FilePath of the file represented by that textual region
insertDiredLine :: ([String], Style, String) -> YiM (Point, Point, FilePath)
insertDiredLine (fields, sty, filenm) = do
withBuffer $ insertN $ (concat $ intersperse " " fields) ++ "\n"
p <- withBuffer pointB
let p1 = p - length (last fields) - 1
p2 = p - 1
when (sty /= defaultStyle) $ withBuffer (addOverlayB p1 p2 sty)
return (p1, p2, filenm)
data DRStrings = DRPerms {undrs :: String}
| DRLinks {undrs :: String}
| DROwners {undrs :: String}
| DRGroups {undrs :: String}
| DRSizes {undrs :: String}
| DRDates {undrs :: String}
| DRFiles {undrs :: String}
-- | Return a List of (prefix, fullDisplayNameIncludingSourceAndDestOfLink, style, filename)
linesToDisplay :: YiM ([([DRStrings], Style, String)])
linesToDisplay = do
dState <- withBuffer getDynamicB
return $ map (uncurry lineToDisplay) (M.assocs $ diredEntries dState)
where
lineToDisplay k (DiredFile v) = (l " -" v ++ [DRFiles k], defaultStyle, k)
lineToDisplay k (DiredDir v) = (l " d" v ++ [DRFiles k], Style blue defaultbg, k)
lineToDisplay k (DiredSymLink v s) = (l " l" v ++ [DRFiles $ k ++ " -> " ++ s], Style cyan defaultbg, k)
lineToDisplay k (DiredSocket v) = (l " s" v ++ [DRFiles $ k], Style magenta defaultbg, k)
lineToDisplay k (DiredCharacterDevice v) = (l " c" v ++ [DRFiles $ k], Style yellow defaultbg, k)
lineToDisplay k (DiredBlockDevice v) = (l " b" v ++ [DRFiles $ k], Style yellow defaultbg, k)
lineToDisplay k (DiredNamedPipe v) = (l " p" v ++ [DRFiles $ k], Style brown defaultbg, k)
lineToDisplay k DiredNoInfo = ([DRFiles $ k ++ " : Not a file/dir/symlink"], defaultStyle, k)
l pre v = [DRPerms $ pre ++ permString v,
DRLinks $ printf "%4d" (numLinks v),
DROwners $ owner v,
DRGroups $ grp v,
DRSizes $ printf "%8d" (sizeInBytes v),
DRDates $ modificationTimeString v]
-- | Write the contents of the supplied directory into the current buffer in dired format
diredLoadNewDir :: FilePath -> YiM ()
diredLoadNewDir _dir = do
withBuffer $ setSyntaxB (ExtHL (Nothing :: Maybe (Highlighter ()))) -- Colours for Dired come from overlays not syntax highlighting
diredRefresh
-- | Return dired entries for the contents of the supplied directory
diredScanDir :: FilePath -> IO (M.Map FilePath DiredEntry)
diredScanDir dir = do
files <- getDirectoryContents dir
let filteredFiles = filter (not . diredOmitFile) files
foldM (lineForFile dir) M.empty filteredFiles
where
lineForFile :: String -> M.Map FilePath DiredEntry -> String -> IO (M.Map FilePath DiredEntry)
lineForFile d m f = do
let fp = (d </> f)
fileStatus <- getSymbolicLinkStatus fp
dfi <- lineForFilePath fp fileStatus
let islink = isSymbolicLink fileStatus
linkTarget <- if islink then readSymbolicLink fp else return ""
let de = if (isDirectory fileStatus) then (DiredDir dfi) else
if (isRegularFile fileStatus) then (DiredFile dfi) else
if islink then (DiredSymLink dfi linkTarget) else
if (isSocket fileStatus) then (DiredSocket dfi) else
if (isCharacterDevice fileStatus) then (DiredCharacterDevice dfi) else
if (isBlockDevice fileStatus) then (DiredBlockDevice dfi) else
if (isNamedPipe fileStatus) then (DiredNamedPipe dfi) else DiredNoInfo
return (M.insert f de m)
lineForFilePath :: FilePath -> FileStatus -> IO DiredFileInfo
lineForFilePath fp fileStatus = do
modTimeStr <- return . shortCalendarTimeToString =<< toCalendarTime (TOD (floor $ toRational $ modificationTime fileStatus) 0)
let uid = fileOwner fileStatus
gid = fileGroup fileStatus
_filenm <- if (isSymbolicLink fileStatus) then
return . ((++) (takeFileName fp ++ " -> ")) =<< readSymbolicLink fp else
return $ takeFileName fp
ownerEntry <- catch (getUserEntryForID uid) (\_ -> getAllUserEntries >>= return . scanForUid uid)
groupEntry <- catch (getGroupEntryForID gid) (\_ -> getAllGroupEntries >>= return . scanForGid gid)
let fmodeStr = (modeString . fileMode) fileStatus
sz = toInteger $ fileSize fileStatus
ownerStr = userName ownerEntry
groupStr = groupName groupEntry
numOfLinks = toInteger $ linkCount fileStatus
return $ DiredFileInfo { permString = fmodeStr
, numLinks = numOfLinks
, owner = ownerStr
, grp = groupStr
, sizeInBytes = sz
, modificationTimeString = modTimeStr}
shortCalendarTimeToString :: CalendarTime -> String
shortCalendarTimeToString = formatCalendarTime defaultTimeLocale "%b %d %H:%M"
-- | Needed on Mac OS X 10.4
scanForUid :: UserID -> [UserEntry] -> UserEntry
scanForUid uid entries = maybe (UserEntry "?" "" uid 0 "" "" "") id (find ((== uid) . userID) entries)
-- | Needed on Mac OS X 10.4
scanForGid :: GroupID -> [GroupEntry] -> GroupEntry
scanForGid gid entries = maybe (GroupEntry "?" "" gid []) id (find ((== gid) . groupID) entries)
modeString :: FileMode -> String
modeString fm = ""
++ strIfSet "r" ownerReadMode
++ strIfSet "w" ownerWriteMode
++ strIfSet "x" ownerExecuteMode
++ strIfSet "r" groupReadMode
++ strIfSet "w" groupWriteMode
++ strIfSet "x" groupExecuteMode
++ strIfSet "r" otherReadMode
++ strIfSet "w" otherWriteMode
++ strIfSet "x" otherExecuteMode
where
strIfSet s mode = if fm == (fm `unionFileModes` mode) then s else "-"
-- Default Filter: omit files ending in '~' or '#' and also '.' and '..'.
diredOmitFile :: String -> Bool
diredOmitFile = (=~".*~$|.*#$|^\\.$|^\\..$")
diredMark :: BufferM ()
diredMark = diredMarkWithChar '*' lineDown
diredMarkDel :: BufferM ()
diredMarkDel = diredMarkWithChar 'D' lineDown
diredMarkWithChar :: Char -> BufferM () -> BufferM ()
diredMarkWithChar c mv = do
p <- pointB
moveToSol >> insertN [c] >> deleteN 1
moveTo p
mv
diredUnmark :: BufferM ()
diredUnmark = diredMarkWithChar ' ' lineUp
diredLoad :: YiM ()
diredLoad = do
(Just dir) <- withBuffer getfileB
(fn, de) <- fileFromPoint
let sel = dir </> fn
case de of
(DiredFile _dfi) -> do
exists <- liftIO $ doesFileExist sel
if exists then fnewE sel else msgEditor $ sel ++ " no longer exists"
(DiredDir _dfi) -> do
exists <- liftIO $ doesDirectoryExist sel
if exists then diredDir sel else msgEditor $ sel ++ " no longer exists"
(DiredSymLink _dfi dest) -> do
let target = if isAbsolute dest then dest else dir </> dest
existsFile <- liftIO $ doesFileExist target
existsDir <- liftIO $ doesDirectoryExist target
msgEditor $ "Following link:"++target
if existsFile then fnewE target else
if existsDir then diredDir target else
msgEditor $ target ++ " does not exist"
(DiredSocket _dfi) -> do
exists <- liftIO $ doesFileExist sel
if exists then msgEditor ("Can't open Socket " ++ sel) else msgEditor $ sel ++ " no longer exists"
(DiredBlockDevice _dfi) -> do
exists <- liftIO $ doesFileExist sel
if exists then msgEditor ("Can't open Block Device " ++ sel) else msgEditor $ sel ++ " no longer exists"
(DiredCharacterDevice _dfi) -> do
exists <- liftIO $ doesFileExist sel
if exists then msgEditor ("Can't open Character Device " ++ sel) else msgEditor $ sel ++ " no longer exists"
(DiredNamedPipe _dfi) -> do
exists <- liftIO $ doesFileExist sel
if exists then msgEditor ("Can't open Pipe " ++ sel) else msgEditor $ sel ++ " no longer exists"
DiredNoInfo -> msgEditor $ "No File Info for:"++sel
-- | Extract the filename at point. NB this may fail if the buffer has been edited. Maybe use Markers instead.
fileFromPoint :: YiM (FilePath, DiredEntry)
fileFromPoint = do
p <- withBuffer pointB
dState <- withBuffer getDynamicB
let (_,_,f) = head $ filter (\(_,p2,_)->p<=p2) (diredFilePoints dState)
return (f, M.findWithDefault DiredNoInfo f $ diredEntries dState)
diredUpDir :: YiM ()
diredUpDir = do
(Just dir) <- withBuffer getfileB
diredDir $ takeDirectory dir
diredCreateDir :: YiM ()
diredCreateDir = do
withMinibuffer "Create Dir:" return $ \nm -> do
(Just dir) <- withBuffer getfileB
let newdir = dir </> nm
msgEditor $ "Creating "++newdir++"..."
liftIO $ createDirectoryIfMissing True newdir
diredRefresh