Create releases and attach assets on Github.
This plugin requires Grunt ~0.4.5
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-github-release-asset --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-github-release-asset');
Run the task with grunt githubAsset
Github allows you to create releases on tags. This grunt task allows you to create a release on the newest tag and attach a file to it.
Even though it's possible to use username and password to authenticate, it's recommended to use a token based authentication. In case your credentials get leaked you can easily revoke the token. Furthermore don't put your credentials in the Gruntfile, create a credentials.json
and add it to .gitignore.
You can create a token at Settings > Applications > Generate new token. Enter grunt-github-release-asset
as a name and assign only the repo
permission. Copy the token into your credentials file.
Type: object
Token authentication (recommended)
{
token: '...'
}
Username & password authentication
{
username: '...',
password: '...'
}
Type: String
The git url of the repository. Must be [email protected]:user/repo.git
Type: String
The path to a single file relative to your grunt root.
Type: String
Default: {tag}
The name of the release. By default it will use the tag name. {tag}
is a placeholder and can be used inside another string.
Type: String
Default: undefined
The tag for which ti do a release. By default, will fetch the latest tag from Github.
grunt.initConfig({
githubAsset: {
options: {
credentials: grunt.file.readJSON('credentials.json'),
repo: '[email protected]:Bartinger/grunt-github-release-asset.git',
file: 'project_build.zip',
releaseName: 'Version {tag}'
},
},
});
In lieu of a formal styleguide, take care to maintain the existing coding style. Lint and test your code using Grunt.
- 0.1.0 Initial release; Create a release and attach a single file.