1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
# gfold
[](https://github.com/nickgerace/gfold/releases/latest)
[](https://crates.io/crates/gfold)
[](https://docs.rs/gfold)
[](https://github.com/nickgerace/gfold/actions?query=workflow%3Amerge+branch%3Amain)
[](./LICENSE)
`gfold` is a CLI-driven application that helps you keep track of multiple Git repositories.
```sh
% gfold
astrid unclean main git@github.com:db/astrid.git
fev bare main https://github.com/institute/fev.git
gb unpushed dev https://github.com/hrothgar/gb.git
neloth unclean patch git@github.com:telvanni/neloth.git
pam clean main https://github.com/onc/pam.git
prime clean issue2287 git@github.com:bos/prime.git
```
## Description and Motivation
This app displays relevant information for multiple Git repositories in one to many directories.
While this tool might seem limited in scope and purpose, that is by design.
It prints each repository in alphabetical order, and pads each result based on the longest directory, branch, and status string.
By default, `gfold` looks at every Git repository via traversal from the current working directory.
However, if you would like to target another directory, you can pass that path (relative or absolute) as the first argument.
## Installation
There multiple methods for installing `gfold`.
### Homebrew and Linux Brew
You can use [macOS Homebrew](https://brew.sh) or [Linuxbrew](https://docs.brew.sh/Homebrew-on-Linux) to install the [tap](https://github.com/nickgerace/homebrew-gfold).
```sh
brew install nickgerace/gfold/gfold
```
### AUR
You can use a Linux distribution that supports installing packages from the AUR, [Arch User Respository](https://aur.archlinux.org/), to install the following:
- [gfold](https://aur.archlinux.org/packages/gfold/) - builds from source
- [gfold-git](https://aur.archlinux.org/packages/gfold-git/) - development package
Many people choose to use an [AUR helper](https://wiki.archlinux.org/index.php/AUR_helpers), such as [yay](https://github.com/Jguer/yay) or [paru](https://github.com/Morganamilo/paru), in order to install their AUR packages.
```sh
yay -S gfold
paru -S gfold
```
### Cargo
You can use [cargo](https://crates.io) to install the [crate](https://crates.io/crates/gfold) on almost any platform.
```sh
cargo install gfold
```
## Usage
Pass in the `-h`, or `--help`, flag to see all the options for using this application.
```sh
gfold
gfold ..
gfold $HOME
gfold /this/is/an/absolute/path
gfold ../../this/is/a/relative/path
```
## Compatibility
`gfold` is intended to be ran on *any* tier one Rust target.
Please [file an issue](https://github.com/nickgerace/gfold/issues) if your platform is unsupported.
## Troubleshooting
If `fold` from GNU Coreutils is installed on macOS via `brew`, it will be named `gfold`.
You can avoid this collision with shell aliases, shell functions, and/or `PATH` changes.
Here is an example with the `o` dropped from `gfold`:
```sh
alias gfld=$HOME/.cargo/bin/gfold
```
## Code of Conduct
This repository follows and enforces the Rust programming language's [Code of Conduct](https://www.rust-lang.org/policies/code-of-conduct).
## More Information
Please continue to [EXTRA.md](./docs/EXTRA.md) for more information on using `gfold`.
|
