Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
shubhexists authored Dec 23, 2023
1 parent b4cfc28 commit 3fa778c
Showing 1 changed file with 33 additions and 12 deletions.
45 changes: 33 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,40 @@ __ __ _ _
\ V / (_| | |_| | | |_
\_/ \__,_|\__,_|_|\__| , simplified version control for local files
```
# Releases
See branches for a specific release of vault.
### About

# References
Release v1.0.0 will take [Reference](https://dev.to/nopenoshishi/make-your-original-git-analyze-section-139d#de) as a reference to build onto it.
Vault is a version control system in Rust, written as a learning project. It follows a similar approach of how Git works i.e.
- Files are stored as Blobs and Directories as Trees.
- SHA256 is used to encode these objects.
- ZLib Compression is used for maximum efficiency.

# Set Up Locally
1) Clone this repository by running the command `git clone https://github.com/shubhexists/vault`.
2) `cd` into the directory and run `cargo build --release`. This will create binaries for the project.
3) Open a new terminal and open `.bashrc` in your favourite editor, say `nano ~/.bashrc`.
4) Export the path of the executable (It is in the `/target/release/` directory .) For eg, it was
For more details, Refer to [Workflow.md](https://github.com/shubhexists/vault/blob/master/src/workFlow.md) (wip)

`export PATH="$PATH:/home/jerry/Desktop/vault/target/release"` for me.
Vault is not suitable for real-world use, but might be of interest for learning about git-internals.

6) Save the file and source the terminal or simple open a new terminal instance.
7) You are not all set to "VAULTIFY" your local files :)
# Installation
You can directly install from [Cargo](https://crates.io/crates/vault_vcs) by
```
cargo install vault_vcs
```

### References
- [Git Book](https://git-scm.com/book/en/v2/Git-Internals-Git-Objects)
- [Article](https://dev.to/nopenoshishi/make-your-original-git-analyze-section-139d#de)

### Contributing
1) Clone this repository by running the command
```
git clone https://github.com/shubhexists/vault
```
2) `cd` into the directory and run
```
cargo build --release
```
This will create binaries for the project.

3) Export the path of the executable (It is in the `/target/release/` directory .) For eg,
```
export PATH="$PATH:/home/jerry/Desktop/vault/target/release"
```
4) You are now all set to "VAULTIFY" your local files :)

0 comments on commit 3fa778c

Please sign in to comment.