utils/ghc-pkg/Main.hs

   1 {-# OPTIONS -fglasgow-exts #-}
   2 -----------------------------------------------------------------------------
   3 --
   4 -- (c) The University of Glasgow 2004.
   5 --
   6 -- Package management tool
   7 --
   8 -----------------------------------------------------------------------------
   9
  10 -- TODO:
  11 --      - validate modules
  12 --      - expanding of variables in new-style package conf
  13 --      - version manipulation (checking whether old version exists,
  14 --        hiding old version?)
  15
  16 module Main (main) where
  17
  18 import Version  ( version, targetOS, targetARCH )
  19 import Distribution.InstalledPackageInfo
  20 import Distribution.Compat.ReadP
  21 import Distribution.ParseUtils  ( showError )
  22 import Distribution.Package
  23 import Distribution.Version
  24 import Compat.Directory         ( getAppUserDataDirectory, createDirectoryIfMissing )
  25 import Compat.RawSystem         ( rawSystem )
  26
  27 import Prelude
  28
  29 #include "../../includes/ghcconfig.h"
  30
  31 #if __GLASGOW_HASKELL__ >= 504
  32 import System.Console.GetOpt
  33 import Text.PrettyPrint
  34 import qualified Control.Exception as Exception
  35 import Data.Maybe
  36 #else
  37 import GetOpt
  38 import Pretty
  39 import qualified Exception
  40 import Maybe
  41 #endif
  42
  43 import Data.Char        ( isSpace )
  44 import Monad
  45 import Directory
  46 import System   ( getArgs, getProgName, getEnv,
  47                   exitWith, ExitCode(..)
  48                 )
  49 import System.IO
  50 #if __GLASGOW_HASKELL__ >= 600
  51 import System.IO.Error (try)
  52 #else
  53 import System.IO (try)
  54 #endif
  55 import Data.List ( isPrefixOf, isSuffixOf, intersperse, sortBy )
  56
  57 #ifdef mingw32_HOST_OS
  58 import Foreign
  59
  60 #if __GLASGOW_HASKELL__ >= 504
  61 import Foreign.C.String
  62 #else
  63 import CString
  64 #endif
  65 #endif
  66
  67 import IO ( isPermissionError, isDoesNotExistError )
  68
  69 -- -----------------------------------------------------------------------------
  70 -- Entry point
  71
  72 main :: IO ()
  73 main = do
  74   args <- getArgs
  75
  76   case getOpt Permute flags args of
  77         (cli,_,[]) | FlagHelp `elem` cli -> do
  78            prog <- getProgramName
  79            bye (usageInfo (usageHeader prog) flags)
  80         (cli,_,[]) | FlagVersion `elem` cli ->
  81            bye ourCopyright
  82         (cli,nonopts,[]) ->
  83            runit cli nonopts
  84         (_,_,errors) -> tryOldCmdLine errors args
  85
  86 -- If the new command-line syntax fails, then we try the old.  If that
  87 -- fails too, then we output the original errors and the new syntax
  88 -- (so the old syntax is still available, but hidden).
  89 tryOldCmdLine :: [String] -> [String] -> IO ()
  90 tryOldCmdLine errors args = do
  91   case getOpt Permute oldFlags args of
  92         (cli@(_:_),[],[]) ->
  93            oldRunit cli
  94         _failed -> do
  95            prog <- getProgramName
  96            die (concat errors ++ usageInfo (usageHeader prog) flags)
  97
  98 -- -----------------------------------------------------------------------------
  99 -- Command-line syntax
 100
 101 data Flag
 102   = FlagUser
 103   | FlagGlobal
 104   | FlagHelp
 105   | FlagVersion
 106   | FlagConfig  FilePath
 107   | FlagGlobalConfig FilePath
 108   | FlagForce
 109   | FlagForceFiles
 110   | FlagAutoGHCiLibs
 111   | FlagDefinedName String String
 112   | FlagSimpleOutput
 113   deriving Eq
 114
 115 flags :: [OptDescr Flag]
 116 flags = [
 117   Option [] ["user"] (NoArg FlagUser)
 118         "use the current user's package database",
 119   Option [] ["global"] (NoArg FlagGlobal)
 120         "(default) use the global package database",
 121   Option ['f'] ["package-conf"] (ReqArg FlagConfig "FILE")
 122         "act upon specified package config file (only)",
 123   Option [] ["global-conf"] (ReqArg FlagGlobalConfig "FILE")
 124         "location of the global package config",
 125   Option [] ["force"] (NoArg FlagForce)
 126         "ignore missing dependencies, directories, and libraries",
 127   Option [] ["force-files"] (NoArg FlagForceFiles)
 128         "ignore missing directories and libraries only",
 129   Option ['g'] ["auto-ghci-libs"] (NoArg FlagAutoGHCiLibs)
 130         "automatically build libs for GHCi (with register)",
 131   Option ['?'] ["help"] (NoArg FlagHelp)
 132         "display this help and exit",
 133   Option ['D'] ["define-name"] (ReqArg toDefined "NAME=VALUE")
 134         "define NAME as VALUE",
 135   Option ['V'] ["version"] (NoArg FlagVersion)
 136         "output version information and exit",
 137   Option [] ["simple-output"] (NoArg FlagSimpleOutput)
 138         "print output in easy-to-parse format for some commands"
 139   ]
 140  where
 141   toDefined str =
 142     case break (=='=') str of
 143       (nm,[])    -> FlagDefinedName nm []
 144       (nm,_:val) -> FlagDefinedName nm val
 145
 146 ourCopyright :: String
 147 ourCopyright = "GHC package manager version " ++ version ++ "\n"
 148
 149 usageHeader :: String -> String
 150 usageHeader prog = substProg prog $
 151   "Usage:\n" ++
 152   "  $p register {filename | -}\n" ++
 153   "    Register the package using the specified installed package\n" ++
 154   "    description. The syntax for the latter is given in the $p\n" ++
 155   "    documentation.\n" ++
 156   "\n" ++
 157   "  $p update {filename | -}\n" ++
 158   "    Register the package, overwriting any other package with the\n" ++
 159   "    same name.\n" ++
 160   "\n" ++
 161   "  $p unregister {pkg-id}\n" ++
 162   "    Unregister the specified package.\n" ++
 163   "\n" ++
 164   "  $p expose {pkg-id}\n" ++
 165   "    Expose the specified package.\n" ++
 166   "\n" ++
 167   "  $p hide {pkg-id}\n" ++
 168   "    Hide the specified package.\n" ++
 169   "\n" ++
 170   "  $p list [pkg]\n" ++
 171   "    List registered packages in the global database, and also the\n" ++
 172   "    user database if --user is given. If a package name is given\n" ++
 173   "    all the registered versions will be listed in ascending order.\n" ++
 174   "    Accepts the --simple-output flag.\n" ++
 175   "\n" ++
 176   "  $p latest pkg\n" ++
 177   "    Prints the highest registered version of a package.\n" ++
 178   "\n" ++
 179   "  $p check\n" ++
 180   "    Check the consistency of package depenencies and list broken packages.\n" ++
 181   "    Accepts the --simple-output flag.\n" ++
 182   "\n" ++
 183   "  $p describe {pkg-id}\n" ++
 184   "    Give the registered description for the specified package. The\n" ++
 185   "    description is returned in precisely the syntax required by $p\n" ++
 186   "    register.\n" ++
 187   "\n" ++
 188   "  $p field {pkg-id} {field}\n" ++
 189   "    Extract the specified field of the package description for the\n" ++
 190   "    specified package.\n" ++
 191   "\n" ++
 192   " The following optional flags are also accepted:\n"
 193
 194 substProg :: String -> String -> String
 195 substProg _ [] = []
 196 substProg prog ('$':'p':xs) = prog ++ substProg prog xs
 197 substProg prog (c:xs) = c : substProg prog xs
 198
 199 -- -----------------------------------------------------------------------------
 200 -- Do the business
 201
 202 data Force = ForceAll | ForceFiles | NoForce
 203
 204 runit :: [Flag] -> [String] -> IO ()
 205 runit cli nonopts = do
 206   prog <- getProgramName
 207   let
 208         force
 209           | FlagForce `elem` cli        = ForceAll
 210           | FlagForceFiles `elem` cli   = ForceFiles
 211           | otherwise                   = NoForce
 212         auto_ghci_libs = FlagAutoGHCiLibs `elem` cli
 213         defines = [ (nm,val) | FlagDefinedName nm val <- cli ]
 214   --
 215   -- first, parse the command
 216   case nonopts of
 217     ["register", filename] ->
 218         registerPackage filename defines cli auto_ghci_libs False force
 219     ["update", filename] ->
 220         registerPackage filename defines cli auto_ghci_libs True force
 221     ["unregister", pkgid_str] -> do
 222         pkgid <- readGlobPkgId pkgid_str
 223         unregisterPackage pkgid cli
 224     ["expose", pkgid_str] -> do
 225         pkgid <- readGlobPkgId pkgid_str
 226         exposePackage pkgid cli
 227     ["hide",   pkgid_str] -> do
 228         pkgid <- readGlobPkgId pkgid_str
 229         hidePackage pkgid cli
 230     ["list"] -> do
 231         listPackages cli Nothing
 232     ["list", pkgid_str] -> do
 233         pkgid <- readGlobPkgId pkgid_str
 234         listPackages cli (Just pkgid)
 235     ["latest", pkgid_str] -> do
 236         pkgid <- readGlobPkgId pkgid_str
 237         latestPackage cli pkgid
 238     ["describe", pkgid_str] -> do
 239         pkgid <- readGlobPkgId pkgid_str
 240         describePackage cli pkgid
 241     ["field", pkgid_str, field] -> do
 242         pkgid <- readGlobPkgId pkgid_str
 243         describeField cli pkgid field
 244     ["check"] -> do
 245         checkConsistency cli
 246     [] -> do
 247         die ("missing command\n" ++
 248                 usageInfo (usageHeader prog) flags)
 249     (_cmd:_) -> do
 250         die ("command-line syntax error\n" ++
 251                 usageInfo (usageHeader prog) flags)
 252
 253 parseCheck :: ReadP a a -> String -> String -> IO a
 254 parseCheck parser str what =
 255   case [ x | (x,ys) <- readP_to_S parser str, all isSpace ys ] of
 256     [x] -> return x
 257     _ -> die ("cannot parse \'" ++ str ++ "\' as a " ++ what)
 258
 259 readPkgId :: String -> IO PackageIdentifier
 260 readPkgId str = parseCheck parsePackageId str "package identifier"
 261
 262 readGlobPkgId :: String -> IO PackageIdentifier
 263 readGlobPkgId str = parseCheck parseGlobPackageId str "package identifier"
 264
 265 parseGlobPackageId :: ReadP r PackageIdentifier
 266 parseGlobPackageId =
 267   parsePackageId
 268      +++
 269   (do n <- parsePackageName; string "-*"
 270       return (PackageIdentifier{ pkgName = n, pkgVersion = globVersion }))
 271
 272 -- globVersion means "all versions"
 273 globVersion :: Version
 274 globVersion = Version{ versionBranch=[], versionTags=["*"] }
 275
 276 -- -----------------------------------------------------------------------------
 277 -- Package databases
 278
 279 -- Some commands operate on a single database:
 280 --      register, unregister, expose, hide
 281 -- however these commands also check the union of the available databases
 282 -- in order to check consistency.  For example, register will check that
 283 -- dependencies exist before registering a package.
 284 --
 285 -- Some commands operate  on multiple databases, with overlapping semantics:
 286 --      list, describe, field
 287
 288 type PackageDBName  = FilePath
 289 type PackageDB      = [InstalledPackageInfo]
 290
 291 type PackageDBStack = [(PackageDBName,PackageDB)]
 292         -- A stack of package databases.  Convention: head is the topmost
 293         -- in the stack.  Earlier entries override later one.
 294
 295 getPkgDatabases :: Bool -> [Flag] -> IO PackageDBStack
 296 getPkgDatabases modify flags = do
 297   -- first we determine the location of the global package config.  On Windows,
 298   -- this is found relative to the ghc-pkg.exe binary, whereas on Unix the
 299   -- location is passed to the binary using the --global-config flag by the
 300   -- wrapper script.
 301   let err_msg = "missing --global-conf option, location of global package.conf unknown\n"
 302   global_conf <-
 303      case [ f | FlagGlobalConfig f <- flags ] of
 304         [] -> do mb_dir <- getExecDir "/bin/ghc-pkg.exe"
 305                  case mb_dir of
 306                         Nothing  -> die err_msg
 307                         Just dir -> return (dir `joinFileName` "package.conf")
 308         fs -> return (last fs)
 309
 310   let global_conf_dir = global_conf ++ ".d"
 311   global_conf_dir_exists <- doesDirectoryExist global_conf_dir
 312   global_confs <-
 313     if global_conf_dir_exists
 314       then do files <- getDirectoryContents global_conf_dir
 315               return [ global_conf_dir ++ '/' : file
 316                      | file <- files
 317                      , isSuffixOf ".conf" file]
 318       else return []
 319
 320   -- get the location of the user package database, and create it if necessary
 321   appdir <- getAppUserDataDirectory "ghc"
 322
 323   let
 324         subdir = targetARCH ++ '-':targetOS ++ '-':version
 325         archdir   = appdir `joinFileName` subdir
 326         user_conf = archdir `joinFileName` "package.conf"
 327   user_exists <- doesFileExist user_conf
 328
 329   -- If the user database doesn't exist, and this command isn't a
 330   -- "modify" command, then we won't attempt to create or use it.
 331   let sys_databases
 332         | modify || user_exists = user_conf : global_confs ++ [global_conf]
 333         | otherwise             = global_confs ++ [global_conf]
 334
 335   e_pkg_path <- try (getEnv "GHC_PACKAGE_PATH")
 336   let env_stack =
 337         case e_pkg_path of
 338                 Left  _ -> sys_databases
 339                 Right path
 340                   | last cs == ""  -> init cs ++ sys_databases
 341                   | otherwise      -> cs
 342                   where cs = parseSearchPath path
 343
 344         -- The "global" database is always the one at the bottom of the stack.
 345         -- This is the database we modify by default.
 346       virt_global_conf = last env_stack
 347
 348   -- -f flags on the command line add to the database stack, unless any
 349   -- of them are present in the stack already.
 350   let flag_stack = filter (`notElem` env_stack)
 351                         [ f | FlagConfig f <- reverse flags ] ++ env_stack
 352
 353   -- Now we have the full stack of databases.  Next, if the current
 354   -- command is a "modify" type command, then we truncate the stack
 355   -- so that the topmost element is the database being modified.
 356   final_stack <-
 357      if not modify
 358         then return flag_stack
 359         else let
 360                 go (FlagUser : fs)     = modifying user_conf
 361                 go (FlagGlobal : fs)   = modifying virt_global_conf
 362                 go (FlagConfig f : fs) = modifying f
 363                 go (_ : fs)            = go fs
 364                 go []                  = modifying virt_global_conf
 365
 366                 modifying f
 367                   | f `elem` flag_stack = return (dropWhile (/= f) flag_stack)
 368                   | otherwise           = die ("requesting modification of database:\n\t" ++ f ++ "\n\twhich is not in the database stack.")
 369              in
 370                 go flags
 371
 372   db_stack <- mapM readParseDatabase final_stack
 373   return db_stack
 374
 375 readParseDatabase :: PackageDBName -> IO (PackageDBName,PackageDB)
 376 readParseDatabase filename = do
 377   str <- readFile filename `Exception.catch` \_ -> return emptyPackageConfig
 378   let packages = read str
 379   Exception.evaluate packages
 380     `Exception.catch` \_ ->
 381         die (filename ++ ": parse error in package config file")
 382   return (filename,packages)
 383
 384 emptyPackageConfig :: String
 385 emptyPackageConfig = "[]"
 386
 387 -- -----------------------------------------------------------------------------
 388 -- Registering
 389
 390 registerPackage :: FilePath
 391                 -> [(String,String)] -- defines
 392                 -> [Flag]
 393                 -> Bool         -- auto_ghci_libs
 394                 -> Bool         -- update
 395                 -> Force
 396                 -> IO ()
 397 registerPackage input defines flags auto_ghci_libs update force = do
 398   db_stack <- getPkgDatabases True flags
 399   let
 400         db_to_operate_on = my_head "db" db_stack
 401         db_filename      = fst db_to_operate_on
 402   --
 403
 404   s <-
 405     case input of
 406       "-" -> do
 407         putStr "Reading package info from stdin ... "
 408         getContents
 409       f   -> do
 410         putStr ("Reading package info from " ++ show f ++ " ... ")
 411         readFile f
 412
 413   expanded <- expandEnvVars s defines force
 414
 415   pkg0 <- parsePackageInfo expanded defines
 416   putStrLn "done."
 417
 418   let pkg = resolveDeps db_stack pkg0
 419   validatePackageConfig pkg db_stack auto_ghci_libs update force
 420   let new_details = filter not_this (snd db_to_operate_on) ++ [pkg]
 421       not_this p = package p /= package pkg
 422   savingOldConfig db_filename $
 423     writeNewConfig db_filename new_details
 424
 425 parsePackageInfo
 426         :: String
 427         -> [(String,String)]
 428         -> IO InstalledPackageInfo
 429 parsePackageInfo str defines =
 430   case parseInstalledPackageInfo str of
 431     ParseOk _warns ok -> return ok
 432     ParseFailed err -> die (showError err)
 433
 434 -- -----------------------------------------------------------------------------
 435 -- Exposing, Hiding, Unregistering are all similar
 436
 437 exposePackage :: PackageIdentifier ->  [Flag] -> IO ()
 438 exposePackage = modifyPackage (\p -> [p{exposed=True}])
 439
 440 hidePackage :: PackageIdentifier ->  [Flag] -> IO ()
 441 hidePackage = modifyPackage (\p -> [p{exposed=False}])
 442
 443 unregisterPackage :: PackageIdentifier ->  [Flag] -> IO ()
 444 unregisterPackage = modifyPackage (\p -> [])
 445
 446 modifyPackage
 447   :: (InstalledPackageInfo -> [InstalledPackageInfo])
 448   -> PackageIdentifier
 449   -> [Flag]
 450   -> IO ()
 451 modifyPackage fn pkgid flags  = do
 452   db_stack <- getPkgDatabases True{-modify-} flags
 453   let ((db_name, pkgs) : _) = db_stack
 454   ps <- findPackages [(db_name,pkgs)] pkgid
 455   let pids = map package ps
 456   let new_config = concat (map modify pkgs)
 457       modify pkg
 458           | package pkg `elem` pids = fn pkg
 459           | otherwise               = [pkg]
 460   savingOldConfig db_name $
 461       writeNewConfig db_name new_config
 462
 463 -- -----------------------------------------------------------------------------
 464 -- Listing packages
 465
 466 listPackages ::  [Flag] -> Maybe PackageIdentifier -> IO ()
 467 listPackages flags mPackageName = do
 468   let simple_output = FlagSimpleOutput `elem` flags
 469   db_stack <- getPkgDatabases False flags
 470   let db_stack_filtered -- if a package is given, filter out all other packages
 471         | Just this <- mPackageName =
 472             map (\(conf,pkgs) -> (conf, filter (this `matchesPkg`) pkgs))
 473                 db_stack
 474         | otherwise = db_stack
 475
 476       db_stack_sorted
 477           = [ (db, sort_pkgs pkgs) | (db,pkgs) <- db_stack_filtered ]
 478           where sort_pkgs = sortBy cmpPkgIds
 479                 cmpPkgIds pkg1 pkg2 =
 480                    case pkgName p1 `compare` pkgName p2 of
 481                         LT -> LT
 482                         GT -> GT
 483                         EQ -> pkgVersion p1 `compare` pkgVersion p2
 484                    where (p1,p2) = (package pkg1, package pkg2)
 485
 486       pkg_map = map (\p -> (package p, p)) $ concatMap snd db_stack
 487       show_func = if simple_output then show_simple else mapM_ (show_normal pkg_map)
 488
 489   show_func (reverse db_stack_sorted)
 490
 491   where show_normal pkg_map (db_name,pkg_confs) =
 492           hPutStrLn stdout (render $
 493                 text db_name <> colon $$ nest 4 packages
 494                 )
 495            where packages = fsep (punctuate comma (map pp_pkg pkg_confs))
 496                  pp_pkg p
 497                    | isBrokenPackage p pkg_map = braces doc
 498                    | exposed p = doc
 499                    | otherwise = parens doc
 500                    where doc = text (showPackageId (package p))
 501
 502         show_simple db_stack = do
 503           let pkgs = map showPackageId $ sortBy compPkgIdVer $
 504                           map package (concatMap snd db_stack)
 505           when (null pkgs) $ die "no matches"
 506           hPutStrLn stdout $ concat $ intersperse " " pkgs
 507
 508 -- -----------------------------------------------------------------------------
 509 -- Prints the highest (hidden or exposed) version of a package
 510
 511 latestPackage ::  [Flag] -> PackageIdentifier -> IO ()
 512 latestPackage flags pkgid = do
 513   db_stack <- getPkgDatabases False flags
 514   ps <- findPackages db_stack pkgid
 515   show_pkg (sortBy compPkgIdVer (map package ps))
 516   where
 517     show_pkg [] = die "no matches"
 518     show_pkg pids = hPutStrLn stdout (showPackageId (last pids))
 519
 520 -- -----------------------------------------------------------------------------
 521 -- Describe
 522
 523 describePackage :: [Flag] -> PackageIdentifier -> IO ()
 524 describePackage flags pkgid = do
 525   db_stack <- getPkgDatabases False flags
 526   ps <- findPackages db_stack pkgid
 527   mapM_ (putStrLn . showInstalledPackageInfo) ps
 528
 529 -- PackageId is can have globVersion for the version
 530 findPackages :: PackageDBStack -> PackageIdentifier -> IO [InstalledPackageInfo]
 531 findPackages db_stack pkgid
 532   = case [ p | p <- all_pkgs, pkgid `matchesPkg` p ] of
 533         []  -> die ("cannot find package " ++ showPackageId pkgid)
 534         ps -> return ps
 535   where
 536         all_pkgs = concat (map snd db_stack)
 537
 538 matches :: PackageIdentifier -> PackageIdentifier -> Bool
 539 pid `matches` pid'
 540   = (pkgName pid == pkgName pid')
 541     && (pkgVersion pid == pkgVersion pid' || not (realVersion pid))
 542
 543 matchesPkg :: PackageIdentifier -> InstalledPackageInfo -> Bool
 544 pid `matchesPkg` pkg = pid `matches` package pkg
 545
 546 compPkgIdVer :: PackageIdentifier -> PackageIdentifier -> Ordering
 547 compPkgIdVer p1 p2 = pkgVersion p1 `compare` pkgVersion p2
 548
 549 -- -----------------------------------------------------------------------------
 550 -- Field
 551
 552 describeField :: [Flag] -> PackageIdentifier -> String -> IO ()
 553 describeField flags pkgid field = do
 554   db_stack <- getPkgDatabases False flags
 555   case toField field of
 556     Nothing -> die ("unknown field: " ++ field)
 557     Just fn -> do
 558         ps <- findPackages db_stack pkgid
 559         let top_dir = getFilenameDir (fst (last db_stack))
 560         mapM_ (putStrLn . fn) (mungePackagePaths top_dir ps)
 561
 562 mungePackagePaths :: String -> [InstalledPackageInfo] -> [InstalledPackageInfo]
 563 -- Replace the string "$topdir" at the beginning of a path
 564 -- with the current topdir (obtained from the -B option).
 565 mungePackagePaths top_dir ps = map munge_pkg ps
 566   where
 567   munge_pkg p = p{ importDirs        = munge_paths (importDirs p),
 568                    includeDirs       = munge_paths (includeDirs p),
 569                    libraryDirs       = munge_paths (libraryDirs p),
 570                    frameworkDirs     = munge_paths (frameworkDirs p),
 571                    haddockInterfaces = munge_paths (haddockInterfaces p),
 572                    haddockHTMLs      = munge_paths (haddockHTMLs p)
 573                  }
 574
 575   munge_paths = map munge_path
 576
 577   munge_path p
 578           | Just p' <- maybePrefixMatch "$topdir" p = top_dir ++ p'
 579           | otherwise                               = p
 580
 581 maybePrefixMatch :: String -> String -> Maybe String
 582 maybePrefixMatch []    rest = Just rest
 583 maybePrefixMatch (_:_) []   = Nothing
 584 maybePrefixMatch (p:pat) (r:rest)
 585   | p == r    = maybePrefixMatch pat rest
 586   | otherwise = Nothing
 587
 588 toField :: String -> Maybe (InstalledPackageInfo -> String)
 589 -- backwards compatibility:
 590 toField "import_dirs"     = Just $ strList . importDirs
 591 toField "source_dirs"     = Just $ strList . importDirs
 592 toField "library_dirs"    = Just $ strList . libraryDirs
 593 toField "hs_libraries"    = Just $ strList . hsLibraries
 594 toField "extra_libraries" = Just $ strList . extraLibraries
 595 toField "include_dirs"    = Just $ strList . includeDirs
 596 toField "c_includes"      = Just $ strList . includes
 597 toField "package_deps"    = Just $ strList . map showPackageId. depends
 598 toField "extra_cc_opts"   = Just $ strList . ccOptions
 599 toField "extra_ld_opts"   = Just $ strList . ldOptions
 600 toField "framework_dirs"  = Just $ strList . frameworkDirs
 601 toField "extra_frameworks"= Just $ strList . frameworks
 602 toField s                 = showInstalledPackageInfoField s
 603
 604 strList :: [String] -> String
 605 strList = show
 606
 607
 608 -- -----------------------------------------------------------------------------
 609 -- Check: Check consistency of installed packages
 610
 611 checkConsistency :: [Flag] -> IO ()
 612 checkConsistency flags = do
 613   db_stack <- getPkgDatabases False flags
 614   let pkgs = map (\p -> (package p, p)) $ concatMap snd db_stack
 615       broken_pkgs = do
 616         (pid, p) <- pkgs
 617         let broken_deps = missingPackageDeps p pkgs
 618         guard (not . null $ broken_deps)
 619         return (pid, broken_deps)
 620   mapM_ (putStrLn . render . show_func) broken_pkgs
 621   where
 622   show_func | FlagSimpleOutput `elem` flags = show_simple
 623             | otherwise = show_normal
 624   show_simple (pid,deps) =
 625     text (showPackageId pid) <> colon
 626       <+> fsep (punctuate comma (map (text . showPackageId) deps))
 627   show_normal (pid,deps) =
 628     text "package" <+> text (showPackageId pid) <+> text "has missing dependencies:"
 629       $$ nest 4 (fsep (punctuate comma (map (text . showPackageId) deps)))
 630
 631 missingPackageDeps :: InstalledPackageInfo
 632                    -> [(PackageIdentifier, InstalledPackageInfo)]
 633                    -> [PackageIdentifier]
 634 missingPackageDeps pkg pkg_map =
 635   [ d | d <- depends pkg, isNothing (lookup d pkg_map)] ++
 636   [ d | d <- depends pkg, Just p <- return (lookup d pkg_map), isBrokenPackage p pkg_map]
 637
 638 isBrokenPackage :: InstalledPackageInfo -> [(PackageIdentifier, InstalledPackageInfo)] -> Bool
 639 isBrokenPackage pkg pkg_map = not . null $ missingPackageDeps pkg pkg_map
 640
 641
 642 -- -----------------------------------------------------------------------------
 643 -- Manipulating package.conf files
 644
 645 writeNewConfig :: FilePath -> [InstalledPackageInfo] -> IO ()
 646 writeNewConfig filename packages = do
 647   hPutStr stdout "Writing new package config file... "
 648   createDirectoryIfMissing True $ getFilenameDir filename
 649   h <- openFile filename WriteMode `catch` \e ->
 650       if isPermissionError e
 651       then die (filename ++ ": you don't have permission to modify this file")
 652       else ioError e
 653   hPutStrLn h (show packages)
 654   hClose h
 655   hPutStrLn stdout "done."
 656
 657 savingOldConfig :: FilePath -> IO () -> IO ()
 658 savingOldConfig filename io = Exception.block $ do
 659   hPutStr stdout "Saving old package config file... "
 660     -- mv rather than cp because we've already done an hGetContents
 661     -- on this file so we won't be able to open it for writing
 662     -- unless we move the old one out of the way...
 663   let oldFile = filename ++ ".old"
 664   restore_on_error <- catch (renameFile filename oldFile >> return True) $
 665       \err -> do
 666           unless (isDoesNotExistError err) $ do
 667               hPutStrLn stderr (unwords ["Unable to rename", show filename,
 668                                          "to", show oldFile])
 669               ioError err
 670           return False
 671   hPutStrLn stdout "done."
 672   io `catch` \e -> do
 673       hPutStrLn stderr (show e)
 674       hPutStr stdout ("\nWARNING: an error was encountered while writing"
 675                    ++ "the new configuration.\n")
 676       when restore_on_error $ do
 677           hPutStr stdout "Attempting to restore the old configuration..."
 678           do renameFile oldFile filename
 679              hPutStrLn stdout "done."
 680            `catch` \err -> hPutStrLn stdout ("Failed: " ++ show err)
 681       ioError e
 682
 683 -----------------------------------------------------------------------------
 684 -- Sanity-check a new package config, and automatically build GHCi libs
 685 -- if requested.
 686
 687 validatePackageConfig :: InstalledPackageInfo
 688                       -> PackageDBStack
 689                       -> Bool   -- auto-ghc-libs
 690                       -> Bool   -- update
 691                       -> Force
 692                       -> IO ()
 693 validatePackageConfig pkg db_stack auto_ghci_libs update force = do
 694   checkPackageId pkg
 695   checkDuplicates db_stack pkg update
 696   mapM_ (checkDep db_stack force) (depends pkg)
 697   mapM_ (checkDir force) (importDirs pkg)
 698   mapM_ (checkDir force) (libraryDirs pkg)
 699   mapM_ (checkDir force) (includeDirs pkg)
 700   mapM_ (checkHSLib (libraryDirs pkg) auto_ghci_libs force) (hsLibraries pkg)
 701   -- ToDo: check these somehow?
 702   --    extra_libraries :: [String],
 703   --    c_includes      :: [String],
 704
 705 -- When the package name and version are put together, sometimes we can
 706 -- end up with a package id that cannot be parsed.  This will lead to
 707 -- difficulties when the user wants to refer to the package later, so
 708 -- we check that the package id can be parsed properly here.
 709 checkPackageId :: InstalledPackageInfo -> IO ()
 710 checkPackageId ipi =
 711   let str = showPackageId (package ipi) in
 712   case [ x | (x,ys) <- readP_to_S parsePackageId str, all isSpace ys ] of
 713     [_] -> return ()
 714     []  -> die ("invalid package identifier: " ++ str)
 715     _   -> die ("ambiguous package identifier: " ++ str)
 716
 717 resolveDeps :: PackageDBStack -> InstalledPackageInfo -> InstalledPackageInfo
 718 resolveDeps db_stack p = updateDeps p
 719   where
 720         -- The input package spec is allowed to give a package dependency
 721         -- without a version number; e.g.
 722         --      depends: base
 723         -- Here, we update these dependencies without version numbers to
 724         -- match the actual versions of the relevant packages installed.
 725         updateDeps p = p{depends = map resolveDep (depends p)}
 726
 727         resolveDep dep_pkgid
 728            | realVersion dep_pkgid  = dep_pkgid
 729            | otherwise              = lookupDep dep_pkgid
 730
 731         lookupDep dep_pkgid
 732            = let
 733                 name = pkgName dep_pkgid
 734              in
 735              case [ pid | p <- concat (map snd db_stack),
 736                           let pid = package p,
 737                           pkgName pid == name ] of
 738                 (pid:_) -> pid          -- Found installed package,
 739                                         -- replete with its version
 740                 []      -> dep_pkgid    -- No installed package; use
 741                                         -- the version-less one
 742
 743 checkDuplicates :: PackageDBStack -> InstalledPackageInfo -> Bool -> IO ()
 744 checkDuplicates db_stack pkg update = do
 745   let
 746         pkgid = package pkg
 747         (_top_db_name, pkgs) : _  = db_stack
 748   --
 749   -- Check whether this package id already exists in this DB
 750   --
 751   when (not update && (pkgid `elem` map package pkgs)) $
 752        die ("package " ++ showPackageId pkgid ++ " is already installed")
 753
 754
 755
 756 checkDir :: Force -> String -> IO ()
 757 checkDir force d
 758  | "$topdir" `isPrefixOf` d = return ()
 759         -- can't check this, because we don't know what $topdir is
 760  | otherwise = do
 761    there <- doesDirectoryExist d
 762    when (not there)
 763        (dieOrForceFile force (d ++ " doesn't exist or isn't a directory"))
 764
 765 checkDep :: PackageDBStack -> Force -> PackageIdentifier -> IO ()
 766 checkDep db_stack force pkgid
 767   | pkgid `elem` pkgids || (not real_version && name_exists) = return ()
 768   | otherwise = dieOrForceAll force ("dependency " ++ showPackageId pkgid
 769                                         ++ " doesn't exist")
 770   where
 771         -- for backwards compat, we treat 0.0 as a special version,
 772         -- and don't check that it actually exists.
 773         real_version = realVersion pkgid
 774
 775         name_exists = any (\p -> pkgName (package p) == name) all_pkgs
 776         name = pkgName pkgid
 777
 778         all_pkgs = concat (map snd db_stack)
 779         pkgids = map package all_pkgs
 780
 781 realVersion :: PackageIdentifier -> Bool
 782 realVersion pkgid = versionBranch (pkgVersion pkgid) /= []
 783
 784 checkHSLib :: [String] -> Bool -> Force -> String -> IO ()
 785 checkHSLib dirs auto_ghci_libs force lib = do
 786   let batch_lib_file = "lib" ++ lib ++ ".a"
 787   bs <- mapM (doesLibExistIn batch_lib_file) dirs
 788   case [ dir | (exists,dir) <- zip bs dirs, exists ] of
 789         [] -> dieOrForceFile force ("cannot find " ++ batch_lib_file ++
 790                                  " on library path")
 791         (dir:_) -> checkGHCiLib dirs dir batch_lib_file lib auto_ghci_libs
 792
 793 doesLibExistIn :: String -> String -> IO Bool
 794 doesLibExistIn lib d
 795  | "$topdir" `isPrefixOf` d = return True
 796  | otherwise                = doesFileExist (d ++ '/':lib)
 797
 798 checkGHCiLib :: [String] -> String -> String -> String -> Bool -> IO ()
 799 checkGHCiLib dirs batch_lib_dir batch_lib_file lib auto_build
 800   | auto_build = autoBuildGHCiLib batch_lib_dir batch_lib_file ghci_lib_file
 801   | otherwise  = do
 802       bs <- mapM (doesLibExistIn ghci_lib_file) dirs
 803       case [dir | (exists,dir) <- zip bs dirs, exists] of
 804         []    -> hPutStrLn stderr ("warning: can't find GHCi lib " ++ ghci_lib_file)
 805         (_:_) -> return ()
 806   where
 807     ghci_lib_file = lib ++ ".o"
 808
 809 -- automatically build the GHCi version of a batch lib,
 810 -- using ld --whole-archive.
 811
 812 autoBuildGHCiLib :: String -> String -> String -> IO ()
 813 autoBuildGHCiLib dir batch_file ghci_file = do
 814   let ghci_lib_file  = dir ++ '/':ghci_file
 815       batch_lib_file = dir ++ '/':batch_file
 816   hPutStr stderr ("building GHCi library " ++ ghci_lib_file ++ "...")
 817 #if defined(darwin_HOST_OS)
 818   r <- rawSystem "ld" ["-r","-x","-o",ghci_lib_file,"-all_load",batch_lib_file]
 819 #elif defined(mingw32_HOST_OS)
 820   execDir <- getExecDir "/bin/ghc-pkg.exe"
 821   r <- rawSystem (maybe "" (++"/gcc-lib/") execDir++"ld") ["-r","-x","-o",ghci_lib_file,"--whole-archive",batch_lib_file]
 822 #else
 823   r <- rawSystem "ld" ["-r","-x","-o",ghci_lib_file,"--whole-archive",batch_lib_file]
 824 #endif
 825   when (r /= ExitSuccess) $ exitWith r
 826   hPutStrLn stderr (" done.")
 827
 828 -- -----------------------------------------------------------------------------
 829 -- Searching for modules
 830
 831 #if not_yet
 832
 833 findModules :: [FilePath] -> IO [String]
 834 findModules paths =
 835   mms <- mapM searchDir paths
 836   return (concat mms)
 837
 838 searchDir path prefix = do
 839   fs <- getDirectoryEntries path `catch` \_ -> return []
 840   searchEntries path prefix fs
 841
 842 searchEntries path prefix [] = return []
 843 searchEntries path prefix (f:fs)
 844   | looks_like_a_module  =  do
 845         ms <- searchEntries path prefix fs
 846         return (prefix `joinModule` f : ms)
 847   | looks_like_a_component  =  do
 848         ms <- searchDir (path `joinFilename` f) (prefix `joinModule` f)
 849         ms' <- searchEntries path prefix fs
 850         return (ms ++ ms')
 851   | otherwise
 852         searchEntries path prefix fs
 853
 854   where
 855         (base,suffix) = splitFileExt f
 856         looks_like_a_module =
 857                 suffix `elem` haskell_suffixes &&
 858                 all okInModuleName base
 859         looks_like_a_component =
 860                 null suffix && all okInModuleName base
 861
 862 okInModuleName c
 863
 864 #endif
 865
 866 -- -----------------------------------------------------------------------------
 867 -- The old command-line syntax, supported for backwards compatibility
 868
 869 data OldFlag
 870   = OF_Config FilePath
 871   | OF_Input FilePath
 872   | OF_List
 873   | OF_ListLocal
 874   | OF_Add Bool {- True => replace existing info -}
 875   | OF_Remove String | OF_Show String
 876   | OF_Field String | OF_AutoGHCiLibs | OF_Force
 877   | OF_DefinedName String String
 878   | OF_GlobalConfig FilePath
 879   deriving (Eq)
 880
 881 isAction :: OldFlag -> Bool
 882 isAction OF_Config{}        = False
 883 isAction OF_Field{}         = False
 884 isAction OF_Input{}         = False
 885 isAction OF_AutoGHCiLibs{}  = False
 886 isAction OF_Force{}         = False
 887 isAction OF_DefinedName{}   = False
 888 isAction OF_GlobalConfig{}  = False
 889 isAction _                  = True
 890
 891 oldFlags :: [OptDescr OldFlag]
 892 oldFlags = [
 893   Option ['f'] ["config-file"] (ReqArg OF_Config "FILE")
 894         "use the specified package config file",
 895   Option ['l'] ["list-packages"] (NoArg OF_List)
 896         "list packages in all config files",
 897   Option ['L'] ["list-local-packages"] (NoArg OF_ListLocal)
 898         "list packages in the specified config file",
 899   Option ['a'] ["add-package"] (NoArg (OF_Add False))
 900         "add a new package",
 901   Option ['u'] ["update-package"] (NoArg (OF_Add True))
 902         "update package with new configuration",
 903   Option ['i'] ["input-file"] (ReqArg OF_Input "FILE")
 904         "read new package info from specified file",
 905   Option ['s'] ["show-package"] (ReqArg OF_Show "NAME")
 906         "show the configuration for package NAME",
 907   Option [] ["field"] (ReqArg OF_Field "FIELD")
 908         "(with --show-package) Show field FIELD only",
 909   Option [] ["force"] (NoArg OF_Force)
 910         "ignore missing directories/libraries",
 911   Option ['r'] ["remove-package"] (ReqArg OF_Remove "NAME")
 912         "remove an installed package",
 913   Option ['g'] ["auto-ghci-libs"] (NoArg OF_AutoGHCiLibs)
 914         "automatically build libs for GHCi (with -a)",
 915   Option ['D'] ["define-name"] (ReqArg toDefined "NAME=VALUE")
 916         "define NAME as VALUE",
 917   Option [] ["global-conf"] (ReqArg OF_GlobalConfig "FILE")
 918         "location of the global package config"
 919   ]
 920  where
 921   toDefined str =
 922     case break (=='=') str of
 923       (nm,[]) -> OF_DefinedName nm []
 924       (nm,_:val) -> OF_DefinedName nm val
 925
 926 oldRunit :: [OldFlag] -> IO ()
 927 oldRunit clis = do
 928   let new_flags = [ f | Just f <- map conv clis ]
 929
 930       conv (OF_GlobalConfig f) = Just (FlagGlobalConfig f)
 931       conv (OF_Config f)       = Just (FlagConfig f)
 932       conv _                   = Nothing
 933
 934
 935
 936   let fields = [ f | OF_Field f <- clis ]
 937
 938   let auto_ghci_libs = any isAuto clis
 939          where isAuto OF_AutoGHCiLibs = True; isAuto _ = False
 940       input_file = my_head "inp" ([ f | (OF_Input f) <- clis] ++ ["-"])
 941
 942       force = if OF_Force `elem` clis then ForceAll else NoForce
 943
 944       defines = [ (nm,val) | OF_DefinedName nm val <- clis ]
 945
 946   case [ c | c <- clis, isAction c ] of
 947     [ OF_List ]      -> listPackages new_flags Nothing
 948     [ OF_ListLocal ] -> listPackages new_flags Nothing
 949     [ OF_Add upd ]   ->
 950         registerPackage input_file defines new_flags auto_ghci_libs upd force
 951     [ OF_Remove pkgid_str ]  -> do
 952         pkgid <- readPkgId pkgid_str
 953         unregisterPackage pkgid new_flags
 954     [ OF_Show pkgid_str ]
 955         | null fields -> do
 956                 pkgid <- readPkgId pkgid_str
 957                 describePackage new_flags pkgid
 958         | otherwise   -> do
 959                 pkgid <- readPkgId pkgid_str
 960                 mapM_ (describeField new_flags pkgid) fields
 961     _ -> do
 962         prog <- getProgramName
 963         die (usageInfo (usageHeader prog) flags)
 964
 965 my_head :: String -> [a] -> a
 966 my_head s [] = error s
 967 my_head s (x:xs) = x
 968
 969 -- ---------------------------------------------------------------------------
 970 -- expanding environment variables in the package configuration
 971
 972 expandEnvVars :: String -> [(String, String)] -> Force -> IO String
 973 expandEnvVars str defines force = go str ""
 974  where
 975    go "" acc = return $! reverse acc
 976    go ('$':'{':str) acc | (var, '}':rest) <- break close str
 977         = do value <- lookupEnvVar var
 978              go rest (reverse value ++ acc)
 979         where close c = c == '}' || c == '\n' -- don't span newlines
 980    go (c:str) acc
 981         = go str (c:acc)
 982
 983    lookupEnvVar :: String -> IO String
 984    lookupEnvVar nm =
 985      case lookup nm defines of
 986        Just x | not (null x) -> return x
 987        _      ->
 988         catch (System.getEnv nm)
 989            (\ _ -> do dieOrForceAll force ("Unable to expand variable " ++
 990                                         show nm)
 991                       return "")
 992
 993 -----------------------------------------------------------------------------
 994
 995 getProgramName :: IO String
 996 getProgramName = liftM (`withoutSuffix` ".bin") getProgName
 997    where str `withoutSuffix` suff
 998             | suff `isSuffixOf` str = take (length str - length suff) str
 999             | otherwise             = str
1000
1001 bye :: String -> IO a
1002 bye s = putStr s >> exitWith ExitSuccess
1003
1004 die :: String -> IO a
1005 die s = do
1006   hFlush stdout
1007   prog <- getProgramName
1008   hPutStrLn stderr (prog ++ ": " ++ s)
1009   exitWith (ExitFailure 1)
1010
1011 dieOrForceAll :: Force -> String -> IO ()
1012 dieOrForceAll ForceAll s = ignoreError s
1013 dieOrForceAll _other s   = dieForcible s
1014
1015 dieOrForceFile :: Force -> String -> IO ()
1016 dieOrForceFile ForceAll   s = ignoreError s
1017 dieOrForceFile ForceFiles s = ignoreError s
1018 dieOrForceFile _other     s = dieForcible s
1019
1020 ignoreError :: String -> IO ()
1021 ignoreError s = do hFlush stdout; hPutStrLn stderr (s ++ " (ignoring)")
1022
1023 dieForcible :: String -> IO ()
1024 dieForcible s = die (s ++ " (use --force to override)")
1025
1026 -----------------------------------------
1027 --      Cut and pasted from ghc/compiler/SysTools
1028
1029 #if defined(mingw32_HOST_OS)
1030 subst a b ls = map (\ x -> if x == a then b else x) ls
1031 unDosifyPath xs = subst '\\' '/' xs
1032
1033 getExecDir :: String -> IO (Maybe String)
1034 -- (getExecDir cmd) returns the directory in which the current
1035 --                  executable, which should be called 'cmd', is running
1036 -- So if the full path is /a/b/c/d/e, and you pass "d/e" as cmd,
1037 -- you'll get "/a/b/c" back as the result
1038 getExecDir cmd
1039   = allocaArray len $ \buf -> do
1040         ret <- getModuleFileName nullPtr buf len
1041         if ret == 0 then return Nothing
1042                     else do s <- peekCString buf
1043                             return (Just (reverse (drop (length cmd)
1044                                                         (reverse (unDosifyPath s)))))
1045   where
1046     len = 2048::Int -- Plenty, PATH_MAX is 512 under Win32.
1047
1048 foreign import stdcall unsafe  "GetModuleFileNameA"
1049   getModuleFileName :: Ptr () -> CString -> Int -> IO Int32
1050 #else
1051 getExecDir :: String -> IO (Maybe String)
1052 getExecDir _ = return Nothing
1053 #endif
1054
1055 -- -----------------------------------------------------------------------------
1056 -- FilePath utils
1057
1058 -- | The 'joinFileName' function is the opposite of 'splitFileName'.
1059 -- It joins directory and file names to form a complete file path.
1060 --
1061 -- The general rule is:
1062 --
1063 -- > dir `joinFileName` basename == path
1064 -- >   where
1065 -- >     (dir,basename) = splitFileName path
1066 --
1067 -- There might be an exceptions to the rule but in any case the
1068 -- reconstructed path will refer to the same object (file or directory).
1069 -- An example exception is that on Windows some slashes might be converted
1070 -- to backslashes.
1071 joinFileName :: String -> String -> FilePath
1072 joinFileName ""  fname = fname
1073 joinFileName "." fname = fname
1074 joinFileName dir ""    = dir
1075 joinFileName dir fname
1076   | isPathSeparator (last dir) = dir++fname
1077   | otherwise                  = dir++pathSeparator:fname
1078
1079 -- | Checks whether the character is a valid path separator for the host
1080 -- platform. The valid character is a 'pathSeparator' but since the Windows
1081 -- operating system also accepts a slash (\"\/\") since DOS 2, the function
1082 -- checks for it on this platform, too.
1083 isPathSeparator :: Char -> Bool
1084 isPathSeparator ch = ch == pathSeparator || ch == '/'
1085
1086 -- | Provides a platform-specific character used to separate directory levels in
1087 -- a path string that reflects a hierarchical file system organization. The
1088 -- separator is a slash (@\"\/\"@) on Unix and Macintosh, and a backslash
1089 -- (@\"\\\"@) on the Windows operating system.
1090 pathSeparator :: Char
1091 #ifdef mingw32_HOST_OS
1092 pathSeparator = '\\'
1093 #else
1094 pathSeparator = '/'
1095 #endif
1096
1097 getFilenameDir :: FilePath -> FilePath
1098 getFilenameDir fn = case break isPathSeparator (reverse fn) of
1099                         (xs, "") -> "."
1100                         (_, sep:ys) -> reverse ys
1101
1102 -- | The function splits the given string to substrings
1103 -- using the 'searchPathSeparator'.
1104 parseSearchPath :: String -> [FilePath]
1105 parseSearchPath path = split path
1106   where
1107     split :: String -> [String]
1108     split s =
1109       case rest' of
1110         []     -> [chunk]
1111         _:rest -> chunk : split rest
1112       where
1113         chunk =
1114           case chunk' of
1115 #ifdef mingw32_HOST_OS
1116             ('\"':xs@(_:_)) | last xs == '\"' -> init xs
1117 #endif
1118             _                                 -> chunk'
1119
1120         (chunk', rest') = break (==searchPathSeparator) s
1121
1122 -- | A platform-specific character used to separate search path strings in
1123 -- environment variables. The separator is a colon (\":\") on Unix and Macintosh,
1124 -- and a semicolon (\";\") on the Windows operating system.
1125 searchPathSeparator :: Char
1126 #if mingw32_HOST_OS || mingw32_TARGET_OS
1127 searchPathSeparator = ';'
1128 #else
1129 searchPathSeparator = ':'
1130 #endif
1131