package irmin-git
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=b90957bf1b03488447105659694b2fab234f256c8b721fe11b35fb12df760e27
sha512=68e7a772f46c4b93779b4d9e234b60c71b04b7b72f6f8f528e402caa78d5576c1aa92836cf6a940611e3729b6b48d0a6de93c40aec1dcea5c46937f8b3b4331e
Description
Irmin_git
expose a bi-directional bridge between Git repositories and
Irmin stores.
Published: 21 Nov 2019
README
Irmin - A distributed database built on the same principles as Git
Irmin is an OCaml library for building mergeable, branchable distributed data stores.
Features
Built-in snapshotting - backup and restore
Storage agnostic - you can use Irmin on top of your own storage layer
Custom datatypes - (de)serialization for custom data types
Highly portable - runs anywhere from Linux to web browsers and Xen unikernels
Git compatibility -
irmin-git
uses an on-disk format that can be inspected and modified using GitDynamic behavior - allows the users to define custom merge functions, use in-memory transactions (to keep track of reads as well as writes) and to define event-driven workflows using a notification mechanism
Documentation
Documentation can be found online at https://mirage.github.io/irmin
Installation
To install Irmin, the command-line tool and all optional dependencies using opam:
opam install irmin-unix
A minimal installation, with no storage backends can be installed by running:
opam install irmin
To only install the in-memory storage backend:
opam install irmin-mem
The following packages have been made available on opam
:
irmin
- the base package, no storage implementationsirmin-chunk
- chunked storageirmin-fs
- filesystem-based storage usingbin_prot
irmin-git
- Git compatible storageirmin-graphql
- GraphQL serverirmin-http
- a simple REST interfaceirmin-mem
- in-memory storage implementationirmin-mirage
- mirage compatibilityirmin-mirage-git
- Git compatible storage for mirageirmin-mirage-graphql
- mirage compatible GraphQL serverirmin-unix
- unix compatibilityirmin-pack
- compressed, on-disk, posix backend
For more information about an individual package consult the online documentation
Examples
Below is a simple example of setting a key and getting the value out of a Git based, filesystem-backed store.
open Lwt.Infix
(* Irmin store with string contents *)
module Store = Irmin_unix.Git.FS.KV(Irmin.Contents.String)
(* Database configuration *)
let config = Irmin_git.config ~bare:true "/tmp/irmin/test"
(* Commit author *)
let author = "Example <example@example.com>"
(* Commit information *)
let info fmt = Irmin_unix.info ~author fmt
let main =
(* Open the repo *)
Store.Repo.v config >>=
(* Load the master branch *)
Store.master >>= fun t ->
(* Set key "foo/bar" to "testing 123" *)
Store.set t ~info:(info "Updating foo/bar") ["foo"; "bar"] "testing 123" >>= fun () ->
(* Get key "foo/bar" and print it to stdout *)
Store.get t ["foo"; "bar"] >|= fun x ->
Printf.printf "foo/bar => '%s'\n" x
(* Run the program *)
let () = Lwt_main.run main
The example is contained in examples/readme.ml
. It can be compiled and executed with dune:
$ dune build examples/readme.exe
$ dune exec examples/readme.exe
foo/bar => 'testing 123'
The examples/
directory also contains more advanced examples, which can be executed in the same way.
Command-line
The same thing can also be accomplished using irmin
, the command-line application installed with irmin-unix
, by running:
$ echo "root: ." > irmin.yml
$ irmin init
$ irmin set foo/bar "testing 123"
$ irmin get foo/bar
irmin.yml
allows for irmin
flags to be set on a per-directory basis. You can also set flags globally using $HOME/.irmin/config.yml
. Run irmin help irmin.yml
for further details.
Also see irmin --help
for list of all commands and either irmin <command> --help
or irmin help <command>
for more help with a specific command.
Issues
Feel free to to report any issues using the Github bugtracker.
Conditions
See the LICENSE file.
Acknowledgements
Development of Irmin was supported in part by the EU FP7 User-Centric Networking project, Grant No. 611001.
Dependencies (5)
Dev Dependencies (4)
-
mtime
with-test & >= "1.0.0"
-
git-unix
with-test & >= "2.1.1"
-
irmin-mem
with-test & >= "2.0.0" & < "2.2.0"
-
irmin-test
with-test & >= "2.0.0" & < "2.2.0"
Used by (4)
-
irmin-http
= "2.0.0"
-
irmin-indexeddb
>= "2.0"
-
irmin-mirage-git
< "2.2.0"
-
irmin-unix
>= "2.0.0" & < "2.2.0"
Conflicts
None