Linking Related Feature Branches
Another use case of
gitman is to test experimental versions of related product sub-components. In the web app + API example, a new feature might require changes in both the API and web app.
Custom Locked Sources
By manually modifying the
sources_locked section, a particular version of the API can be checked out to help finish the complete feature in the web app:
location: vendor/gitman sources: - name: api repo: https://github.com/example/api rev: develop sources_locked: - name: api repo: https://github.com/example/api rev: feature/authenticate-with-github # related feature branch in the API
If this modified
gitman.yml is committed to a corresponding feature branch in the web app, others will be able to create a similar working tree to collaborate on the feature.
$ gitman installduring continuous integration and locally to test the web app against the proposed API changes
gitman.ymlto share this feature branch with others
- When the feature is complete, merge the API feature branch first
$ gitman updateto reset
gitman.ymlback to a tracking a specific commit