git-repos 0.1.0

Git Repos
Documentation 
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

# Installation

## Installation

Building GRM requires the Rust toolchain to be installed. The easiest way is
using [`rustup`](https://rustup.rs/). Make sure that rustup is properly
installed.

Make sure that the stable toolchain is installed:

```bash
$ rustup toolchain install stable
```

Then, install the build dependencies:

| Distribution  | Command                                                                        |
| ------------- | ------------------------------------------------------------------------------ |
| Arch Linux    | `pacman -S --needed gcc openssl pkg-config`                                    |
| Ubuntu/Debian | `apt-get install --no-install-recommends pkg-config gcc libssl-dev zlib1g-dev` |

Then, it's a simple command to install the latest stable version:

```bash
$ cargo install git-repo-manager
```

If you're brave, you can also run the development build:

```bash
$ cargo install --git https://github.com/hakoerber/git-repo-manager.git --branch develop
```

## Static build

Note that by default, you will get a  dynamically linked executable.
Alternatively, you can also build a statically linked binary. For this, you will
need `musl` and a few other build dependencies installed installed:

| Distribution  | Command                                                                     |
| ------------- | --------------------------------------------------------------------------- |
| Arch Linux    | `pacman -S --needed gcc musl perl make`                                     |
| Ubuntu/Debian | `apt-get install --no-install-recommends gcc musl-tools libc-dev perl make` |

(`perl` and `make` are required for the OpenSSL build script)

The, add the musl target via `rustup`:

```bash
$ rustup target add x86_64-unknown-linux-musl
```

Then, use a modified build command to get a statically linked binary:

```bash
$ cargo install git-repo-manager --target x86_64-unknown-linux-musl --features=static-build
```

## [Nix](https://nixos.org/)

Run from github without downloading:

```bash
$ nix run github:hakoerber/git-repo-manager/develop -- --version
git-repo-manager 0.7.15
```

Run from local source directory:

```bash
$ nix run . -- --version
git-repo-manager 0.7.15
```

Integrate into a [Nix Flake](https://nixos.wiki/wiki/Flakes):

```nix
{
  inputs = {
    ...
    git-repo-manager = {
      url = "github:hakoerber/git-repo-manager";
      inputs.nixpkgs.follows = "nixpkgs";
      inputs.flake-utils.follows = "flake-utils";
    };
  };

  outputs = {
    ...
    pkgs = import inputs.nixpkgs {
        ...
        overlays = [ inputs.git-repo-manager.overlays.git-repo-manager ];
    };
  };
}
```