aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/fallback-wraptool.md
blob: 9f4814b213672618b18b57a6a9a57a187e3bab21 (plain)
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
---
title: fallback wraptool
...

# In case of emergency

In case wraptool is down we have created a backup script that you can
use to download wraps directly from the GitHub repos. It is not as
slick and may have bugs but at least it will allow you to use wraps.

## Using it

To list all available wraps:

    ghwt.py list

To install a wrap, go to your source root, make sure that the
`subprojects` directory exists and run this command:

    ghwt.py install <projectname> [<branchname>]

This will stage the subproject ready to use. If you have multiple
subprojects you need to download them all manually.

Specifying branch name is optional. If not specified, the list
of potential branches is sorted alphabetically and the last branch is 
used.

*Note* The tool was added in 0.32.0, for versions older than that you
need to delete the `foo.wrap` file to work around this issue.

## How to upgrade an existing dir/fix broken state/any other problem

Nuke the contents of `subprojects` and start again.

## Known issues

Some repositories show up in the list but are not installable. They
would not show up in the real WrapDB because they are works in
progress.

GitHub web API limits the amount of queries you can do to 60/hour. If
you exceed that you need to wait for the timer to reset.