Gitson

Gitson is a simple document store library for Git + JSON.

Documentation

type TransactionWriter = WriterT [IO ()] IO ()

A transaction monad.

createRepo :: FilePath -> IO ()

Creates a git repository under a given path.

transaction :: FilePath -> TransactionWriter -> IO ()

Executes a blocking transaction on a repository, committing the results to git.

saveEntry :: ToJSON a => FilePath -> String -> a -> TransactionWriter

Adds a write action to a transaction.

saveNextEntry :: ToJSON a => FilePath -> String -> a -> TransactionWriter

Adds a write action to a transaction. The key will start with a numeric id, incremented from the last id in the collection.

listCollections :: IO [FilePath]

Lists collections in the current repository.

listEntryKeys :: FilePath -> IO [String]

Lists entry keys in a collection.

listEntries :: FromJSON a => FilePath -> IO [a]

Lists entries in a collection.

readEntry :: FromJSON a => FilePath -> String -> IO (Maybe a)

Reads an entry from a collection by key.

readEntryById :: FromJSON a => FilePath -> Int -> IO (Maybe a)

Reads an entry from a collection by numeric id (for example, key 00001-hello has id 1)..

readEntryByName :: FromJSON a => FilePath -> String -> IO (Maybe a)

Reads an entry from a collection by name (for example, key 00001-hello has name hello).