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.