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


-- | Create a temporary database that is deleted after performing some operation
--   
--   Please see README.md
@package postgres-tmp
@version 0.1.0.1


-- | Create temporary postgresql databases.
--   
--   The main usecase for this are tests where you don’t want to assume
--   that a certain database exists.
module Database.PostgreSQL.Tmp

-- | Convenience wrapper for <a>withTmpDB'</a> using <a>defaultDB</a>
withTmpDB :: (DBInfo -> IO a) -> IO a

-- | Create a temporary database and a temporary role that the callback can
--   operate on. After the action has finished the database and the role
--   are destroyed.
--   
--   This function assumes that the connection string points to a database
--   containing the tables called <tt>pg_roles</tt> and
--   <tt>pg_database</tt> and that the user has the <tt>CREATEDB</tt> and
--   <tt>CREATEROLE</tt> privileges.
withTmpDB' :: ByteString -> (DBInfo -> IO a) -> IO a

-- | Create a new role that does not already exist and return its name.
--   
--   The new role does not have a password and has the <tt>CREATEDB</tt>
--   privilege. The database that the connection points to is assumed to
--   contain a table called <tt>pg_roles</tt> with a <tt>rolname</tt>
--   column.
newRole :: Connection -> IO Text

-- | Create a new database that is owned by the user.
newDB :: Connection -> Text -> IO Text

-- | Connection string for the <tt>postgres</tt> database owned by the
--   <tt>postgres</tt> user
defaultDB :: ByteString

-- | The data necessary to connect to the temporary database
data DBInfo
DBInfo :: Text -> Text -> DBInfo
[dbName] :: DBInfo -> Text
[roleName] :: DBInfo -> Text
instance GHC.Classes.Ord Database.PostgreSQL.Tmp.DBInfo
instance GHC.Classes.Eq Database.PostgreSQL.Tmp.DBInfo
instance GHC.Read.Read Database.PostgreSQL.Tmp.DBInfo
instance GHC.Show.Show Database.PostgreSQL.Tmp.DBInfo