The development of gim has been discontinued in favor of GitPack.
Simple installation manager for your Git projects.
Wouldn't it be great to install and update your favorite Git projects like this?
gim install <url>
And when they are no longer needed, uninstall them that way?
gim uninstall <url>
If you are in, then gim comes in pretty handy. All you need is a URL of a Git project and gim will do the rest. With respect to gim's flexibility, there are a lot of compatible projects around even without being adapted to gim at all.
Are you a developer of a Git project? Do you like the idea stated above? Then keep reading in the Developer section.
Global (system) installation:
mkdir -p /tmp/gim/ && # create a temporary directory for gim repository
cd /tmp/gim/ && # go to the created directory
git clone https://github.com/dominiksalvet/gim.git . && # clone gim repository
git checkout "$(git describe --tags --abbrev=0)" && # use latest gim version
sudo make install && # install gim, requires root permissions
echo 'SUCCESS' # print a message when everything succeededLocal (user) installation:
mkdir -p /tmp/gim/ && # create a temporary directory for gim repository
cd /tmp/gim/ && # go to the created directory
git clone https://github.com/dominiksalvet/gim.git . && # clone gim repository
git checkout "$(git describe --tags --abbrev=0)" && # use latest gim version
make install && # install gim, does not require root permissions
echo 'SUCCESS' # print a message when everything succeededFrom now on, you can use gim to update itself or even uninstall itself. If you decide to uninstall gim, it would not uninstall any project installed by gim. However, you would probably need to install gim back to manage those projects.
Install or update a Git project:
gim install <url>
Uninstall a Git project:
gim uninstall <url>
Show status of a Git project:
gim status <url>
As demonstrated above, gim works with either global or local installations based on whether it is run with root permissions.
You may use gim in your Git projects. Why?
- No gim-specific files required
- Easy-to-use for developers and users
- Global and local installations
- Delta updates
- POSIX-friendly environment
How? Meet the rules stated in the RULES.md file and your project will become gim ready. Then users can use gim to manage it.
Not sure? Try gim status <url> with the URL of your project - maybe it is already compatible.
Gim ready projects work best with the following badge:
Markdown:
[](https://github.com/dominiksalvet/gim)Big thanks to Jan Polák for help with macOS support.
Do you want to contribute? Do you have any questions? Then the CONTRIBUTING.md file is here for you.
Licensing policy of gim is compliant with REUSE Practices.
The preferred license is the MIT License as stated in the LICENSE.txt file.