https://github.com/kyoshidajp/tosa

Open pull request page from commit hash tool
https://github.com/kyoshidajp/tosa

git github golang

Last synced: 4 months ago
JSON representation

Open pull request page from commit hash tool

• Host: GitHub
• URL: https://github.com/kyoshidajp/tosa
• Owner: kyoshidajp
• License: mit
• Created: 2018-01-01T04:27:33.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2018-04-07T08:30:35.000Z (over 7 years ago)
• Last Synced: 2024-06-20T08:11:23.431Z (over 1 year ago)
• Topics: git, github, golang
• Language: Go
• Homepage:
• Size: 55.7 KB
• Stars: 13
• Watchers: 4
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE

Awesome Lists containing this project

README

          
# TOSA

[![GitHub release](https://img.shields.io/github/release/kyoshidajp/tosa.svg?style=flat-square)][release]

[![Travis](https://travis-ci.org/kyoshidajp/tosa.svg?branch=master)](https://travis-ci.org/kyoshidajp/tosa)

[![Go Documentation](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square)][godocs]

[![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)][license]

[release]: https://github.com/kyoshidajp/tosa/releases

[license]: https://github.com/kyoshidajp/tosa/blob/master/LICENSE

[godocs]: http://godoc.org/github.com/kyoshidajp/tosa

**TOSA** is **O**pen **S**ource **A**vailable.

Open pull request page or get pull request data from sha(commit hash). You can more easily find why the code is included by the page:mag_right:

![tosa1](https://user-images.githubusercontent.com/3317191/37557365-c279fabe-2a46-11e8-9c68-2c65f9862132.gif)

If you want to run on VS Code? You can get VS Code extension from [Marketplace](https://marketplace.visualstudio.com/items?itemName=kyoshidajp.vscode-tosa).

## Usage

```

$ tosa 

```

### Options

```

-u, --url      Print the pull request url.

-a, --apiurl   Print the issue API url.

-n, --newline  If -u(--url) or -a(--apiurl) option is specified, print

               the url with newline character at last.

-d, --debug    Enable debug mode.

               Print debug log.

-h, --help     Show this help message and exit.

-v, --version  Print current version.

```

*NOTE*: Set Github Access Token which has "Full control of private repositories" scope as an environment variable `GITHUB_TOKEN`. If not set, `tosa` requires your Github username and password(and two-factor auth code if you are setting). Because of using [GitHub API v3](https://developer.github.com/v3/).

### from tig

Add the following key bindings in `$HOME/.tigrc`.

```

bind main O @tosa %(commit)

bind blame O @tosa %(commit)

```

Open page by O(Shift+o) in main or blame view.

![tig_tosa](https://user-images.githubusercontent.com/3317191/37557359-a14d0c64-2a46-11e8-92b3-b1d446757b92.gif)

### API URL

Get GitHub issue API url.

```

$ tosa -a 

```

Get title of pull request via [jq](https://stedolan.github.io/jq/), for example.

```

$ curl -s `tosa -a c97e6909` | jq -r '.title'

Add short command option and usage

```

For more information, see [Issues \| GitHub Developer Guide](https://developer.github.com/v3/issues/#get-a-single-issue). 

## Install

### Homebrew

If you have already installed [Homebrew](http://brew.sh/); then can install by brew command.

```

$ brew tap kyoshidajp/tosa

$ brew install tosa

```

### go get

If you are a Golang developper/user; then execute `go get`.

```

$ go get -u github.com/kyoshidajp/tosa

```

### Manual

1. Download binary which meets your system from [Releases](release).

1. Unarchive it.

1. Put `tosa` where you want.

1. Add `tosa` path to `$PATH`.

## Author

[Katsuhiko YOSHIDA](https://github.com/kyoshidajp)