@oat-sa/tao-extension-release
v2.6.4
Published
Helps you to release TAO extensions
Downloads
124
Maintainers
Keywords
Readme
tao-extension-release
This tool automates TAO extension release
Installation
Please verify installation prerequisite. And run :
npm i -g @oat-sa/tao-extension-release
Release
This tool offers specialized release process for different types of repositories.
TAO extensions
If the repository contains a TAO Extension, please use the command extensionRelease
.
taoRelease extensionRelease
You will be prompted to follow the instructions.
This command does:
- compute the next version from commits
- bundle assets
- create a tag and a release
NPM packages
If the repository contains an npm package, please use the command npmRelease
. This command must be run in the root directory of an npm package repository.
cd path/to/my/package/repo
taoRelease npmRelease
You will be prompted to follow the instructions.
This command does:
- compute the next version from commits
- update the package.json and package-lock.json
- create a tag and a release
- publish the package to npm
At then end, you will be prompted to trigger the execution of npm publish
. The Github release is already finished at this stage. If the publish step fails, you can try again manually, or ask someone with the necessary privileges to perform the publishing.
NPM packages in monorepo
If the repository is a lerna-managed monorepo, and contains npm packages, please use the command npmReleaseMonorepo
. This command must be run in the root directory of the monorepo. Monorepo must be have lerna
installed at the root, because release tool will use its CLI to get infromation about packages.
cd path/to/my/package/repo
taoRelease npmReleaseMonorepo
This command does:
- compute the next version from commits
- for root, and for each package. Based on commits that touch files in this package.
- update the package.json and package-lock.json
- for root, and for each package
- create a tag and a release
- publish the packages to npm
- the Github release is already finished at this stage. If the publish step fails, you can try again manually, or ask someone with the necessary privileges to perform the publishing.
Tag based repositories
For any other repository that doesn't need any special build but only tagging and merging, like PHP libraries, please use the command repoRelease
. This command must be run in the root directory of the repository.
cd path/to/my/repo
taoRelease repoRelease
You will be prompted to follow the instructions.
This command does:
- compute the next version from commits
- create a tag and a release
Commandline arguments
Commandline arguments to give you more control over the parameters of the release:
Common options
| option | description | default |
| ----------------------------- | ---------------------------------------- | ----------------------------------------------------------- |
| --base-branch <branch>
| branch to release from | develop
|
| --branch-prefix <prefix>
| releasing branch prefix | release
|
| --origin <remote>
| git repository remote name | origin
|
| --release-branch <branch>
| branch to release to | master
|
| --release-version <version>
| version to be used for the release | version extracted from conventional commits |
| --release-comment <comment>
| comment to attach to the release | (none - prompted) |
| --no-interactive
| turns off the interactive mode | interactive mode is on by default, except on non TTY shells |
| --no-write
| turns off writting config to file system | no set |
extensionRelease extra options
| option | description | default |
| ------------------------------------ | -------------------------------------------------------------------------------------------------- | ----------------- |
| --path-to-tao <path>
| relative or absolute filesystem path | (none - prompted) |
| --extension-to-release <extension>
| extension name (e.g. taoFoobar) | (none - prompted) |
| --update-translations
| run translation update without prompting. Translations update is only available in interative mode. | |
| --www-user <user>
| the system user used to launch PHP commands | www-data
|
npmReleaseMonorepo extra options
| option | description | default |
| -------------------------- | -------------------------------------------------------------------------------------------------- | ----------------- |
| --release-tag
| tag to be used for the release, if it's different from root package.json version | |
| --conventional-bump-type
| one of: none
,patch
, minor
, major
. If not specified, will be calculated from conventional commits on each package. If none
, will not change package versions. | |
| --no-publish
| do not publish packages to npm. Publishing is done as the last step. For no-interactive mode. | |
Development
Remove the package if already installed globally :
npm uninstall -g @oat-sa/tao-extension-release
Then clone the sources :
git clone [email protected]:oat-sa/tao-extension-release.git
cd tao-extension-release
npm install
npm link
So the command taoRelease
will use the sources.
Useful commands :
npm test
runs the test suitenpx jest -- my-test.spec.js
runs a single testnpm run test:cov
runs the test suite with code coveragenpm run test:dev
runs the test suite in watch modenpm run lint
verifies the sources complies with the code style guide
Configuration
A file named .tao-extension-release
is created in the user directory.
The following values can be defined in this file :
token
: your Github auth tokentaoRoot
: the path to the root of TAOwwwUser
: the system user used to launch PHP commands (www-data
)
Next version calculation
Next version taken based on Conventional commits. Some treats of the next version calculation:
- if one or more commits contains a breaking change, the version will be increased by one major semver version
- if one or more commits contains a feature change, the version will be increased by one minor semver version
- if one or more commits contains a bugfix change, the version will be increased by one fix semver version
- if no commit contains a conventional change information, the version will be increased by one fix semver version and warn the user
- if
release-version
option provided, it will be taken as next release version and version calculation will be skipped
System Prerequisite
node.js
You need a recent version of node.js for your platform.
git
You need to have the git
> 1.7.0
command available in your PATH
.
PHP
To release TAO extension, you may also need the php
command available in your PATH
sudo (linux and OSX)
You also need the sudo
command available in your PATH
.
Known Issues
Task foosass not found
Everything looks OK but you don't know why the grunt
task is not found. If you have updated node
or npm
recently, you can fix this by :
cd tao/views/build
npm reinstall node-sass --force
Release notes
See the history
License
Copyright (c) 2017-2021 Open Assessment Technologies SA; GNU General Public License v2.0