{- exports to remotes - - Copyright 2017 Joey Hess - - Licensed under the GNU GPL version 3 or higher. -} {-# LANGUAGE FlexibleInstances #-} module Remote.Helper.Export where import Annex.Common import Types.Remote import Types.Backend import Types.Key import Backend import Remote.Helper.Encryptable (isEncrypted) import Database.Export import Annex.Export import qualified Data.Map as M import Control.Concurrent.STM -- | Use for remotes that do not support exports. class HasExportUnsupported a where exportUnsupported :: a instance HasExportUnsupported (RemoteConfig -> RemoteGitConfig -> Annex Bool) where exportUnsupported = \_ _ -> return False instance HasExportUnsupported (Annex (ExportActions Annex)) where exportUnsupported = return $ ExportActions { storeExport = \_ _ _ _ -> do warning "store export is unsupported" return False , retrieveExport = \_ _ _ _ -> return False , checkPresentExport = \_ _ -> return False , removeExport = \_ _ -> return False , removeExportDirectory = Just $ \_ -> return False , renameExport = \_ _ _ -> return False } exportIsSupported :: RemoteConfig -> RemoteGitConfig -> Annex Bool exportIsSupported = \_ _ -> return True -- | Prevent or allow exporttree=yes when setting up a new remote, -- depending on exportSupported and other configuration. adjustExportableRemoteType :: RemoteType -> RemoteType adjustExportableRemoteType rt = rt { setup = setup' } where setup' st mu cp c gc = do let cont = setup rt st mu cp c gc ifM (exportSupported rt c gc) ( case st of Init | exportTree c && isEncrypted c -> giveup "cannot enable both encryption and exporttree" | otherwise -> cont Enable oldc | exportTree c /= exportTree oldc -> giveup "cannot change exporttree of existing special remote" | otherwise -> cont , if exportTree c then giveup "exporttree=yes is not supported by this special remote" else cont ) -- | If the remote is exportSupported, and exporttree=yes, adjust the -- remote to be an export. adjustExportable :: Remote -> Annex Remote adjustExportable r = case M.lookup "exporttree" (config r) of Just "yes" -> ifM (isExportSupported r) ( isexport , notexport ) Nothing -> notexport Just "no" -> notexport Just _ -> error "bad exporttree value" where notexport = return $ r { exportActions = exportUnsupported , remotetype = (remotetype r) { exportSupported = exportUnsupported } } isexport = do db <- openDb (uuid r) updateflag <- liftIO newEmptyTMVarIO let updateonce = liftIO $ atomically $ ifM (isEmptyTMVar updateflag) ( do putTMVar updateflag () return True , return False ) -- Get export locations for a key. Checks once -- if the export log is different than the database and -- updates the database, to notice when an export has been -- updated from another repository. let getexportlocs = \k -> do whenM updateonce $ updateExportTreeFromLog db liftIO $ getExportTree db k return $ r -- Storing a key on an export could be implemented, -- but it would perform unncessary work -- when another repository has already stored the -- key, and the local repository does not know -- about it. To avoid unnecessary costs, don't do it. { storeKey = \_ _ _ -> do warning "remote is configured with exporttree=yes; use `git-annex export` to store content on it" return False -- Keys can be retrieved, but since an export -- is not a true key/value store, the content of -- the key has to be able to be strongly verified. , retrieveKeyFile = \k _af dest p -> unVerified $ if maybe False (isJust . verifyKeyContent) (maybeLookupBackendVariety (keyVariety k)) then do locs <- getexportlocs k case locs of [] -> do warning "unknown export location" return False (l:_) -> do ea <- exportActions r retrieveExport ea k l dest p else do warning $ "exported content cannot be verified due to using the " ++ formatKeyVariety (keyVariety k) ++ " backend" return False , retrieveKeyFileCheap = \_ _ _ -> return False -- Removing a key from an export would need to -- change the tree in the export log to not include -- the file. Otherwise, conflicts when removing -- files would not be dealt with correctly. -- There does not seem to be a good use case for -- removing a key from an export in any case. , removeKey = \_k -> do warning "dropping content from an export is not supported; use `git annex export` to export a tree that lacks the files you want to remove" return False -- Can't lock content on exports, since they're -- not key/value stores, and someone else could -- change what's exported to a file at any time. , lockContent = Nothing -- Check if any of the files a key was exported -- to are present. This doesn't guarantee the -- export contains the right content. , checkPresent = \k -> do ea <- exportActions r anyM (checkPresentExport ea k) =<< getexportlocs k , mkUnavailable = return Nothing , getInfo = do is <- getInfo r return (is++[("export", "yes")]) }