# README

gx-workspace

A gx tool for working with a big bunch of repositories/packages

Install

> go get -u github.com/ipfs/gx-workspace

Usage

To update package foo in package bar, where foo is a nested dependency (a dependency of bar and also a dependency of bars other dependencies). Change directory to the package bar, and run:

gx-workspace update start foo

This will ensure all necessary dependencies are installed, and generate a gx-workspace-update.json file that specifies the set of tasks to be done to complete the update. It should also have the correct hash of the package you are trying to update in the 'Changes' map.

To progress with the updates, run gx-workspace update next and follow the prompts. For each package you will have to run the next command twice. Once to do the update and run the tests, then once to publish and commit those changes (this allows manual inspection of the packages if desired).

This process continues until you reach the root package, bar in our example. At which point the update is complete.