-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | API library for working with Git repositories
--   
--   <tt>gitlib</tt> is a high-level, lazy and conduit-aware set of
--   abstractions for programming with Git types. Several different
--   backends are available, including one for the libgit2 C library
--   (<a>http://libgit2.github.com</a>) (see <tt>gitlib-libgit2</tt>). The
--   aim is both type-safety and convenience of use for Haskell users,
--   combined with high performance and minimal memory footprint by taking
--   advantage of Haskell's laziness and the conduit library's
--   deterministic resource cleanup.
--   
--   For further information, as well as typical use cases, see
--   <a>Git.Tutorial</a>.
@package gitlib
@version 1.0.1


-- | This module provides a brief introductory tutorial in the
--   "Introduction" section followed by a lengthy discussion of the
--   library's design and idioms.
module Git.Tutorial


-- | Interface for working with Git repositories.
module Git
data RepositoryFacts
RepositoryFacts :: !Bool -> RepositoryFacts
hasSymbolicReferences :: RepositoryFacts -> !Bool
type MonadGit m = (Failure GitException m, Applicative m, MonadIO m, MonadBaseControl IO m)

-- | <a>Repository</a> is the central point of contact between user code
--   and Git data objects. Every object must belong to some repository.
class (Applicative m, Monad m, Failure GitException m, Eq (Oid m), Ord (Oid m), Show (Oid m)) => Repository m where data family Oid m data family TreeData m data family Options m renderOid = renderObjOid . Tagged renderObjOid = renderOid . unTagged createRef_ = (void .) . createRef updateRef_ = (void .) . updateRef allRefs = catMaybes <$> (mapM lookupRef =<< allRefNames) allRefNames = map refName <$> allRefs resolveRef name = lookupRef name >>= referenceToRef (Just name) traverseObjects_ = (void .) . traverseObjects traverseCommits_ = (void .) . traverseCommits buildPackFile _ _ = failure (BackendError "Backend does not support building pack files") buildPackIndex _ _ = failure (BackendError "Backend does not support building pack indexes") writePackFile _ = failure (BackendError "Backend does not support writing  pack files")
facts :: Repository m => m RepositoryFacts
parseOid :: Repository m => Text -> m (Oid m)
renderOid :: Repository m => Oid m -> Text
renderObjOid :: Repository m => Tagged a (Oid m) -> Text
createRef :: Repository m => Text -> RefTarget m (Commit m) -> m (Reference m (Commit m))
createRef_ :: Repository m => Text -> RefTarget m (Commit m) -> m ()
lookupRef :: Repository m => Text -> m (Maybe (Reference m (Commit m)))
updateRef :: Repository m => Text -> RefTarget m (Commit m) -> m (Reference m (Commit m))
updateRef_ :: Repository m => Text -> RefTarget m (Commit m) -> m ()
deleteRef :: Repository m => Text -> m ()
allRefs :: Repository m => m [Reference m (Commit m)]
allRefNames :: Repository m => m [Text]
resolveRef :: Repository m => Text -> m (Maybe (CommitRef m))
lookupCommit :: Repository m => CommitOid m -> m (Commit m)
lookupTree :: Repository m => TreeOid m -> m (Tree m)
lookupBlob :: Repository m => BlobOid m -> m (Blob m)
lookupTag :: Repository m => TagOid m -> m (Tag m)
lookupObject :: Repository m => Text -> m (Object m)
existsObject :: Repository m => Oid m -> m Bool
traverseObjects :: Repository m => (Object m -> m a) -> Maybe (CommitName m) -> m [a]
traverseObjects_ :: Repository m => (Object m -> m ()) -> Maybe (CommitName m) -> m ()
pushCommit :: (Repository m, MonadTrans t, MonadGit m, MonadGit (t m), Repository m, Repository (t m)) => CommitName m -> Maybe Text -> Text -> t m (CommitRef (t m))
traverseCommits :: Repository m => (CommitRef m -> m a) -> CommitName m -> m [a]
traverseCommits_ :: Repository m => (CommitRef m -> m ()) -> CommitName m -> m ()
missingObjects :: Repository m => Maybe (CommitName m) -> CommitName m -> m [Object m]
newTree :: Repository m => m (Tree m)
hashContents :: Repository m => BlobContents m -> m (BlobOid m)
createBlob :: Repository m => BlobContents m -> m (BlobOid m)
createCommit :: Repository m => [CommitRef m] -> TreeRef m -> Signature -> Signature -> Text -> Maybe Text -> m (Commit m)
createTag :: Repository m => CommitOid m -> Signature -> Text -> Text -> m (Tag m)
deleteRepository :: Repository m => m ()
buildPackFile :: Repository m => FilePath -> [Either (CommitOid m) (TreeOid m)] -> m FilePath
buildPackIndex :: Repository m => FilePath -> ByteString -> m (Text, FilePath, FilePath)
writePackFile :: Repository m => FilePath -> m ()
remoteFetch :: Repository m => Text -> Text -> m ()

-- | There is a separate <a>GitException</a> for each possible failure when
--   interacting with the Git repository.
data GitException
BackendError :: Text -> GitException
GitError :: Text -> GitException
RepositoryNotExist :: GitException
RepositoryInvalid :: GitException
RepositoryCannotAccess :: Text -> GitException
BlobCreateFailed :: GitException
BlobEmptyCreateFailed :: GitException
BlobEncodingUnknown :: Text -> GitException
BlobLookupFailed :: GitException
PushNotFastForward :: Text -> GitException
TranslationException :: Text -> GitException
TreeCreateFailed :: Text -> GitException
TreeBuilderCreateFailed :: GitException
TreeBuilderInsertFailed :: Text -> GitException
TreeBuilderRemoveFailed :: Text -> GitException
TreeBuilderWriteFailed :: Text -> GitException
TreeLookupFailed :: GitException
TreeCannotTraverseBlob :: GitException
TreeCannotTraverseCommit :: GitException
TreeEntryLookupFailed :: FilePath -> GitException
TreeUpdateFailed :: GitException
TreeWalkFailed :: GitException
CommitCreateFailed :: GitException
CommitLookupFailed :: Text -> GitException
ReferenceCreateFailed :: GitException
ReferenceDeleteFailed :: Text -> GitException
RefCannotCreateFromPartialOid :: GitException
ReferenceListingFailed :: GitException
ReferenceLookupFailed :: Text -> GitException
ObjectLookupFailed :: Text -> Int -> GitException
ObjectRefRequiresFullOid :: GitException
OidCopyFailed :: GitException
OidParseFailed :: Text -> GitException
QuotaHardLimitExceeded :: Int -> Int -> GitException
type BlobOid m = Tagged (Blob m) (Oid m)
type TreeOid m = Tagged (Tree m) (Oid m)
type CommitOid m = Tagged (Commit m) (Oid m)
type TagOid m = Tagged (Tag m) (Oid m)
data RefTarget m a
RefObj :: !(ObjRef m a) -> RefTarget m a
RefSymbolic :: !Text -> RefTarget m a
data Reference m a
Reference :: !Text -> !(RefTarget m a) -> Reference m a
refName :: Reference m a -> !Text
refTarget :: Reference m a -> !(RefTarget m a)
data CommitName m
CommitObjectId :: !(CommitOid m) -> CommitName m
CommitRefName :: !Text -> CommitName m
CommitReference :: !(Reference m (Commit m)) -> CommitName m
nameOfCommit :: Commit m -> CommitName m
commitNameToRef :: Repository m => CommitName m -> m (Maybe (CommitRef m))
renderCommitName :: Repository m => CommitName m -> Text
copyOid :: (Repository m, MonadGit m, Repository n, MonadGit n) => Oid m -> n (Oid n)
copyCommitOid :: (Repository m, MonadGit m, Repository n, MonadGit n) => CommitOid m -> n (CommitOid n)
copyCommitName :: (Repository m, MonadGit m, Repository n, MonadGit n) => CommitName m -> n (Maybe (CommitName n))
data ObjRef m a
ByOid :: !(Tagged a (Oid m)) -> ObjRef m a
Known :: !a -> ObjRef m a
type BlobRef m = ObjRef m (Blob m)
type TreeRef m = ObjRef m (Tree m)
type CommitRef m = ObjRef m (Commit m)
type TagRef m = ObjRef m (Tag m)
data Object m
BlobObj :: !(BlobRef m) -> Object m
TreeObj :: !(TreeRef m) -> Object m
CommitObj :: !(CommitRef m) -> Object m
TagObj :: !(TagRef m) -> Object m
objectOid :: Repository m => Object m -> m (Oid m)
data Blob m
Blob :: !(BlobOid m) -> !(BlobContents m) -> Blob m
blobOid :: Blob m -> !(BlobOid m)
blobContents :: Blob m -> !(BlobContents m)
blobRefOid :: Repository m => BlobRef m -> BlobOid m
resolveBlobRef :: Repository m => BlobRef m -> m (Blob m)
type ByteSource m = Producer m ByteString
data BlobContents m
BlobString :: !ByteString -> BlobContents m
BlobStream :: !(ByteSource m) -> BlobContents m
BlobSizedStream :: !(ByteSource m) -> !Int -> BlobContents m
data BlobKind
PlainBlob :: BlobKind
ExecutableBlob :: BlobKind
SymlinkBlob :: BlobKind
UnknownBlob :: BlobKind
data TreeEntry m
BlobEntry :: !(BlobOid m) -> !BlobKind -> TreeEntry m
blobEntryOid :: TreeEntry m -> !(BlobOid m)
blobEntryKind :: TreeEntry m -> !BlobKind
TreeEntry :: !(TreeRef m) -> TreeEntry m
treeEntryRef :: TreeEntry m -> !(TreeRef m)
CommitEntry :: !(CommitOid m) -> TreeEntry m
commitEntryRef :: TreeEntry m -> !(CommitOid m)
treeEntryOid :: Repository m => TreeEntry m -> m (Oid m)
blobEntry :: Repository m => BlobOid m -> BlobKind -> TreeEntry m
treeEntry :: Repository m => Tree m -> TreeEntry m
commitEntry :: Repository m => Commit m -> TreeEntry m
data ModifyTreeResult m
TreeEntryNotFound :: ModifyTreeResult m
TreeEntryDeleted :: ModifyTreeResult m
TreeEntryPersistent :: (TreeEntry m) -> ModifyTreeResult m
TreeEntryMutated :: (TreeEntry m) -> ModifyTreeResult m
fromModifyTreeResult :: ModifyTreeResult m -> Maybe (TreeEntry m)
toModifyTreeResult :: (TreeEntry m -> ModifyTreeResult m) -> Maybe (TreeEntry m) -> ModifyTreeResult m

-- | A <a>Tree</a> is anything that is <a>treeish</a>.
--   
--   Minimal complete definition: <a>modifyTree</a>. Note that for some
--   treeish things, like Tags, it should always be an error to attempt to
--   modify the tree in any way.
data Tree m
Tree :: (FilePath -> Bool -> (Maybe (TreeEntry m) -> m (ModifyTreeResult m)) -> m (Maybe (TreeEntry m))) -> (FilePath -> m (Maybe (TreeEntry m))) -> (FilePath -> TreeEntry m -> m ()) -> (FilePath -> BlobOid m -> BlobKind -> m ()) -> (FilePath -> BlobOid m -> m ()) -> (FilePath -> TreeRef m -> m ()) -> (FilePath -> CommitOid m -> m ()) -> (FilePath -> m ()) -> m (TreeOid m) -> (forall a. (FilePath -> TreeEntry m -> m a) -> m [a]) -> ((FilePath -> TreeEntry m -> m ()) -> m ()) -> !(TreeData m) -> Tree m
modifyTree :: Tree m -> FilePath -> Bool -> (Maybe (TreeEntry m) -> m (ModifyTreeResult m)) -> m (Maybe (TreeEntry m))
lookupEntry :: Tree m -> FilePath -> m (Maybe (TreeEntry m))
putTreeEntry :: Tree m -> FilePath -> TreeEntry m -> m ()
putBlob' :: Tree m -> FilePath -> BlobOid m -> BlobKind -> m ()
putBlob :: Tree m -> FilePath -> BlobOid m -> m ()
putTree :: Tree m -> FilePath -> TreeRef m -> m ()
putCommit :: Tree m -> FilePath -> CommitOid m -> m ()
dropFromTree :: Tree m -> FilePath -> m ()
writeTree :: Tree m -> m (TreeOid m)
traverseEntries :: Tree m -> forall a. (FilePath -> TreeEntry m -> m a) -> m [a]
traverseEntries_ :: Tree m -> (FilePath -> TreeEntry m -> m ()) -> m ()
getTreeData :: Tree m -> !(TreeData m)
mkTree :: Repository m => (Tree m -> FilePath -> Bool -> (Maybe (TreeEntry m) -> m (ModifyTreeResult m)) -> m (Maybe (TreeEntry m))) -> (Tree m -> m (TreeOid m)) -> (forall a. Tree m -> (FilePath -> TreeEntry m -> m a) -> m [a]) -> TreeData m -> Tree m
treeRef :: Tree m -> TreeRef m
treeRefOid :: Repository m => TreeRef m -> m (TreeOid m)
resolveTreeRef :: Repository m => TreeRef m -> m (Tree m)
data Signature
Signature :: !Text -> !Text -> !ZonedTime -> Signature
signatureName :: Signature -> !Text
signatureEmail :: Signature -> !Text
signatureWhen :: Signature -> !ZonedTime
data Commit m
Commit :: !(CommitOid m) -> ![CommitRef m] -> !(TreeRef m) -> !Signature -> !Signature -> !Text -> !Text -> Commit m
commitOid :: Commit m -> !(CommitOid m)
commitParents :: Commit m -> ![CommitRef m]
commitTree :: Commit m -> !(TreeRef m)
commitAuthor :: Commit m -> !Signature
commitCommitter :: Commit m -> !Signature
commitLog :: Commit m -> !Text
commitEncoding :: Commit m -> !Text
commitRef :: Commit m -> CommitRef m
commitRefTarget :: Commit c -> RefTarget m (Commit c)
commitRefOid :: Repository m => CommitRef m -> CommitOid m
resolveCommitRef :: Repository m => CommitRef m -> m (Commit m)
referenceToRef :: Repository m => Maybe Text -> Maybe (Reference m (Commit m)) -> m (Maybe (CommitRef m))
data Tag m
Tag :: !(TagOid m) -> !(CommitRef m) -> Tag m
tagOid :: Tag m -> !(TagOid m)
tagCommit :: Tag m -> !(CommitRef m)
tagRefOid :: Repository m => TagRef m -> TagOid m
data ModificationKind
Unchanged :: ModificationKind
Modified :: ModificationKind
Added :: ModificationKind
Deleted :: ModificationKind
TypeChanged :: ModificationKind
data MergeStatus
NoConflict :: MergeStatus
BothModified :: MergeStatus
LeftModifiedRightDeleted :: MergeStatus
LeftDeletedRightModified :: MergeStatus
BothAdded :: MergeStatus
LeftModifiedRightTypeChanged :: MergeStatus
LeftTypeChangedRightModified :: MergeStatus
LeftDeletedRightTypeChanged :: MergeStatus
LeftTypeChangedRightDeleted :: MergeStatus
BothTypeChanged :: MergeStatus
mergeStatus :: ModificationKind -> ModificationKind -> MergeStatus
data MergeResult m
MergeSuccess :: CommitOid m -> MergeResult m
mergeCommit :: MergeResult m -> CommitOid m
MergeConflicted :: CommitOid m -> CommitOid m -> CommitOid m -> Map FilePath (ModificationKind, ModificationKind) -> MergeResult m
mergeCommit :: MergeResult m -> CommitOid m
mergeHeadLeft :: MergeResult m -> CommitOid m
mergeHeadRight :: MergeResult m -> CommitOid m
mergeConflicts :: MergeResult m -> Map FilePath (ModificationKind, ModificationKind)
copyConflict :: (Repository m, MonadGit m, Repository n, MonadGit n) => MergeResult m -> n (MergeResult n)
data RepositoryOptions
RepositoryOptions :: !FilePath -> !Bool -> !Bool -> RepositoryOptions
repoPath :: RepositoryOptions -> !FilePath
repoIsBare :: RepositoryOptions -> !Bool
repoAutoCreate :: RepositoryOptions -> !Bool
data RepositoryFactory t m c
RepositoryFactory :: (RepositoryOptions -> m c) -> (forall a. c -> t m a -> m a) -> (c -> m ()) -> t m c -> !RepositoryOptions -> m () -> m () -> RepositoryFactory t m c
openRepository :: RepositoryFactory t m c -> RepositoryOptions -> m c
runRepository :: RepositoryFactory t m c -> forall a. c -> t m a -> m a
closeRepository :: RepositoryFactory t m c -> c -> m ()
getRepository :: RepositoryFactory t m c -> t m c
defaultOptions :: RepositoryFactory t m c -> !RepositoryOptions
startupBackend :: RepositoryFactory t m c -> m ()
shutdownBackend :: RepositoryFactory t m c -> m ()
withBackendDo :: (MonadIO m, MonadBaseControl IO m) => RepositoryFactory t m a -> m b -> m b
withRepository' :: (Repository (t m), MonadTrans t, MonadBaseControl IO m, MonadIO m) => RepositoryFactory t m c -> RepositoryOptions -> t m a -> m a
withRepository :: (Repository (t m), MonadTrans t, MonadBaseControl IO m, MonadIO m) => RepositoryFactory t m c -> FilePath -> t m a -> m a
instance Typeable GitException
instance Show RepositoryFacts
instance Eq GitException
instance Show GitException
instance Show BlobKind
instance Eq BlobKind
instance Enum BlobKind
instance Show Signature
instance Eq ModificationKind
instance Ord ModificationKind
instance Enum ModificationKind
instance Show ModificationKind
instance Read ModificationKind
instance Eq MergeStatus
instance Ord MergeStatus
instance Enum MergeStatus
instance Show MergeStatus
instance Read MergeStatus
instance Default RepositoryOptions
instance Repository m => Show (MergeResult m)
instance Default Signature
instance Eq (BlobContents m)
instance Repository m => Show (CommitName m)
instance Exception GitException