ghupload

ghupload

CLI to upload a file to a github repository through github's REST API. The file will be either created or overwritten.

Installation

Downloadable binaries are available from the releases page.

Setup

• Create a Github personal access token
• Set GITHUB_TOKEN environment variable

$ export GITHUB_TOKEN="your-personal-access-token"

Usage

Usage:
  ghupload upload -m <commit-msg> [-b <branch>] <local-path> <remote-url>

Flags:
  -b, --branch string    Commit to branch (default branch if empty)
  -m, --message string   Commit message (required)

local-path is either a path to a local file or "-" for STDIN.

remote-url can be one of the following formats and has to include the repository owner, the repository and the path to the file inside the repository:

• https://github.com/owner/repository/path/in/repo
• git@github.com:owner/repository.git/path/in/repo
• owner/repository/path/in/repo

Command prints the commit SHA on success.

Examples

• Upload file

$ ghupload upload -m "commit msg" README.md invit/ghupload/README.md
b6cbb5b2ea041956c4ac8da17007f95d2312a461

• Upload data from STDIN

$ ghupload upload -m "commit msg" - invit/ghupload/README.md
this is the new 
content 
of the file
^D
3be39e60c3ae44faa40f4efc31241f3564c396f1

Build

On Linux:

$ git clone github.com/invit/ghupload 
$ cd ghupload
$ make 

License

ghupload is licensed under the MIT License.