~siborgium/src-tree

02f0a3d2f96a75781e34deac5332fe7652b74fa4 — Sergey Smirnykh 1 year, 3 months ago 85eb6a4
Brief explanation
1 files changed, 33 insertions(+), 1 deletions(-)

M README.md
M README.md => README.md +33 -1
@@ 1,1 1,33 @@
# src-tree -- A simple tool to build multiple git repositories together
# src-tree - A simple tool to build multiple git repositories together

A perfect dependency graph is never stale or broken, but there are no perfect dependency graphs.
One very common use case is building multiple projects from source, using one's build artifacts to build another.
Copying artifacts by hand is tedious and errorprone, but there is a simple solution: shared build directory.
Setting one up is quite tedious too, so I've come up with this tool.

It allows to clone multiple repositories as described by configuration file, and link their build directories together.

```sh
% src-tree clone config.yaml --root ./root
% mkdir root/build
% # populate root/build with dependencies
% src-tree link config.yaml --root ./root --builddir build
```

For a following configuration file

```yaml
repositories:
  - url: https://some.where/~else/xxx
    branch: develop
  - url: https://else.where/~nowhere/yyy
    name: zzz
```

This would produce a following directory tree minus `xxx` and `zzz` contents.

```
./root/build
./root/xxx/build -> ./root/build
./root/zzz/build -> ./root/build
```