Github issue integration in Vim. It's kind of awesome.
If you use Fugitive or edit gitcommit files in Vim, github-issues will automatically populate the omnicomplete menu with issues on Github. This is useful when you want to reference commits, close issues, etc., through Github's commit message parsing.
Here's how it works with Neocomplete:
If you use pure omnicomplete, use C-x C-o
to pull up the menu.
No need to run commands, no need to configure. It just works. ;) (And if it doesn't, it should, so submit an issue) Not bad, huh?
To show Github issues for the current repository:
:Gissues
Press enter to view more details.
You can open and close issues using co
and cc
in the issue view.
They're also totally editable buffers, and saving the file will sync with Github's servers. You can use this to write comments, too:
You can also open the current issue in your browser using cb
.
You can even use :Giadd
to create a blank issue. Saving the buffer will generate a new issue and update the buffer with an issue number and the ability to add comments.
How awesome is that!?
New feature: Use :Gmiles
to open a menu of milestones. Press return on one to select it and filter :Gissues
by that milestone from then on.
You have the ability to define your own issue search using Githubs search API. This allows you to view issues and pull requests across repos.
To use this feature, you can add a line like the following, with the search parameters that you wish to use.
let g:gh_issues_query = "state:open user:github label:\"feature\" sort:created-asc"
You can than get this list of issues using the command :Gisearch
Github will show any commits that reference the issue. That's what the omnicomplete helps with. But to make things even more awesome, github-issues.vim integrates with Fugitive.vim to make commit hashes clickable with the return key.
Vim with Python 2.7, Python 2.7 installed and working with Vim.
I recommend using Pathogen and Git cloning into ~/.vim/bundle. You can also just download the plugin and paste it into your plugin directory.
Then read below about adding an access token.
The omnicomplete and lookup features will work out of the box for public repos.
If you have private repos, or would like the ability to comment, open, close, and add issues, you will need to set an access token. Don't worry, this is super easy.
g:github_access_token
Grab an access token from here, then set this variable, preferably in a local vim file not included in any public repositories:
let g:github_access_token = "9jb19c1189f083d7013i24367lol"
Remember, you should treat your access token like a password!
Other options include:
g:github_issues_no_omni
When this is set to any value, github-issues will not set Neocomplete and Omnicomplete hooks.
g:github_upstream_issues
When this is set to 1, github-issues will use upstream issues (if repo is fork). This will require extra requests for the Github API, however.
g:github_api_url = "https://api.github.com/"
If you use Github Enterprise, where the Github server is hosted somewhere other than Github.com, set this parameter to your API path. This is specifically for Github Enterprise and will not work for Bitbucket, Gitlab, etc.
g:github_same_window = 1
When this is set to 1, github-issues will use the current window instead of splitting the screen via the :new
command.
g:gissues_lazy_load = 0
When this is set to 1, omnicomplete will not be populated until it is triggered. This eliminates potential lag when opening gitcommit
files.
g:gissues_async_omni = 0
Experimental: When set to 1, omnicomplete will be populated asynchronously, on another thread. This removes almost all lag from the UI when using Gissues, and can be combined with g:gissues_lazy_load to reduce network traffic while still receiving the same speed boost. However, this uses threads and needs a lot more testing to ensure it is stable.
Pull requests, feature requests, and issues are always welcome!
I hack around with Vim plugins, so follow me if you're into that kind of stuff (or just want to make my day) ;)