meson/docs/markdown/fallback-wraptool.md

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

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

*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.
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it. 8 years ago			`---`
			`title: fallback wraptool`
			`...`

			`# In case of emergency`

doc: Capitalize things more consistently. Upper or lower case depending on the official spelling, or the more consistent usage. 8 years ago			`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.`
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it. 8 years ago
			`## 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>`

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

docs: update fallback wraptool docs [skip ci] Fixes #5229 6 years ago			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.

docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it. 8 years ago			`## How to upgrade an existing dir/fix broken state/any other problem`

			Nuke the contents of `subprojects` and start again.

			`## Known issues`

doc: Capitalize things more consistently. Upper or lower case depending on the official spelling, or the more consistent usage. 8 years ago			`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.`
docs: Import the website and wiki and build with hotdoc This allows us to more easily have the documentation in sync with the source code as people will have to document new features etc right at the time where they implement it. 8 years ago
doc: Capitalize things more consistently. Upper or lower case depending on the official spelling, or the more consistent usage. 8 years ago			`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.`