@mmomtchev/node-pre-gyp-github
v2.0.6
Published
A node-pre-gyp module which provides the ability to publish to GitHub releases.
Downloads
4,738
Maintainers
Readme
node-pre-gyp-github
A node-pre-gyp module which provides the ability to publish to GitHub releases.
This package is an almost complete rewrite using a modern API of node-pre-gyp-github by @bchr02 which is not maintained anymore and does not work with the recent changes in the Github API.
It aims to be compatible with the original package.
Usage
Instead of node-pre-gyp publish
use node-pre-gyp-github publish
Options for publish command
--silent : Turns verbose messages off.
--release : Publish the GitHub Release immediately instead of creating a Draft.
For Ex.
node-pre-gyp-github publish --release
Install
npm install -g node-pre-gyp-github
Configuration
This module is intended to be used with node-pre-gyp. Therefore, be sure to configure and install node-pre-gyp first. After having done that, within package.json
update the binary
properties host
and remote_path
so it matches the following format:
"host": "https://github.com/[owner]/[repo]/releases/download/",
"remote_path": "{version}"
Be sure to replace [owner]
, [repo]
, with actual values,
but DO NOT replace {version}
with actual version.
WARNING: Variable substitutions are not supported on the host
property and on the remote_path
only {version}
placeholder is supported. The value of remote_path
after substitution will become a release tag name. Do not use forbidden git tag characters for version
and remote_path
properties.
Within GitHub, create a new authorization:
- go to Settings
- click Personal access tokens
- click Generate new token
- Select "public_repo" and "repo_deployment"
- Generate Token
- copy the key that's generated and set NODE_PRE_GYP_GITHUB_TOKEN environment variable to it. Within your command prompt:
SET NODE_PRE_GYP_GITHUB_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Examples
Publish to GitHub as a Draft Release
node-pre-gyp configure
node-pre-gyp build
node-pre-gyp package
node-pre-gyp-github publish
Publish to GitHub as a Release
node-pre-gyp configure
node-pre-gyp build
node-pre-gyp package
node-pre-gyp-github publish --release
License
Copyright © 2015–2016 Bill Christo & Contributors
Copyright © 2021 Momtchil Momtchev, @mmomtchev & Contributors
Licensed under the MIT License