forge update
NAME
forge-update - Update one or more dependencies.
SYNOPSIS
forge update [options] [dep]
DESCRIPTION
Update one or more dependencies.
The argument dep is a path to the dependency you want to update.
Forge will update to the latest version on the ref you specified for the dependency when you ran forge install.
If no argument is provided, then all dependencies are updated.
Lockfile
Post foundry#9522, every install, update or remove syncs the lockfile (foundry.lock) which has been introduced to ensure that git submodules stay pinned to the tag/revision that the user specified while installing the dependency.
Without the lockfile submodules pinned to a tag/revision get silently updated to the master/main branch of the dependency. See foundry#7225
If you wish to update your dependencies tag/rev you can do so using:
# Update the tag of the dependency
forge update owner/dependency-name@new-tag
forge update owner/dependency-name@tag=some-tag
# Update the revision of the dependency
forge update owner/dependency-name@01234abc
forge update owner/dependency-name@rev=01234abc
OPTIONS
Common Options
-h
--help
Prints help information.
EXAMPLES
-
Update a dependency:
forge update lib/solmate -
Update all dependencies:
# Note: Dependencies pinned to tags/revs in `foundry.lock` will not be updated. # They must be overwritten explicitly. forge update -
Update the tag/rev of a dependency:
# Update the tag of the dependency forge update owner/dependency-name@new-tag forge update owner/dependency-name@tag=some-tag # Update the revision of the dependency forge update owner/dependency-name@01234abc forge update owner/dependency-name@rev=01234abc