update

Documentation

Overview

Package update contains code for Please auto-updating itself. At startup, Please can check a version set in the config file. If that doesn't match the version of the current binary, it will download the appropriate version from the website and swap to using that instead.

This feature is fairly directly cribbed from Buck since we found it very useful, albeit implemented differently so it plays nicer with multiple simultaneous builds on the same machine.

Index

• func CheckAndUpdate(config *core.Configuration, ...)

Functions

func CheckAndUpdate

func CheckAndUpdate(config *core.Configuration, updatesEnabled, updateCommand, forceUpdate, verify bool)

CheckAndUpdate checks whether we should update Please and does so if needed. If it requires an update it will never return, it will either die on failure or on success will exec the new Please. Conversely, if an update isn't required it will return. It may adjust the version in the configuration. updatesEnabled indicates whether updates are enabled (i.e. not run with --noupdate) updateCommand indicates whether an update is specifically requested (due to e.g. `plz update`) forceUpdate indicates whether the user passed --force on the command line, in which case we will always update even if the version exists.