2011-03-27 19:56:43 +00:00
|
|
|
{- git-annex remotes
|
|
|
|
-
|
|
|
|
- Copyright 2011 Joey Hess <joey@kitenet.net>
|
|
|
|
-
|
|
|
|
- Licensed under the GNU GPL version 3 or higher.
|
|
|
|
-}
|
|
|
|
|
|
|
|
module Remote (
|
2011-03-27 21:12:32 +00:00
|
|
|
Remote,
|
|
|
|
uuid,
|
|
|
|
name,
|
|
|
|
storeKey,
|
|
|
|
retrieveKeyFile,
|
2012-01-20 17:23:11 +00:00
|
|
|
retrieveKeyFileCheap,
|
2011-03-27 21:12:32 +00:00
|
|
|
removeKey,
|
|
|
|
hasKey,
|
|
|
|
hasKeyCheap,
|
2012-02-14 07:49:48 +00:00
|
|
|
whereisKey,
|
2011-07-05 22:31:46 +00:00
|
|
|
|
2011-03-29 18:55:59 +00:00
|
|
|
remoteTypes,
|
2011-12-30 23:10:54 +00:00
|
|
|
remoteList,
|
2011-12-31 05:42:42 +00:00
|
|
|
enabledRemoteList,
|
2011-11-18 17:22:48 +00:00
|
|
|
remoteMap,
|
2012-01-07 22:13:12 +00:00
|
|
|
uuidDescriptions,
|
2011-03-27 20:55:43 +00:00
|
|
|
byName,
|
2011-07-06 20:06:10 +00:00
|
|
|
prettyPrintUUIDs,
|
2012-07-30 01:54:23 +00:00
|
|
|
prettyListUUIDs,
|
2011-03-27 19:56:43 +00:00
|
|
|
remotesWithUUID,
|
2011-03-29 03:22:31 +00:00
|
|
|
remotesWithoutUUID,
|
2012-01-10 17:11:16 +00:00
|
|
|
keyLocations,
|
2011-07-06 20:06:10 +00:00
|
|
|
keyPossibilities,
|
|
|
|
keyPossibilitiesTrusted,
|
|
|
|
nameToUUID,
|
2011-07-05 22:31:46 +00:00
|
|
|
showTriedRemotes,
|
|
|
|
showLocations,
|
2011-10-28 21:26:38 +00:00
|
|
|
forceTrust,
|
2011-11-09 22:33:15 +00:00
|
|
|
logStatus
|
2011-03-27 19:56:43 +00:00
|
|
|
) where
|
|
|
|
|
2011-03-29 03:22:31 +00:00
|
|
|
import qualified Data.Map as M
|
2011-09-01 20:02:01 +00:00
|
|
|
import Text.JSON
|
|
|
|
import Text.JSON.Generic
|
2011-03-27 19:56:43 +00:00
|
|
|
|
2011-10-05 20:02:51 +00:00
|
|
|
import Common.Annex
|
2011-06-02 01:56:04 +00:00
|
|
|
import Types.Remote
|
2011-03-27 19:56:43 +00:00
|
|
|
import qualified Annex
|
2011-10-15 21:47:03 +00:00
|
|
|
import Annex.UUID
|
2011-10-15 20:21:08 +00:00
|
|
|
import Logs.UUID
|
|
|
|
import Logs.Trust
|
|
|
|
import Logs.Location
|
2012-01-10 17:11:16 +00:00
|
|
|
import Remote.List
|
2011-12-31 05:42:42 +00:00
|
|
|
|
2012-02-14 07:49:48 +00:00
|
|
|
{- Map from UUIDs of Remotes to a calculated value. -}
|
|
|
|
remoteMap :: (Remote -> a) -> Annex (M.Map UUID a)
|
|
|
|
remoteMap c = M.fromList . map (\r -> (uuid r, c r)) .
|
2012-01-08 18:37:57 +00:00
|
|
|
filter (\r -> uuid r /= NoUUID) <$> remoteList
|
2011-11-18 17:22:48 +00:00
|
|
|
|
2012-06-07 15:16:48 +00:00
|
|
|
{- Map of UUIDs of remotes and their descriptions.
|
2012-01-07 22:13:12 +00:00
|
|
|
- The names of Remotes are added to suppliment any description that has
|
2012-06-07 15:16:48 +00:00
|
|
|
- been set for a repository. -}
|
2012-01-07 22:13:12 +00:00
|
|
|
uuidDescriptions :: Annex (M.Map UUID String)
|
2012-02-14 07:49:48 +00:00
|
|
|
uuidDescriptions = M.unionWith addName <$> uuidMap <*> remoteMap name
|
2012-01-07 22:13:12 +00:00
|
|
|
|
|
|
|
addName :: String -> String -> String
|
|
|
|
addName desc n
|
|
|
|
| desc == n = desc
|
|
|
|
| null desc = n
|
|
|
|
| otherwise = n ++ " (" ++ desc ++ ")"
|
|
|
|
|
2012-01-06 08:02:35 +00:00
|
|
|
{- When a name is specified, looks up the remote matching that name.
|
|
|
|
- (Or it can be a UUID.) Only finds currently configured git remotes. -}
|
|
|
|
byName :: Maybe String -> Annex (Maybe Remote)
|
|
|
|
byName Nothing = return Nothing
|
2012-03-14 21:43:34 +00:00
|
|
|
byName (Just n) = either error Just <$> byName' n
|
2011-12-31 08:11:39 +00:00
|
|
|
byName' :: String -> Annex (Either String Remote)
|
2011-06-14 02:19:44 +00:00
|
|
|
byName' "" = return $ Left "no remote specified"
|
2012-03-14 21:43:34 +00:00
|
|
|
byName' n = handle . filter matching <$> remoteList
|
2011-03-27 20:55:43 +00:00
|
|
|
where
|
2012-06-26 21:15:17 +00:00
|
|
|
handle [] = Left $ "there is no available git remote named \"" ++ n ++ "\""
|
2012-03-14 21:43:34 +00:00
|
|
|
handle match = Right $ Prelude.head match
|
2011-11-08 03:21:22 +00:00
|
|
|
matching r = n == name r || toUUID n == uuid r
|
2011-03-27 19:56:43 +00:00
|
|
|
|
2011-06-14 02:19:44 +00:00
|
|
|
{- Looks up a remote by name (or by UUID, or even by description),
|
2011-09-30 06:23:24 +00:00
|
|
|
- and returns its UUID. Finds even remotes that are not configured in
|
|
|
|
- .git/config. -}
|
2011-03-27 20:55:43 +00:00
|
|
|
nameToUUID :: String -> Annex UUID
|
2011-10-11 18:43:45 +00:00
|
|
|
nameToUUID "." = getUUID -- special case for current repo
|
2012-03-02 02:35:10 +00:00
|
|
|
nameToUUID "here" = getUUID
|
2011-12-23 18:08:04 +00:00
|
|
|
nameToUUID "" = error "no remote specified"
|
2011-11-07 20:34:12 +00:00
|
|
|
nameToUUID n = byName' n >>= go
|
2011-06-14 02:19:44 +00:00
|
|
|
where
|
2011-11-07 20:34:12 +00:00
|
|
|
go (Right r) = return $ uuid r
|
|
|
|
go (Left e) = fromMaybe (error e) <$> bydescription
|
|
|
|
bydescription = do
|
2011-09-30 06:23:24 +00:00
|
|
|
m <- uuidMap
|
2011-11-07 20:34:12 +00:00
|
|
|
case M.lookup n $ transform swap m of
|
2011-09-30 06:23:24 +00:00
|
|
|
Just u -> return $ Just u
|
2011-11-07 20:34:12 +00:00
|
|
|
Nothing -> return $ byuuid m
|
2011-11-08 03:21:22 +00:00
|
|
|
byuuid m = M.lookup (toUUID n) $ transform double m
|
2011-09-30 06:51:05 +00:00
|
|
|
transform a = M.fromList . map a . M.toList
|
2011-06-14 02:19:44 +00:00
|
|
|
swap (a, b) = (b, a)
|
2011-11-07 20:34:12 +00:00
|
|
|
double (a, _) = (a, a)
|
2011-03-27 19:56:43 +00:00
|
|
|
|
2011-09-01 20:02:01 +00:00
|
|
|
{- Pretty-prints a list of UUIDs of remotes, for human display.
|
|
|
|
-
|
|
|
|
- When JSON is enabled, also generates a machine-readable description
|
|
|
|
- of the UUIDs. -}
|
|
|
|
prettyPrintUUIDs :: String -> [UUID] -> Annex String
|
|
|
|
prettyPrintUUIDs desc uuids = do
|
2011-11-08 19:34:10 +00:00
|
|
|
hereu <- getUUID
|
2012-01-07 22:13:12 +00:00
|
|
|
m <- uuidDescriptions
|
2011-11-08 19:34:10 +00:00
|
|
|
maybeShowJSON [(desc, map (jsonify m hereu) uuids)]
|
|
|
|
return $ unwords $ map (\u -> "\t" ++ prettify m hereu u ++ "\n") uuids
|
2011-07-01 19:24:07 +00:00
|
|
|
where
|
2012-01-07 22:13:12 +00:00
|
|
|
finddescription m u = M.findWithDefault "" u m
|
2011-11-08 19:34:10 +00:00
|
|
|
prettify m hereu u
|
2011-11-08 03:21:22 +00:00
|
|
|
| not (null d) = fromUUID u ++ " -- " ++ d
|
|
|
|
| otherwise = fromUUID u
|
2011-07-01 19:24:07 +00:00
|
|
|
where
|
2011-11-08 19:34:10 +00:00
|
|
|
ishere = hereu == u
|
2012-01-07 22:13:12 +00:00
|
|
|
n = finddescription m u
|
2011-09-30 19:02:08 +00:00
|
|
|
d
|
|
|
|
| null n && ishere = "here"
|
2012-01-07 22:13:12 +00:00
|
|
|
| ishere = addName n "here"
|
2011-09-30 19:02:08 +00:00
|
|
|
| otherwise = n
|
2011-11-08 19:34:10 +00:00
|
|
|
jsonify m hereu u = toJSObject
|
2011-11-08 03:21:22 +00:00
|
|
|
[ ("uuid", toJSON $ fromUUID u)
|
2012-01-07 22:13:12 +00:00
|
|
|
, ("description", toJSON $ finddescription m u)
|
2011-11-08 19:34:10 +00:00
|
|
|
, ("here", toJSON $ hereu == u)
|
2011-09-01 20:02:01 +00:00
|
|
|
]
|
2011-07-01 19:24:07 +00:00
|
|
|
|
2012-07-30 02:11:01 +00:00
|
|
|
{- List of remote names and/or descriptions, for human display. -}
|
2012-07-30 01:54:23 +00:00
|
|
|
prettyListUUIDs :: [UUID] -> Annex [String]
|
|
|
|
prettyListUUIDs uuids = do
|
|
|
|
hereu <- getUUID
|
|
|
|
m <- uuidDescriptions
|
2012-07-30 02:11:01 +00:00
|
|
|
return $ map (\u -> prettify m hereu u) uuids
|
|
|
|
where
|
|
|
|
finddescription m u = M.findWithDefault "" u m
|
|
|
|
prettify m hereu u
|
|
|
|
| u == hereu = addName n "here"
|
|
|
|
| otherwise = n
|
|
|
|
where
|
|
|
|
n = finddescription m u
|
2012-07-30 01:54:23 +00:00
|
|
|
|
2011-03-27 20:55:43 +00:00
|
|
|
{- Filters a list of remotes to ones that have the listed uuids. -}
|
2011-12-31 08:11:39 +00:00
|
|
|
remotesWithUUID :: [Remote] -> [UUID] -> [Remote]
|
2011-03-27 20:55:43 +00:00
|
|
|
remotesWithUUID rs us = filter (\r -> uuid r `elem` us) rs
|
|
|
|
|
|
|
|
{- Filters a list of remotes to ones that do not have the listed uuids. -}
|
2011-12-31 08:11:39 +00:00
|
|
|
remotesWithoutUUID :: [Remote] -> [UUID] -> [Remote]
|
2011-03-27 20:55:43 +00:00
|
|
|
remotesWithoutUUID rs us = filter (\r -> uuid r `notElem` us) rs
|
|
|
|
|
2012-01-10 17:11:16 +00:00
|
|
|
{- List of repository UUIDs that the location log indicates may have a key.
|
|
|
|
- Dead repositories are excluded. -}
|
|
|
|
keyLocations :: Key -> Annex [UUID]
|
|
|
|
keyLocations key = snd <$> (trustPartition DeadTrusted =<< loggedLocations key)
|
|
|
|
|
|
|
|
{- Cost ordered lists of remotes that the location log indicates
|
|
|
|
- may have a key.
|
2011-06-23 17:39:04 +00:00
|
|
|
-}
|
2011-12-31 08:11:39 +00:00
|
|
|
keyPossibilities :: Key -> Annex [Remote]
|
2012-01-10 17:11:16 +00:00
|
|
|
keyPossibilities key = fst <$> keyPossibilities' key []
|
2011-06-23 17:39:04 +00:00
|
|
|
|
2012-01-10 17:11:16 +00:00
|
|
|
{- Cost ordered lists of remotes that the location log indicates
|
|
|
|
- may have a key.
|
2011-06-01 23:10:38 +00:00
|
|
|
-
|
|
|
|
- Also returns a list of UUIDs that are trusted to have the key
|
|
|
|
- (some may not have configured remotes).
|
|
|
|
-}
|
2011-12-31 08:11:39 +00:00
|
|
|
keyPossibilitiesTrusted :: Key -> Annex ([Remote], [UUID])
|
2012-01-10 17:11:16 +00:00
|
|
|
keyPossibilitiesTrusted key = keyPossibilities' key =<< trustGet Trusted
|
2011-06-23 19:30:04 +00:00
|
|
|
|
2012-01-10 17:11:16 +00:00
|
|
|
keyPossibilities' :: Key -> [UUID] -> Annex ([Remote], [UUID])
|
|
|
|
keyPossibilities' key trusted = do
|
2011-10-11 18:43:45 +00:00
|
|
|
u <- getUUID
|
2011-06-01 23:10:38 +00:00
|
|
|
|
2012-01-10 17:11:16 +00:00
|
|
|
-- uuids of all remotes that are recorded to have the key
|
|
|
|
validuuids <- filter (/= u) <$> keyLocations key
|
2011-06-01 23:10:38 +00:00
|
|
|
|
|
|
|
-- note that validuuids is assumed to not have dups
|
2011-09-06 21:19:29 +00:00
|
|
|
let validtrusteduuids = validuuids `intersect` trusted
|
2011-06-01 23:10:38 +00:00
|
|
|
|
|
|
|
-- remotes that match uuids that have the key
|
2011-12-31 05:42:42 +00:00
|
|
|
allremotes <- enabledRemoteList
|
2011-06-01 23:10:38 +00:00
|
|
|
let validremotes = remotesWithUUID allremotes validuuids
|
|
|
|
|
|
|
|
return (sort validremotes, validtrusteduuids)
|
|
|
|
|
2011-07-05 22:31:46 +00:00
|
|
|
{- Displays known locations of a key. -}
|
|
|
|
showLocations :: Key -> [UUID] -> Annex ()
|
|
|
|
showLocations key exclude = do
|
2011-10-11 18:43:45 +00:00
|
|
|
u <- getUUID
|
2011-07-05 22:31:46 +00:00
|
|
|
uuids <- keyLocations key
|
|
|
|
untrusteduuids <- trustGet UnTrusted
|
|
|
|
let uuidswanted = filteruuids uuids (u:exclude++untrusteduuids)
|
|
|
|
let uuidsskipped = filteruuids uuids (u:exclude++uuidswanted)
|
2011-09-01 20:02:01 +00:00
|
|
|
ppuuidswanted <- Remote.prettyPrintUUIDs "wanted" uuidswanted
|
|
|
|
ppuuidsskipped <- Remote.prettyPrintUUIDs "skipped" uuidsskipped
|
2011-07-05 22:31:46 +00:00
|
|
|
showLongNote $ message ppuuidswanted ppuuidsskipped
|
|
|
|
where
|
|
|
|
filteruuids l x = filter (`notElem` x) l
|
|
|
|
message [] [] = "No other repository is known to contain the file."
|
|
|
|
message rs [] = "Try making some of these repositories available:\n" ++ rs
|
|
|
|
message [] us = "Also these untrusted repositories may contain the file:\n" ++ us
|
|
|
|
message rs us = message rs [] ++ message [] us
|
|
|
|
|
2011-12-31 08:11:39 +00:00
|
|
|
showTriedRemotes :: [Remote] -> Annex ()
|
2012-04-22 03:32:33 +00:00
|
|
|
showTriedRemotes [] = noop
|
2011-07-05 22:31:46 +00:00
|
|
|
showTriedRemotes remotes =
|
|
|
|
showLongNote $ "Unable to access these remotes: " ++
|
2012-01-10 19:36:54 +00:00
|
|
|
join ", " (map name remotes)
|
2011-07-05 22:31:46 +00:00
|
|
|
|
2011-06-02 06:33:31 +00:00
|
|
|
forceTrust :: TrustLevel -> String -> Annex ()
|
2012-01-10 17:11:16 +00:00
|
|
|
forceTrust level remotename = do
|
|
|
|
u <- nameToUUID remotename
|
2011-06-02 06:33:31 +00:00
|
|
|
Annex.changeState $ \s ->
|
2012-01-10 17:11:16 +00:00
|
|
|
s { Annex.forcetrust = M.insert u level (Annex.forcetrust s) }
|
2011-10-28 21:26:38 +00:00
|
|
|
|
|
|
|
{- Used to log a change in a remote's having a key. The change is logged
|
|
|
|
- in the local repo, not on the remote. The process of transferring the
|
|
|
|
- key to the remote, or removing the key from it *may* log the change
|
|
|
|
- on the remote, but this cannot always be relied on. -}
|
2012-01-19 19:24:05 +00:00
|
|
|
logStatus :: Remote -> Key -> LogStatus -> Annex ()
|
2012-02-16 04:41:30 +00:00
|
|
|
logStatus remote key = logChange key (uuid remote)
|