https://github.com/rust-lang/git2-rs

libgit2 bindings for Rust
https://github.com/rust-lang/git2-rs

Last synced: 5 days ago
JSON representation

libgit2 bindings for Rust

• Host: GitHub
• URL: https://github.com/rust-lang/git2-rs
• Owner: rust-lang
• License: apache-2.0
• Created: 2014-08-01T22:30:49.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-12-02T13:53:18.000Z (19 days ago)
• Last Synced: 2024-12-09T16:07:14.667Z (12 days ago)
• Language: Rust
• Homepage: https://docs.rs/git2
• Size: 3.53 MB
• Stars: 1,740
• Watchers: 23
• Forks: 394
• Open Issues: 151
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# git2-rs

[Documentation](https://docs.rs/git2)

libgit2 bindings for Rust.

```toml

[dependencies]

git2 = "0.19.0"

```

## Rust version requirements

git2-rs works with stable Rust, and typically works with the most recent prior

stable release as well.

## Version of libgit2

Currently this library requires libgit2 1.8.1 (or newer patch versions). The

source for libgit2 is included in the libgit2-sys crate so there's no need to

pre-install the libgit2 library, the libgit2-sys crate will figure that and/or

build that for you. On the other hand, if an appropriate version of `libgit2`

is present, `git2` will attempt to dynamically link it.

To be more precise, the vendored `libgit2` is linked statically if two

conditions both hold:

- The environment variable `LIBGIT2_NO_VENDOR=1` is **not** set

- **and** either a) The Cargo feature `vendored-libgit2` is set or b) an

  appropriate version of `libgit2` cannot be found on the system.

In particular, note that the environment variable overrides the Cargo feature.

## Building git2-rs

```sh

$ git clone https://github.com/rust-lang/git2-rs

$ cd git2-rs

$ cargo build

```

### Automating Testing

Running tests and handling all of the associated edge cases on every commit

proves tedious very quickly.  To automate tests and handle proper stashing and

unstashing of unstaged changes and thus avoid nasty surprises, use the

pre-commit hook found [here][pre-commit-hook] and place it into the

`.git/hooks/` with the name `pre-commit`.  You may need to add execution

permissions with `chmod +x`.

To skip tests on a simple commit or doc-fixes, use `git commit --no-verify`.

## Building on macOS 10.10+

If the `ssh` feature is enabled (and it is by default) then this library depends

on libssh2 which depends on OpenSSL. To get OpenSSL working follow the

[`openssl` crate's instructions](https://github.com/sfackler/rust-openssl/blob/master/openssl/src/lib.rs#L31).

# License

This project is licensed under either of

 * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or

   https://www.apache.org/licenses/LICENSE-2.0)

 * MIT license ([LICENSE-MIT](LICENSE-MIT) or

   https://opensource.org/licenses/MIT)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted

for inclusion in git2-rs by you, as defined in the Apache-2.0 license, shall be

dual licensed as above, without any additional terms or conditions.

[pre-commit-hook]: https://gist.github.com/glfmn/0c5e9e2b41b48007ed3497d11e3dbbfa