-
Notifications
You must be signed in to change notification settings - Fork 33
Overrides
Overrides are a new feature for 3.0
that allow the user to remap one package name to another. This is very useful when you want to "patch" a transitive dependency without forking every dependency down the line.
To create an override, add a section like this to your buckaroo.toml
:
[[override]]
package = "github.com/org/apple"
substitution = "github.com/org/banana"
This will tell Buckaroo to replace every occurance of github.com/org/apple
with github.com/org/banana
.
So, for example, if you dependency graph contains github.com/org/apple@1.2.3
, Buckaroo will fetch github.com/org/banana@1.2.3
instead.
Note that any overrides in your dependencies are ignored. If you would like to use the overrides from another package, you must copy them into your own manifest. This is to discourage over-reliance on overrides in the ecosystem, since they obscure the dependency graph.