gitrevset

A domain-specific-language to select commits in a git repo. Similar to Mercurial's revset.

See the crate documentation for supported functions and operators. More functions might be added over time.

gitrevset provides the Rust library interface. There is also a simple command-line utility git-revs. It takes revset expressions as arguments, and outputs commit hashes.

Examples

Revset Expressions

The current commit (HEAD) and its parent:

. + .^

Merge base (common ancestor) of HEAD and origin/master:

gca(., origin/master)

The bottom of the current local (draft) branch:

roots(draft() & ::.)

Tagged commits since 100 days ago:

tag() & date("since 100 days ago")

Commits by "alice" or "bob" in the "dev" but not "master" branch:

(dev % master) & (author(alice) | author(bob))

Using gitrevset Library

Parse revset from a string at runtime. Execute it and iterate through the Oids:

```rust use gitrevset::{Repo, SetExt};

let repo = Repo::openfromenv()?; let set = repo.revs("(draft() & ::.)^ + .")?; for oid in set.to_oids()? { dbg!(oid?) } ```

Parse at compile time. Interact with local variables like strings, or calculated set:

```rust use gitrevset::{ast, Repo};

let repo = Repo::openfromenv()?; let master = "origin/master"; let stack = repo.revs(ast!(only(".", ref({ master }))))?; let head = repo.revs(ast!(heads({ stack })))?; ```

Using git-revs CLI

bash git revs "(draft() & ::.)^ + ."