Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lambdalisue/vim-gita
[Obsolete] An awesome git handling plugin for Vim
https://github.com/lambdalisue/vim-gita
Last synced: 3 months ago
JSON representation
[Obsolete] An awesome git handling plugin for Vim
- Host: GitHub
- URL: https://github.com/lambdalisue/vim-gita
- Owner: lambdalisue
- License: other
- Archived: true
- Created: 2015-03-12T12:16:00.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-02-24T19:04:35.000Z (over 7 years ago)
- Last Synced: 2024-07-24T01:06:36.462Z (3 months ago)
- Language: Vim script
- Homepage:
- Size: 10.2 MB
- Stars: 226
- Watchers: 12
- Forks: 8
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://travis-ci.org/lambdalisue/vim-gita)
[](https://ci.appveyor.com/project/lambdalisue/vim-gita/branch/master)
[](LICENSE)
[](doc/gita.txt)
[](https://github.com/vim-jp/vital.vim)
**The development of vim-gita has closed. Users should check [lambdalisue/gina.vim](https://github.com/lambdalisue/gina.vim) which is a new impleomentation of vim-gita by using `job` features of Vim 8 or Neovim**
*gita* is a git manipulation plugin which allow users to perform daily git operation within Vim's live session.
With gita, users can:
- Manipulate the index of the git repository
- Stage content changes into the index
- Unstage content changes from the index
- Partially stage content changes into the index (like `git add -p`)
- Partially unstage content changes from the index (like `git reset -p`)
- Solve conflictions by using 1, 2, or 3-way diff
- Edit a commit message and commit the index into HEAD
- Edit, show, diff files in
- A working tree of the git repository
- A index of the git repository
- A specified commit, branch, etc. of the git repository
- List
- Files in the working tree of the git repository
- Files in the index of the git repository
- Files in a specified commit, branch, etc. of the git repository
- Files contains specified patterns
- Files changes between commits
- Blame a file content
And lot more.
gita uses a git repository which
- A current file-like buffer belongs
- A current working directory belongs
- An original file of the pseudo file-like buffer belongs
You may notice that this behavior is quite useful when you temporary open a file in a different git repository or in a non file-like buffer such as help or quickfix.
Additionally, gita aggressively uses cache mechanisms to improve its' performance. You would notice huge performance improvement if you are currently using `system()` to show git repository informations in statusline such as a current branch name or the number of modified files.
Install
-------------------------------------------------------------------------------
Use your favorite Vim plugin manager such as [junegunn/vim-plug] or [Shougo/dein.vim] like:
```vim
" Plug.vim
Plug 'lambdalisue/vim-gita'
"Plug.vim (lazy)
Plug 'lambdalisue/vim-gita', {'on': ['Gita']}
" dein.vim
call dein#add('lambdalisue/vim-gita')
" dein.vim (lazy)
call dein#add('lambdalisue/vim-gita', {
\ 'on_cmd': 'Gita',
\})
```
Or copy contents of the repository into your runtimepath manually.
[junegunn/vim-plug]: https://github.com/junegunn/vim-plug
[Shougo/dein.vim]: https://github.com/Shougo/dein.vim
Usage
-------------------------------------------------------------------------------
First of all, all commands which gita provides start from `:Gita` and all commands (including `:Gita` itself) provide `-h/-help` option to show a help message of the command.
Additionally, hitting `?` in manipulation windows (e.g. `gita-status`) shows action and mapping helps.
See `:help gita-usage` for more detail.
### Status
To check or modify current statuses of a git repository, use `:Gita status` command like below.
The status of each modified files are shown a short format.
If you are not familiar with short format, see `:help gita-usage-status-cheetsheet` or a manpage of git-status.
[](https://asciinema.org/a/41576)
### Patch
To partially stage or unstage changes (like `git add -p` or `git reset -p`), use `:Gita patch` command on a corresponding file buffer like below.
It opens three vimdiff windows which indicates a contents of
1. HEAD (`gita://:show/HEAD:`)
2. Index (`gita://:show:patch/:`)
3. Working tree (``)
In INDEX window, all changes saved is patched to the index of the repository.
See `:help gita-usage-patch` for more detail.
[](https://asciinema.org/a/41579)
### Conflict
To solve conflicts, use `:Gita chaperone` command on a conflicted file buffer like below.
It opens three buffers which indicate a content of
1. OURS (`gita://:show/:2:`)
2. WORKTREE (``)
3. THEIRS (`gita://:show/:3:`)
See `:help gita-usage-chaperone` for more detail.
[](https://asciinema.org/a/12436gcrwmuf169s2ze6eedpi)
### Changes
[](https://asciinema.org/a/41583)
### Search (grep)
[](https://asciinema.org/a/51mvst9wu3s411bb2ahjvhyk8)
### Blame
[](https://asciinema.org/a/41585)
Bundle libraries and build statuses
-------------------------------------------------------------------------------
gita rely on the following bundled libraries. (Note: users don't need to install them while these are bundled.)
Status | Name | Description
---------|---------|--------------
[](https://travis-ci.org/vim-jp/vital.vim) | [vim-jp/vital.vim][] | A core library
[](https://travis-ci.org/lambdalisue/vital-Vim-Buffer-Anchor) | [lambdalisue/vital-Vim-Buffer-Anchor][] | An anchor buffer library
[](https://travis-ci.org/lambdalisue/vital-ArgumentParser) | [lambdalisue/vital-ArgumentParser][] | An argument parser library
[](https://travis-ci.org/lambdalisue/vital-ProgressBar) | [lambdalisue/vital-ProgressBar][] | A progress bar library
[](https://travis-ci.org/lambdalisue/vital-Vim-Console) | [lambdalisue/vital-Vim-Console][] | A console library
[vim-jp/vital.vim]: https://github.com/vim-jp/vital.vim
[lambdalisue/vital-Vim-Buffer-Anchor]: https://github.com/lambdalisue/vital-Vim-Buffer-Anchor
[lambdalisue/vital-ArgumentParser]: https://github.com/lambdalisue/vital-ArgumentParser
[lambdalisue/vital-ProgressBar]: https://github.com/lambdalisue/vital-ProgressBar
[lambdalisue/vital-Vim-Console]: https://github.com/lambdalisue/vital-Vim-Console
License
-------------------------------------------------------------------------------
The MIT License (MIT)
Copyright (c) 2015 Alisue, hashnote.net
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.