Skip to content

Overrides

njlr edited this page Oct 29, 2019 · 1 revision

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.

Clone this wiki locally