Home

Awesome

GitPack

<p align="center"> <img src="img/example.gif" alt="GitPack example"> </p>

CI status GitPack POSIX Shell Hits

GitPack stands on a simple idea – a Git repository is a package, its URL is the package name. Based on that it is possible to install/update your favorite Git projects as shown:

gitpack install <url>

And when they are no longer needed, uninstall them that way:

gitpack uninstall <url>

GitPack not only saves time for end-users to figure out how to install a Git project, but it also unifies the project development and distribution in a convenient place; its Git repository.

Do you want to try GitPack in your project? The section for developers will help you get started.

Table of Contents

Requirements

All you need to install and run GitPack is Linux/Unix environment and Git.

Windows users may simply use Git for Windows.

Installation

Local (user) installation:

wget -qO- https://raw.githubusercontent.com/dominiksalvet/gitpack/master/.install/initl.sh | sh

Global (system) installation:

wget -qO- https://raw.githubusercontent.com/dominiksalvet/gitpack/master/.install/initg.sh | sh

If you do not have wget, copy-paste the source code of one of the scripts into a shell terminal and execute it.

Once installed, you will use GitPack to manage even itself (e.g., for updating). Now start exploring.

Usage

If GitPack is run with root permissions (e.g., using sudo), it will use global access and perform global installations. Otherwise, a local approach for the current user will be used.

Install/update to the latest version:

gitpack install <url>

It uses the latest tag (latest commit if no tag) of the repository default branch.

Install/update/downgrade to a particular version:

gitpack install <url>=<version>

The <version> is any Git revision (tag name, branch name, commit hash).

Uninstall (version is detected automatically):

gitpack uninstall <url>

Show the status of a project:

gitpack status <url>

List all installed projects:

gitpack list

Use gitpack help to see more arguments.

Examples

To better understand how GitPack works, there are some examples below.

$ gitpack install github.com/dominiksalvet/pathfinding-robots
>>> running install for github.com/dominiksalvet/pathfinding-robots
downloading repository
reading status database
using automatic candidate version
installing version 1.1.0
running script .install/install-local
copying files
adding to status database
<<< done; successfully installed
$ gitpack -r status git@github.com:dominiksalvet/vhdldep.git
>>> running status for git@github.com:dominiksalvet/vhdldep.git
downloading repository
reading status database
using automatic candidate version
<<< not installed; candidate is 2.2.0
$ sudo gitpack -H list
github.com/dominiksalvet/gitpack 4ca05c10a9903251826a8d0addc25daf6808fffa
github.com/dominiksalvet/asus-fan-control cb6be871cdbf4453d9072118194198d75dd0b380
github.com/dominiksalvet/ux430ua-jack-volume 208f1a7bce8644482abdfa14107f90358a75bb1b
$ gitpack paths
state-dir /home/dominik/.local/share/gitpack
cache-dir /home/dominik/.cache/gitpack
lock-path /var/lock/gitpack-1000

$ sudo gitpack paths
state-dir /var/lib/gitpack
cache-dir /var/cache/gitpack
lock-path /var/lock/gitpack-0

Did you know that GitPack has sleek tab completion for Bash shells?

For Developers

There are many reasons why developers should like GitPack:

GitPack shines when installing the following:

Unsure? There is even more in GitPack:

So are you ready to try GitPack in your project? Then see how it works.

Badge

Projects that use GitPack work best with the following sleek badge:

GitPack

In markdown:

[![GitPack](https://img.shields.io/badge/-GitPack-571997)](https://github.com/topics/gitpack)

Useful Resources