| --- | |
| 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. |