For managing versions in a repository that maintains the version primarily in a flat file. Agnostic to the primary language of the repository. Optional input for a release script to call during the publish/canary/next hooks.
This plugin is included with the auto
CLI so you do not have to install it. To install if you are using the auto
API directly:
npm i --save-dev @auto-it/version-file
# or
yarn add -D @auto-it/version-file
- versionFile (optional, default="VERSION"): Path to where the version is stored in the repository. It should be a file containing just the semver.
- publishScript: (optional, default=None): Path to script that runs the publish actions in your repository. If not supplied nothing will be called. If supplied will be called during the
publish
,canary
andnext
hooks with the arguments defined inpublishScriptReleaseTypeArgs
for that release type. - publishScriptReleaseTypeArgs: (optional, default=
{ "publish": ["release"], "canary": ["snapshot"], "next": ["snapshot"] }
): Mapping of arguments to pass to thepublishScript
for each release type (publish
,canary
,next
)
{
"plugins": [
"version-file"
// other plugins
]
}
{
"plugins": [
"version-file", {"versionFile": "./tools/Version.txt", "publishScript":"./tools/publish.sh", "publishScriptReleaseTypeArgs": {
"publish": ["release"], // (default)
"canary": ["snapshot"],
"next": ["some", "other", "args"],
}}
]
}