4 releases (2 stable)

1.0.1 May 19, 2024
0.2.0 Mar 4, 2024
0.1.0 Jan 27, 2024

#20 in #root-directory

Download history 40/week @ 2024-07-23 12/week @ 2024-07-30 2/week @ 2024-09-17 11/week @ 2024-09-24

230 downloads per month

MIT/Apache

91KB
2.5K SLoC

rgit: A git implementation in Rust

codecov

This is a simple git implementation in Rust heavily inspired from James Coglan's Building Git. It is a work in progress and is not yet fully functional. This is in no way a replacement for the original git (though you can use it for toying around), but rather a learning exercise to understand how git works under the hood and to get a better understanding of Rust.

Currently, the following commands are implemented:

  1. rgit init <optional root directory>: Initialize a new git repository
  2. rgit add <file(s)>: Add a file(s) to the staging area
  3. rgit commit -m <message>: Commit the staged files
  4. rgit status: Show the status of the working directory
  5. rgit diff: Show the difference between the working directory and the staging area
  6. rgit diff --cached: Show the difference between the staging area and the last commit

Note: For commit to work, you need to have the following evnironment variables set:

export RGIT_AUTHOR_NAME="Your Name"
export RGIT_AUTHOR_EMAIL="youremail@gmail.com"

This is because the commit command extracts the author name and email from these environment variables.

Installation

To install rgit, clone the repository and run the following command:

cargo build --release

This will create an executable in the target/release directory. You can then add this directory to your PATH to use rgit from anywhere like this:

export PATH=$PATH:/path/to/rgit/target/release/r_git

Usage

~/test_rgit git:(master)  rgit
r_git 1.0.0
Chandra Kiran G
A simple git clone written in Rust

Usage:
  r_git <COMMAND>

Commands:
  init    Initialize a new git repository
  commit  Commit the changes in the working tree
  status  Show the working tree status
  add     Add file contents to the index
  diff    Show diff
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

Local Development

To run the tests, use the following command:

cargo test -- --test-threads=1

This is necessary because the few tests modify the same repository and run concurrently, which can cause issues. The --test-threads=1 flag ensures that the tests run sequentially.

Dependencies

~7–16MB
~210K SLoC