module Handler.Haddock where import Import import Data.BlobStore import Filesystem (removeTree, isDirectory, createTree, isFile, rename, removeFile, removeDirectory) import Control.Concurrent (forkIO) import System.IO.Temp (withSystemTempFile, withTempFile) import System.Process (createProcess, proc, cwd, waitForProcess) import System.Exit (ExitCode (ExitSuccess)) import Network.Mime (defaultMimeLookup) import Crypto.Hash.Conduit (sinkHash) import System.IO (IOMode (ReadMode), withBinaryFile) import Data.Conduit.Zlib (gzip) import System.Posix.Files (createLink) import qualified Data.ByteString.Base16 as B16 import Data.Byteable (toBytes) import Crypto.Hash (Digest, SHA1) import qualified Filesystem.Path.CurrentOS as F import Data.Slug (SnapSlug) import qualified Data.Text as T import Data.Slug (unSlug) import qualified Data.Yaml as Y import Data.Aeson (withObject) form :: Form FileInfo form = renderDivs $ areq fileField "tarball containing docs" { fsName = Just "tarball" } Nothing getUploadHaddockR, putUploadHaddockR :: Text -> Handler Html getUploadHaddockR slug0 = do uid <- requireAuthIdOrToken Entity sid Stackage {..} <- runDB $ do -- Provide fallback for old URLs ment <- getBy $ UniqueStackage $ PackageSetIdent slug0 case ment of Just ent -> return ent Nothing -> do slug <- maybe notFound return $ fromPathPiece slug0 getBy404 $ UniqueSnapshot slug let ident = stackageIdent slug = stackageSlug unless (uid == stackageUser) $ permissionDenied "You do not control this snapshot" ((res, widget), enctype) <- runFormPostNoToken form case res of FormSuccess fileInfo -> do fileSource fileInfo $$ storeWrite (HaddockBundle ident) runDB $ update sid [StackageHasHaddocks =. True] master <- getYesod void $ liftIO $ forkIO $ haddockUnpacker master True ident setMessage "Haddocks uploaded" redirect $ SnapshotR slug StackageHomeR _ -> defaultLayout $ do setTitle "Upload Haddocks" $(widgetFile "upload-haddock") putUploadHaddockR = getUploadHaddockR getHaddockR :: SnapSlug -> [Text] -> Handler () getHaddockR slug rest = do ident <- runDB $ do ment <- getBy $ UniqueSnapshot slug case ment of Just ent -> return $ stackageIdent $ entityVal ent Nothing -> do Entity _ stackage <- getBy404 $ UniqueStackage $ PackageSetIdent $ toPathPiece slug redirectWith status301 $ HaddockR (stackageSlug stackage) rest mapM_ sanitize rest dirs <- getDirs -- (gzdir, rawdir) <- getHaddockDir ident master <- getYesod liftIO $ haddockUnpacker master False ident let rawfp = dirRawFp dirs ident rest gzfp = dirGzFp dirs ident rest mime = defaultMimeLookup $ fpToText $ filename rawfp whenM (liftIO $ isDirectory rawfp) $ redirect $ HaddockR slug $ rest ++ ["index.html"] whenM (liftIO $ isDirectory gzfp) $ redirect $ HaddockR slug $ rest ++ ["index.html"] whenM (liftIO $ isFile gzfp) $ do addHeader "Content-Encoding" "gzip" sendFile mime $ fpToString gzfp -- Note: There's a small race window here, where the compressor thread -- could pull the rug out from under us. We can work around this by opening -- the file and, if that fails, try the compressed version again. whenM (liftIO $ isFile rawfp) $ sendFile mime $ fpToString rawfp notFound where sanitize p | ("/" `isInfixOf` p) || p `member` (asHashSet $ setFromList ["", ".", ".."]) = permissionDenied "Invalid request" | otherwise = return () getHaddockDir :: PackageSetIdent -> Handler (FilePath, FilePath) getHaddockDir ident = do master <- getYesod return $ mkDirPair (haddockRootDir master) ident mkDirPair :: FilePath -- ^ root -> PackageSetIdent -> (FilePath, FilePath) -- ^ compressed, uncompressed mkDirPair root ident = ( root "idents-raw" fpFromText (toPathPiece ident) , root "idents-gz" fpFromText (toPathPiece ident) ) createCompressor :: Dirs -> IO (IORef Text, IO ()) -- ^ action to kick off compressor again createCompressor dirs = do baton <- newMVar () status <- newIORef "Compressor is idle" mask_ $ void $ forkIO $ (finallyE $ \e -> writeIORef status $ "Compressor thread exited: " ++ tshow e) $ forever $ do writeIORef status "Waiting for signal to start compressing" takeMVar baton writeIORef status "Received signal, traversing directories" let rawRoot = dirRawRoot dirs whenM (isDirectory rawRoot) $ runResourceT $ goDir status rawRoot return (status, void $ tryPutMVar baton ()) where finallyE f g = mask $ \restore -> do restore g `catch` \e -> do () <- f $ Just (e :: SomeException) () <- throwIO e return () f Nothing goDir status dir = do writeIORef status $ "Compressing directory: " ++ fpToText dir sourceDirectory dir $$ mapM_C (goFP status) liftIO $ void $ tryIO $ removeDirectory dir goFP status fp = do e <- liftIO $ isFile fp if e then liftIO $ do writeIORef status $ "Compressing file: " ++ fpToText fp handle (print . asSomeException) $ gzipHash dirs suffix else goDir status fp where Just suffix = F.stripPrefix (dirRawRoot dirs "") fp -- Procedure is to: -- -- * Gzip the src file to a temp file, and get a hash of the gzipped contents -- * If that hash doesn't exist in the cache, move the new file to the cache -- * Create a hard link from dst to the file in the cache -- * Delete src gzipHash :: Dirs -> FilePath -- ^ suffix -> IO () gzipHash dirs suffix = do withTempFile (fpToString $ dirCacheRoot dirs) "haddock-file.gz" $ \tempfp temph -> do digest <- withBinaryFile (fpToString src) ReadMode $ \inh -> sourceHandle inh $= gzip $$ (getZipSink $ ZipSink (sinkHandle temph) *> ZipSink sinkHash) hClose temph let fpcache = dirCacheFp dirs digest unlessM (isFile fpcache) $ do createTree $ F.parent fpcache rename (fpFromString tempfp) fpcache createTree $ F.parent dst createLink (fpToString fpcache) (fpToString dst) removeFile src where src = dirRawRoot dirs suffix dst = dirGzRoot dirs suffix data Dirs = Dirs { dirRawRoot :: !FilePath , dirGzRoot :: !FilePath , dirCacheRoot :: !FilePath } getDirs :: Handler Dirs getDirs = mkDirs . haddockRootDir <$> getYesod mkDirs :: FilePath -> Dirs mkDirs dir = Dirs { dirRawRoot = dir "idents-raw" , dirGzRoot = dir "idents-gz" , dirCacheRoot = dir "cachedir" } dirGzIdent, dirRawIdent :: Dirs -> PackageSetIdent -> FilePath dirGzIdent dirs ident = dirGzRoot dirs fpFromText (toPathPiece ident) dirRawIdent dirs ident = dirRawRoot dirs fpFromText (toPathPiece ident) dirGzFp, dirRawFp :: Dirs -> PackageSetIdent -> [Text] -> FilePath dirGzFp dirs ident rest = dirGzIdent dirs ident mconcat (map fpFromText rest) dirRawFp dirs ident rest = dirRawIdent dirs ident mconcat (map fpFromText rest) dirCacheFp :: Dirs -> Digest SHA1 -> FilePath dirCacheFp dirs digest = dirCacheRoot dirs fpFromText x fpFromText y <.> "gz" where name = decodeUtf8 $ B16.encode $ toBytes digest (x, y) = splitAt 2 name -- Should have two threads: one to unpack, one to convert. Never serve the -- uncompressed files, only the compressed files. When serving, convert on -- demand. createHaddockUnpacker :: FilePath -- ^ haddock root -> BlobStore StoreKey -> (forall a m. (MonadIO m, MonadBaseControl IO m) => SqlPersistT m a -> m a) -> IO (IORef Text, ForceUnpack -> PackageSetIdent -> IO ()) createHaddockUnpacker root store runDB' = do createTree $ dirCacheRoot dirs createTree $ dirRawRoot dirs createTree $ dirGzRoot dirs chan <- newChan (statusRef, compressor) <- createCompressor dirs mask $ \restore -> void $ forkIO $ forever $ do (forceUnpack, ident, res) <- readChan chan try (restore $ go forceUnpack ident) >>= putMVar res compressor return (statusRef, \forceUnpack ident -> do shouldAct <- if forceUnpack then return True else not <$> doDirsExist ident if shouldAct then do res <- newEmptyMVar writeChan chan (forceUnpack, ident, res) takeMVar res >>= either (throwM . asSomeException) return else return ()) where dirs = mkDirs root doDirsExist ident = do e1 <- isDirectory $ dirGzIdent dirs ident if e1 then return True else isDirectory $ dirRawIdent dirs ident go forceUnpack ident = do toRun <- if forceUnpack then do removeTree $ dirRawIdent dirs ident removeTree $ dirGzIdent dirs ident return True else not <$> doDirsExist ident when toRun $ do withSystemTempFile "haddock-bundle.tar.xz" $ \tempfp temph -> do withAcquire (storeRead' store (HaddockBundle ident)) $ \msrc -> case msrc of Nothing -> error "No haddocks exist for that snapshot" Just src -> src $$ sinkHandle temph hClose temph createTree $ dirRawIdent dirs ident let destdir = dirRawIdent dirs ident (Nothing, Nothing, Nothing, ph) <- createProcess (proc "tar" ["xf", tempfp]) { cwd = Just $ fpToString destdir } ec <- waitForProcess ph if ec == ExitSuccess then return () else throwM ec -- Determine which packages have documentation and update the -- database appropriately runResourceT $ runDB' $ do ment <- getBy $ UniqueStackage ident forM_ ment $ \(Entity sid _) -> do updateWhere [PackageStackage ==. sid] [PackageHasHaddocks =. False] sourceDirectory destdir $$ mapM_C (\fp -> do let (name', version) = T.breakOnEnd "-" $ fpToText $ filename fp mname = stripSuffix "-" name' forM_ mname $ \name -> updateWhere [ PackageStackage ==. sid , PackageName' ==. PackageName name , PackageVersion ==. Version version ] [PackageHasHaddocks =. True] ) data DocInfo = DocInfo Version (Map Text [Text]) instance FromJSON DocInfo where parseJSON = withObject "DocInfo" $ \o -> DocInfo <$> (Version <$> o .: "version") <*> o .: "modules" getUploadDocMapR :: Handler Html getUploadDocMapR = do uid <- requireAuthIdOrToken user <- runDB $ get404 uid extra <- getExtra when (unSlug (userHandle user) `notMember` adminUsers extra) $ permissionDenied "Must be an administrator" ((res, widget), enctype) <- runFormPostNoToken $ renderDivs $ (,) <$> areq fileField "YAML file with map" { fsName = Just "docmap" } Nothing <*> areq textField "Stackage ID" { fsName = Just "snapshot" } Nothing case res of FormSuccess (fi, snapshot) -> do Entity sid stackage <- runDB $ getBy404 $ UniqueStackage $ PackageSetIdent snapshot bs <- fileSource fi $$ foldC case Y.decodeEither bs of Left e -> invalidArgs [pack e] Right m0 -> do now <- liftIO getCurrentTime render <- getUrlRender runDB $ forM_ (mapToList $ asMap m0) $ \(package, DocInfo version ms) -> do did <- insert $ Docs (PackageName package) version now forM_ (mapToList ms) $ \(name, pieces) -> do let url = render $ HaddockR (stackageSlug stackage) pieces insert_ $ Module did name url setMessage "Doc map complete" redirect UploadDocMapR _ -> defaultLayout $ do setTitle "Upload doc map" [whamlet|
^{widget} |] putUploadDocMapR :: Handler Html putUploadDocMapR = getUploadDocMapR