GH Automator
A Node GH plugin for automating git processes.
Maintained by Dustin Ryerson.
Install
[sudo] npm install -g gh gh-automator
Usage
gh automator
Alias:
gh at
1. Cherry-pick fix
Option | Usage | Type | Description |
---|---|---|---|
-c , --cherrypickfix |
Required | Boolean |
Command to run |
-r , --regex |
Required | String |
Regex to use for cherry-pick |
-b , --sourcebranch |
Required | String |
Git branch the commits are being cherry-picked from |
-s , --startinghash |
Optional | String |
Hash to start cherry-picking from |
-i , --uniqueissues |
Optional | Boolean |
List possible dependencies for failed cherry-pick |
-S , --submit |
Optional | Boolean |
Submit a pull request upon successful cherry-pick |
-u , --user |
Optional | String |
Specify which user you are sending the pull request to |
-p , --prbranch |
Optional | String |
Specify which branch you are sending the pull request to |
Examples
-
Attempts to cherry-pick commits where the commit message contains a regular expression (ie "LPS-12345") specified by the --regex option, from the branch specified by the --sourcebranch option, to the current branch. In the event of a failed cherry-pick the --startinghash and --uniqueissues options can be used.
gh automator --cherrypickfix --regex LPS-12345 --sourcebranch master
* Shorthand version:
gh at -c -r LPS-12345 -b master
```
-
Attempts to cherry-pick commits for LPS-12345 from the specified branch to the current branch and sends a pull request to githubUsername's ee-6.2.x branch if successful.
gh automator --cherrypickfix --regex LPS-12345 --sourcebranch master --submit --user githubUsername --prbranch ee-6.2.x
* Shorthand version:
gh at -c -r LPS-12345 -b master -S -u githubUserName -p ee-6.2.x
```
2. Print commit messages
Option | Usage | Type | Description |
---|---|---|---|
-m , --printcommitmessage |
Required | Boolean |
Command to run |
-r , --regex |
Required | String |
Regex to use for printing commit messages |
-b , --sourcebranch |
Optional | String |
Git branch the commit messages are being printed from |
Examples
-
Prints all commit messages on the current branch containing the regular expression specified. A different branch can be specified by the --sourcebranch option.
gh automator --printcommitmessage --regex LPS-12345
* Shorthand version:
gh at -m -r LPS-12345
```
Testing
Check Travis for continous integration results.
-
Run JSHint, a tool to detect errors and potential problems.
npm run-script lint ```
-
Run Mocha, a unit test framework.
npm run-script test ```
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -m 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D
History
-
v1.0.3 January 4, 2016
- Update README
-
v1.0.2 December 23, 2015
- Update README
-
v1.0.1 August 14, 2015
-
v1.0.0 August 14, 2015
- Cherry-pick and Print Commit Message feature completion
-
v0.0.1 July 24, 2015
- Start plugin using gh-automator