package git

  1. Overview
  2. Docs
Git format and protocol in pure OCaml

Install

Dune Dependency

Authors

Maintainers

Sources

git-2.0.0.tbz
sha256=65298ea59b0c6163dd4e110caeb59f71a7643acf469c75de20aeb5099b9cb2f6
md5=9d7200e8eb15325e3bf37199f6255826

Description

Support for on-disk and in-memory Git stores. Can read and write all the Git objects: the usual blobs, trees, commits and tags but also the pack files, pack indexes and the index file (where the staging area lives).

All the objects share a consistent API, and convenience functions are provided to manipulate the different objects.

Published: 17 Oct 2018

README

ocaml-git -- Git format and protocol in pure OCaml

Support for on-disk and in-memory Git stores. Can read and write all the Git objects: the usual blobs, trees, commits and tags but also the pack files, pack indexes and the index file (where the staging area lives).

All the objects share a consistent API, and convenience functions are provided to manipulate the different objects. For instance, it is possible to make a pack file position independent (as the Zlib compression might change the relative offsets between the packed objects), to generate pack indexes from pack files, or to expand the filesystem of a given commit.

The library comes with a command-line tool called ogit which shares a similar interface with git, but where all operations are mapped to the API exposed ocaml-git (and hence using only OCaml code).

The API documentation is available online.

Build and Install Instructions

To build and install the project, simply run:

$ opam install git

What is supported

  • The loose object files can be read and written;

  • The pack files (collections of compressed loose objects using a binary-diff representation) and pack indexes (indexes of pack files) can be read and written). The binary diff hunks are exposed using a high-level position-independent representation so that they can be manipulated more easily. Pack file can be created but will not be compressed yet.

  • The index file (used as for managing the staging area) are fully supported. Which means that git diff and git status will work as expected on a repository created by the library.

  • Cloning and fetching (using various options) are fully supported for the Git protocol, the smart-HTTP protocol and git+ssh. A subset of the protocol capabilities are implemented (mainly thin-pack, ofs-delta, side-band-64k and allow-reachable-sha1-in-want).

  • Pushing is still experimental and needs more testing.

  • An abstraction for Git Store Is available. Various store implementations are available:

What is not supported

  • No server-side operations are currently supported.

  • No GC.

  • Updates, merge and rebase are not supported. Use irmin instead.

Performance

Performance is comparable to the Git tool.

Example

# #require "git.unix";;
# open Lwt.Infix;;
# open Git_unix;;
# module Search = Git.Search.Make(FS);;

# let read file =
    FS.create ~root:"." () >>= fun t ->
    FS.read_reference_exn t Git.Reference.master >>= fun head ->
    Search.find t head (`Commit (`Path file)) >>= function
    | None     -> failwith "file not found"
    | Some sha -> FS.read_exn t sha >>= function
      | Git.Value.Blob b -> Lwt.return (Git.Blob.to_raw b)
      | _ -> failwith "not a valid path"
 ;;
 val read : string list -> string Lwt.t = <fun>

# Lwt_main.run (read ["README.md"] >|= print_string)

ocaml-git -- Git format and protocol in pure OCaml

Support for on-disk and in-memory Git stores. Can read and write all
the Git objects: the usual blobs, trees, commits and tags but also
the pack files, pack indexes and the index file (where the staging area
lives).

[...]

License

MIT, see LICENSE.md file for its text.

Dependencies (20)

  1. ocamlgraph
  2. cstruct
  3. astring
  4. fmt
  5. logs
  6. rresult
  7. ocplib-endian
  8. hex
  9. duff < "0.3"
  10. encore < "0.3"
  11. checkseum >= "0.0.3" & < "0.5.0"
  12. decompress >= "0.8.1" & < "0.9.0"
  13. lru >= "0.2.0" & < "0.3.0"
  14. digestif >= "0.7" & < "1.0.0"
  15. fpath >= "0.7.0"
  16. angstrom >= "0.9.0" & < "0.14.0"
  17. lwt >= "2.4.7"
  18. uri >= "1.9.0"
  19. dune
  20. ocaml >= "4.03.0"

Dev Dependencies (4)

  1. mtime with-test & >= "1.0.0" & < "2.0.0"
  2. tls with-test & < "1.0.0"
  3. nocrypto with-test & >= "0.5.4"
  4. alcotest with-test & >= "0.8.1"

Used by (10)

  1. datakit != "0.12.0"
  2. dog
  3. git-http = "2.0.0"
  4. git-mirage != "1.11.4" & < "2.1.0"
  5. imaplet-lwt >= "0.1.3"
  6. irmin >= "0.9.0" & != "0.10.1" & < "0.11.1"
  7. irmin-indexeddb >= "2.0"
  8. irmin-unix < "0.9.9"
  9. merge-queues >= "0.2.0"
  10. plotkicadsch >= "0.5.0" & < "0.9.0"

Conflicts

None

OCaml

Innovation. Community. Security.