Skip to content

CLI tool to help keep track of your Git repositories, written in Rust.

License

Notifications You must be signed in to change notification settings

mrtvfuencxozd/gfold

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gfold

License: MIT Build Status

gfold is a CLI application that helps you keep track of multiple Git repositories.

user at hostname in ~/git
% gfold
bat         clean    master  [email protected]:sharkdp/bat.git
bare-repo   bare     dev     https://github.com/<user>/bare-repo.git
exa         clean    master  [email protected]:ogham/exa.git
gfold       unclean  async   [email protected]:nickgerace/gfold.git
nushell     clean    master  https://github.com/nushell/nushell.git
tockilator  clean    master  [email protected]:oxidecomputer/tockilator.git

Description and Motivation

This app displays relevant information for multiple Git repositories in one directory or folder. It prints each repository in alphabetical order, and pads each result based on the longest directory name.

By default, gfold looks at every Git repository in the current working directory. However, you can use the -p/--path flag to target another directory.

While this tool might seem limited in scope and purpose, that is by design. Features, such as recursive search and async-await support, are future goals. This application aims to do one or few things well.

Installation

The recommended method to install gfold is by executing the following...

cargo install --git https://github.com/nickgerace/gfold

There may be some releases available, but there is not a consistent, CI/CD pipeline for this tool yet.

Usage

There's only two usage options at the moment (CWD or specified path), but you can use the --help flag for more details.

gfold --help

Here are some example invocations...

gfold
gfold -p ..
gfold -p $HOME

Compatibility

All external crates were vetted for multi-platform (including Windows 10) support. gfold is tested for the following systems, but may work on more...

  • Linux amd64 (default, dynamically linked)
  • Linux amd64 (MUSL, statically linked)
  • macOS amd64
  • Windows 10 amd64

Future Plans

  • Add recursive function to search sub-directories.
  • Replace sequential functions with async-await.
  • Add version checking, using the GitHub API (example: bat), to compare the latest tag with Clap's local version.

Additional Information

About

CLI tool to help keep track of your Git repositories, written in Rust.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 85.3%
  • Makefile 14.7%