mirror of
https://github.com/renovatebot/renovate.git
synced 2025-01-12 23:16:26 +00:00
136 lines
3.5 KiB
Markdown
136 lines
3.5 KiB
Markdown
# Preset configs
|
|
|
|
Renovate uses the term "presets" to refer to shareable config snippets, similar
|
|
to eslint. Unlike eslint though:
|
|
|
|
* Presets may be as small as a list of package names, or as large as a full
|
|
config
|
|
* Shared config files can contain many presets
|
|
|
|
## Preset config URIs
|
|
|
|
In human-understandable form, the rules are:
|
|
|
|
* A full preset URI consists of package name, preset name, and preset
|
|
parameters, such as `package:preset(param)`
|
|
* If a package scope is specified and no package, then the package name is
|
|
assumed to be `renovate-config`, e.g. `@rarkins:webapp` is expanded to
|
|
`@rarkins/renovate-config:webapp`
|
|
* If a non-scoped package is specified then it is assumed to have prefix
|
|
`renovate-config-`. e.g. `rarkins:webapp` is expanded to
|
|
`renovate-config-rarkins:webapp`
|
|
* If a package name is specified and no preset name, then `default` is assumed,
|
|
e.g. `@rarkins` expands in full to `@rarkins/renovate-config:default` and
|
|
`rarkins` expands in full to `renovate-config-rarkins:default`
|
|
* There is a special "default" namespace where no package name is necessary.
|
|
e.g. `:webapp` (not the leading `:`) expands to
|
|
`renovate-config-default:webapp`
|
|
|
|
## Supported config syntax
|
|
|
|
### Scoped
|
|
|
|
```
|
|
@somescope
|
|
```
|
|
|
|
This will resolve to use the preset `default` in the npm package
|
|
`@somescope/renovate-config`.
|
|
|
|
### Scoped with package name
|
|
|
|
```
|
|
@somescope/somepackagename
|
|
```
|
|
|
|
This will resolve to use the preset `default` in the npm package
|
|
`@somescope/somepackagename`.
|
|
|
|
### Scoped with preset name
|
|
|
|
```
|
|
@somescope:webapp
|
|
```
|
|
|
|
This will resolve to use the preset `webapp` in the npm package
|
|
`@somescope/renovate-config`.
|
|
|
|
### Scoped with params
|
|
|
|
```
|
|
@somescope(eslint, stylelint)
|
|
```
|
|
|
|
This will resolve to use the preset `default` in the npm package
|
|
`@somescope/renovate-config` and pass the parameters `eslint` and `stylelint`.
|
|
|
|
### Scoped with preset name and params
|
|
|
|
```
|
|
@somescope:webapp(eslint, stylelint)
|
|
```
|
|
|
|
This will resolve to use the preset `webapp` in the npm package
|
|
`@somescope/renovate-config` and pass the parameters `eslint` and `stylelint`.
|
|
|
|
### Scoped with package name and preset name
|
|
|
|
```
|
|
@somescope/somepackagename:webapp
|
|
```
|
|
|
|
This will resolve to use the preset `webapp` in the npm package
|
|
`@somescope/somepackagename`.
|
|
|
|
### Scoped with package name and preset name and params
|
|
|
|
```
|
|
@somescope/somepackagename:webapp(eslint, stylelint)
|
|
```
|
|
|
|
This will resolve to use the preset `webapp` in the npm package
|
|
`@somescope/somepackagename` and pass the parameters `eslint` and `stylelint`.
|
|
|
|
### Non-scoped short with preset name
|
|
|
|
Note: if using non-scoped packages, a preset name is mandatory.
|
|
|
|
```
|
|
somepackagename:default
|
|
```
|
|
|
|
This will resolve to use the preset `default` in the npm package
|
|
`renovate-config-somepackagename`.
|
|
|
|
### Non-scoped short with preset name and params
|
|
|
|
Note: if using non-scoped packages, a preset name is mandatory.
|
|
|
|
```
|
|
somepackagename:default(eslint)
|
|
```
|
|
|
|
This will resolve to use the preset `default` in the npm package
|
|
`renovate-config-somepackagename` with param `eslint`.
|
|
|
|
### Non-scoped full with preset name
|
|
|
|
Note: if using non-scoped packages, a preset name is mandatory.
|
|
|
|
```
|
|
renovate-config-somepackagename:default
|
|
```
|
|
|
|
This will resolve to use the preset `default` in the npm package
|
|
`renovate-config-somepackagename`.
|
|
|
|
### Non-scoped full with preset name and params
|
|
|
|
Note: if using non-scoped packages, a preset name is mandatory.
|
|
|
|
```
|
|
renovate-config-somepackagename:default(eslint)
|
|
```
|
|
|
|
This will resolve to use the preset `default` in the npm package
|
|
`renovate-config-somepackagename` and param `eslint`.
|