package b0

  1. Overview
  2. Docs
Software construction and deployment kit

Install 

dune-project
 Dependency

erratique.ch Readme Changelog ISC; BSD-2-Clause License Edit opam file Versions (2)

Authors

  1. T
    The b0 programmers

Maintainers

  1. Daniel Bünzli

Sources

b0-0.0.6.tbz
sha512=e9aa779e66c08fc763019f16d4706f465d16c05d6400b58fbd0313317ef33ddea51952e2b058db28e65f7ddb7012f328c8bf02d8f1da17bb543348541a2587f0

doc/b0.std/B0_vcs_repo/index.html

Module B0_vcs_repoSource

Version control system (VCS) repositories.

The toplevel module abstracts operations over VCS. The Hg and Git modules offer VCS specific operations.

Dry runs

Sourcetype dry_run = B0_std.Cmd.t -> unit

The type for dry runs. In dry run for effectful operations, the actual command is given to this function and the operation succeeds without performing it.

VCS kinds

Sourcetype kind =
  1. | Git
    (*

    git

    *)
  2. | Hg
    (*

    hg

    *)

The type of VCS supported by the module.

Sourceval pp_kind : kind B0_std.Fmt.t

pp_kind formats kinds of VCS.

Sourceval kind_to_string : kind -> string

kind_to_string k is a string for k.

Sourceval kinds : kind list

kinds is the list of supported VCS.

Repositories

Sourcetype t

The type for VCS repositories.

Sourceval kind : t -> kind

kind r is r's VCS kind.

Sourceval repo_dir : t -> B0_std.Fpath.t

repo_dir r is r's repository directory (not the working directory).

Sourceval work_dir : t -> B0_std.Fpath.t

work_dir r is r's working directory. On a git bare repo this may be B0_std.Fpath.null.

Sourceval repo_cmd : t -> B0_std.Cmd.t

repo_cmd r is the base command to use to act on r. Use only if you need VCS specific functionality not provided by the module. See also Git and Hg.

pp formats a repository. This formats repo_dir.

Sourceval pp_long : t B0_std.Fmt.t

pp_long formats a repository. This formats kind followed by repo_dir.

Finding local repositories

Sourceval find : ?search:B0_std.Cmd.tool_search -> ?kind:kind -> ?dir:B0_std.Fpath.t -> unit -> (t option, string) result

find ~dir () finds, using VCS functionality, a repository starting in directory dir (if unspecified this is the cwd). If kind is specified, will only look for a vcs of kind kind. The VCS tool is looked up with search (default to Os.Cmd.find ?search.

Sourceval get : ?search:B0_std.Cmd.tool_search -> ?kind:kind -> ?dir:B0_std.Fpath.t -> unit -> (t, string) result

get is like find but errors if no VCS was found.

Commits

Sourcetype commit_ish = string

The type for symbols resolving to a commit.

Important, the module uses "HEAD" for specifying the commit currently checkout in the working directory; use this symbol even if the underlying VCS is Hg.

Sourcetype commit_id = string

The type for commit identifiers.

Note. The module sometimes appends the string "-dirty" to these identifiers in which case they are no longer proper identifiers.

Sourceval head : commit_ish

head is "HEAD". A symbol to represent the commit currently checked out in the working directory.

Sourceval commit_id : t -> dirty_mark:bool -> commit_ish -> (commit_id, string) result

commit_id repo ~dirty_mark ~commit_ish is the object name (identifier) of commit_ish. If commit_ish is "HEAD" and dirty_mark is true and the working tree of repo is_dirty, a mark gets appended to the commit identifier.

Sourceval commit_ptime_s : t -> commit_ish -> (int, string) result

commit_ptime_s repo commit_ish is the POSIX time in seconds of commit commit_ish of repository repo.

Sourceval changes : t -> ?after:commit_ish -> ?last:commit_ish -> unit -> ((commit_id * string) list, string) result

changes repo ~after ~last is the list of commits with their one-line synopsis from commit-ish after (defaults to the start of the branch) to commit-ish last (defaults to head).

Sourceval tracked_files : t -> tree_ish:string -> (B0_std.Fpath.t list, string) result

tracked_files repo ~tree_ish are the files tracked by the tree object tree_ish.

Sourceval commit_files : ?stdout:B0_std.Os.Cmd.stdo -> ?stderr:B0_std.Os.Cmd.stdo -> ?msg:string -> t -> B0_std.Fpath.t list -> (unit, string) result

commit_files rrepo ~msg files commits the file files with message msg (if unspecified the VCS should prompt).

pp_commit formats a commit.

Working directory

Sourceval is_dirty : t -> (bool, string) result

is_dirty repo is Ok true iff the working directory of repo has uncommited changes.

Sourceval not_dirty : t -> (unit, string) result

not_dirty repo is Ok () iff the working directory of repo is not dirty and an error that enjoins to stash or commit otherwise.

Sourceval file_is_dirty : t -> B0_std.Fpath.t -> (bool, string) result

file_is_dirty repo file is Ok true iff file has uncommited changes.

Sourceval checkout : ?and_branch:string -> t -> commit_ish -> (unit, string) result

checkout repo ~and_branch commit_ish checks out commit_ish in the working directory of repo. Checks out in a new branch and_branch if provided. This fails if the current working directory is_dirty.

Sourceval local_clone : t -> dir:B0_std.Fpath.t -> (t, string) result

local_clone repo ~dir clones repo to a working directory dir and returns a repo to operate on it.

Sourceval pp_dirty : unit B0_std.Fmt.t

pp_dirty formats the string "dirty".

Tags

Sourcetype tag = string

The type for VCS tags.

Sourceval tags : t -> (tag list, string) result

tags repo is the list of tags in the repo repo.

Sourceval tag : ?dry_run:dry_run -> ?msg:string -> t -> force:bool -> sign:bool -> commit_ish -> tag -> (unit, string) result

tag repo ~force ~sign ~msg commit_ish t tags commit_ish with t and message msg (if unspecified the VCS should prompt). If sign is true (defaults to false) signs the tag (`Git repos only). If force is true (default to false) doesn't fail if the tag already exists.

Sourceval delete_tag : ?dry_run:dry_run -> t -> tag -> (unit, string) result

delete_tag repo t deletes tag t in repo.

Sourceval describe : t -> dirty_mark:bool -> commit_ish -> (string, string) result

describe repo dirty_mark commit_ish identifies commit_ish using tags from repo. If commit_ish is "HEAD" and dirty_mark is true (default) and the working tree of repo is_dirty, a mark gets appended to the description.

Sourceval latest_tag : t -> commit_ish -> (tag option, string) result

latest_tag repo commit_ish finds the latest tag in the current branch describing commit_ish.

Sourceval find_greatest_version_tag : t -> (tag option, string) result

find_latest_version_tag repo lists tags with tags sorts those who parse with B0_std.String.to_version in increasing order and takes the greatest ones.

VCS specific operations

Sourcemodule Git : sig ... end

Git specific operations.

Sourcemodule Hg : sig ... end

Mercurial specific operations.