aboutsummaryrefslogblamecommitdiffstats
path: root/lib/abstract/Storage.ml
blob: e189cd7d62d694a518389e64373e0544ba3c72ca (plain) (tree)
1
2
3
4
5
6
7
8
9
10


                         

                                                             
                                                                                                
 


                                                                             
                                                

                                                                              


                                                                                   
                                         

                                                                         
                                        
                                                                        

                                                     
                                                                                                   
 
                                                                   
                                                                                                    
   
module type STORAGE = sig
  type connection
  type transaction
  type address = Label of string | Hash of Concepts.Hash.hash

  val connect : Concepts.Configuration.term -> (connection, Concepts.Condition.condition) result

  (** close `connection`, after which none of its transactions may be used *)
  val disconnect : connection -> unit

  (** begin a transaction within `connection` *)
  val start : connection -> (transaction, Concepts.Condition.condition) result

  (** begin a read-only transaction, which may be held alongside others *)
  val start_read : connection -> (transaction, Concepts.Condition.condition) result

  (** `commit` the current transaction *)
  val commit : transaction -> (unit, Concepts.Condition.condition) result

  (** `abort` the current transaction *)
  val abort : transaction -> (unit, Concepts.Condition.condition) result

  (** within a transaction, fetch a blob from disk *)
  val get : transaction -> address -> (Concepts.Blob.t option, Concepts.Condition.condition) result

  (** within a transaction, associate a hash with a blob on disk *)
  val put : transaction -> address -> Concepts.Blob.t -> (unit, Concepts.Condition.condition) result
end