{- git-annex command - - Copyright 2017 Joey Hess - - Licensed under the GNU GPL version 3 or higher. -} {-# LANGUAGE TupleSections #-} module Command.Export where import Command import qualified Annex import qualified Git import qualified Git.DiffTree import qualified Git.LsTree import qualified Git.Ref import Git.Types import Git.FilePath import Git.Sha import Types.Key import Types.Remote import Annex.Content import Annex.CatFile import Logs.Location import Logs.Export import Database.Export import Messages.Progress import Utility.Tmp import qualified Data.ByteString.Lazy as L import qualified Data.Map as M cmd :: Command cmd = command "export" SectionCommon "export content to a remote" paramTreeish (seek <$$> optParser) data ExportOptions = ExportOptions { exportTreeish :: Git.Ref , exportRemote :: DeferredParse Remote } optParser :: CmdParamsDesc -> Parser ExportOptions optParser _ = ExportOptions <$> (Git.Ref <$> parsetreeish) <*> (parseRemoteOption <$> parseToOption) where parsetreeish = argument str ( metavar paramTreeish ) -- An export includes both annexed files and files stored in git. -- For the latter, a SHA1 key is synthesized. data ExportKey = AnnexKey Key | GitKey Key deriving (Show, Eq, Ord) asKey :: ExportKey -> Key asKey (AnnexKey k) = k asKey (GitKey k) = k exportKey :: Git.Sha -> Annex ExportKey exportKey sha = mk <$> catKey sha where mk (Just k) = AnnexKey k mk Nothing = GitKey $ Key { keyName = show sha , keyVariety = SHA1Key (HasExt False) , keySize = Nothing , keyMtime = Nothing , keyChunkSize = Nothing , keyChunkNum = Nothing } -- To handle renames which swap files, the exported file is first renamed -- to a stable temporary name based on the key. exportTempName :: ExportKey -> ExportLocation exportTempName ek = ExportLocation $ ".git-annex-tmp-content-" ++ key2file (asKey (ek)) seek :: ExportOptions -> CommandSeek seek o = do r <- getParsed (exportRemote o) unlessM (isExportSupported r) $ giveup "That remote does not support exports." new <- fromMaybe (giveup "unknown tree") <$> -- Dereference the tree pointed to by the branch, commit, -- or tag. inRepo (Git.Ref.tree (exportTreeish o)) old <- getExport (uuid r) db <- openDb (uuid r) ea <- exportActions r recordExportBeginning (uuid r) new -- Clean up after incomplete export of a tree, in which -- the next block of code below may have renamed some files to -- temp files. Diff from the incomplete tree to the new tree, -- and delete any temp files that the new tree can't use. forM_ (concatMap incompleteExportedTreeish old) $ \incomplete -> mapdiff (\diff -> startRecoverIncomplete r ea db (Git.DiffTree.srcsha diff) (Git.DiffTree.file diff)) incomplete new -- Diff the old and new trees, and delete or rename to new name all -- changed files in the export. After this, every file that remains -- in the export will have the content from the new treeish. -- -- (Also, when there was an export conflict, this resolves it.) case map exportedTreeish old of [] -> return () [oldtreesha] -> do diffmap <- mkDiffMap oldtreesha new let seekdiffmap a = seekActions $ pure $ map a (M.toList diffmap) -- Rename old files to temp, or delete. seekdiffmap $ \(ek, (moldf, mnewf)) -> case (moldf, mnewf) of (Just oldf, Just _newf) -> startMoveToTempName r ea db oldf ek (Just oldf, Nothing) -> startUnexport' r ea db oldf ek _ -> stop -- Rename from temp to new files. seekdiffmap $ \(ek, (moldf, mnewf)) -> case (moldf, mnewf) of (Just _oldf, Just newf) -> startMoveFromTempName r ea db ek newf _ -> stop ts -> do warning "Export conflict detected. Different trees have been exported to the same special remote. Resolving.." forM_ ts $ \oldtreesha -> do -- Unexport both the srcsha and the dstsha, -- because the wrong content may have -- been renamed to the dstsha due to the -- export conflict. let unexportboth d = [ Git.DiffTree.srcsha d , Git.DiffTree.dstsha d ] -- Don't rename to temp, because the -- content is unknown; delete instead. mapdiff (\diff -> startUnexport r ea db (Git.DiffTree.file diff) (unexportboth diff)) oldtreesha new -- Waiting until now to record the export guarantees that, -- if this export is interrupted, there are no files left over -- from a previous export, that are not part of this export. c <- Annex.getState Annex.errcounter when (c == 0) $ recordExport (uuid r) $ ExportChange { oldTreeish = map exportedTreeish old , newTreeish = new } -- Export everything that is not yet exported. (l, cleanup') <- inRepo $ Git.LsTree.lsTree new seekActions $ pure $ map (startExport r ea db) l void $ liftIO cleanup' closeDb db where mapdiff a oldtreesha newtreesha = do (diff, cleanup) <- inRepo $ Git.DiffTree.diffTreeRecursive oldtreesha newtreesha seekActions $ pure $ map a diff void $ liftIO cleanup -- Map of old and new filenames for each changed ExportKey in a diff. type DiffMap = M.Map ExportKey (Maybe TopFilePath, Maybe TopFilePath) mkDiffMap :: Git.Ref -> Git.Ref -> Annex DiffMap mkDiffMap old new = do (diff, cleanup) <- inRepo $ Git.DiffTree.diffTreeRecursive old new diffmap <- M.fromListWith combinedm . concat <$> forM diff mkdm void $ liftIO cleanup return diffmap where combinedm (srca, dsta) (srcb, dstb) = (srca <|> srcb, dsta <|> dstb) mkdm i = do srcek <- getk (Git.DiffTree.srcsha i) dstek <- getk (Git.DiffTree.dstsha i) return $ catMaybes [ (, (Just (Git.DiffTree.file i), Nothing)) <$> srcek , (, (Nothing, Just (Git.DiffTree.file i))) <$> dstek ] getk sha | sha == nullSha = return Nothing | otherwise = Just <$> exportKey sha startExport :: Remote -> ExportActions Annex -> ExportHandle -> Git.LsTree.TreeItem -> CommandStart startExport r ea db ti = do ek <- exportKey (Git.LsTree.sha ti) stopUnless (liftIO $ notElem loc <$> getExportLocation db (asKey ek)) $ do showStart "export" f next $ performExport r ea db ek (Git.LsTree.sha ti) loc where loc = ExportLocation $ toInternalGitPath f f = getTopFilePath $ Git.LsTree.file ti performExport :: Remote -> ExportActions Annex -> ExportHandle -> ExportKey -> Sha -> ExportLocation -> CommandPerform performExport r ea db ek contentsha loc = do let storer = storeExport ea sent <- case ek of AnnexKey k -> ifM (inAnnex k) ( metered Nothing k $ \m -> do let rollback = void $ performUnexport r ea db [ek] loc sendAnnex k rollback (\f -> storer f k loc m) , do showNote "not available" return False ) -- Sending a non-annexed file. GitKey sha1k -> metered Nothing sha1k $ \m -> withTmpFile "export" $ \tmp h -> do b <- catObject contentsha liftIO $ L.hPut h b liftIO $ hClose h storer tmp sha1k loc m if sent then next $ cleanupExport r db ek loc else stop cleanupExport :: Remote -> ExportHandle -> ExportKey -> ExportLocation -> CommandCleanup cleanupExport r db ek loc = do liftIO $ addExportLocation db (asKey ek) loc logChange (asKey ek) (uuid r) InfoPresent return True startUnexport :: Remote -> ExportActions Annex -> ExportHandle -> TopFilePath -> [Git.Sha] -> CommandStart startUnexport r ea db f shas = do eks <- forM (filter (/= nullSha) shas) exportKey if null eks then stop else do showStart "unexport" f' next $ performUnexport r ea db eks loc where loc = ExportLocation $ toInternalGitPath f' f' = getTopFilePath f startUnexport' :: Remote -> ExportActions Annex -> ExportHandle -> TopFilePath -> ExportKey -> CommandStart startUnexport' r ea db f ek = do showStart "unexport" f' next $ performUnexport r ea db [ek] loc where loc = ExportLocation $ toInternalGitPath f' f' = getTopFilePath f performUnexport :: Remote -> ExportActions Annex -> ExportHandle -> [ExportKey] -> ExportLocation -> CommandPerform performUnexport r ea db eks loc = do ifM (allM (\ek -> removeExport ea (asKey ek) loc) eks) ( next $ cleanupUnexport r db eks loc , stop ) cleanupUnexport :: Remote -> ExportHandle -> [ExportKey] -> ExportLocation -> CommandCleanup cleanupUnexport r db eks loc = do liftIO $ do forM_ eks $ \ek -> removeExportLocation db (asKey ek) loc -- Flush so that getExportLocation sees this and any -- other removals of the key. flushDbQueue db remaininglocs <- liftIO $ concat <$> forM eks (\ek -> getExportLocation db (asKey ek)) when (null remaininglocs) $ forM_ eks $ \ek -> logChange (asKey ek) (uuid r) InfoMissing return True startRecoverIncomplete :: Remote -> ExportActions Annex -> ExportHandle -> Git.Sha -> TopFilePath -> CommandStart startRecoverIncomplete r ea db sha oldf | sha == nullSha = stop | otherwise = do ek <- exportKey sha let loc@(ExportLocation f) = exportTempName ek showStart "unexport" f liftIO $ removeExportLocation db (asKey ek) oldloc next $ performUnexport r ea db [ek] loc where oldloc = ExportLocation $ toInternalGitPath oldf' oldf' = getTopFilePath oldf startMoveToTempName :: Remote -> ExportActions Annex -> ExportHandle -> TopFilePath -> ExportKey -> CommandStart startMoveToTempName r ea db f ek = do let tmploc@(ExportLocation tmpf) = exportTempName ek showStart "rename" (f' ++ " -> " ++ tmpf) next $ performRename r ea db ek loc tmploc where loc = ExportLocation $ toInternalGitPath f' f' = getTopFilePath f startMoveFromTempName :: Remote -> ExportActions Annex -> ExportHandle -> ExportKey -> TopFilePath -> CommandStart startMoveFromTempName r ea db ek f = do let tmploc@(ExportLocation tmpf) = exportTempName ek stopUnless (liftIO $ elem tmploc <$> getExportLocation db (asKey ek)) $ do showStart "rename" (tmpf ++ " -> " ++ f') next $ performRename r ea db ek tmploc loc where loc = ExportLocation $ toInternalGitPath f' f' = getTopFilePath f performRename :: Remote -> ExportActions Annex -> ExportHandle -> ExportKey -> ExportLocation -> ExportLocation -> CommandPerform performRename r ea db ek src dest = do ifM (renameExport ea (asKey ek) src dest) ( next $ cleanupRename db ek src dest -- In case the special remote does not support renaming, -- unexport the src instead. , do warning "rename failed; deleting instead" performUnexport r ea db [ek] src ) cleanupRename :: ExportHandle -> ExportKey -> ExportLocation -> ExportLocation -> CommandCleanup cleanupRename db ek src dest = do liftIO $ do removeExportLocation db (asKey ek) src addExportLocation db (asKey ek) dest -- Flush so that getExportLocation sees this. flushDbQueue db return True