Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paulkass/jira-vim
A vim plugin to access your Jira workspace directly from Vim
https://github.com/paulkass/jira-vim
jira plugin vim
Last synced: about 1 month ago
JSON representation
A vim plugin to access your Jira workspace directly from Vim
- Host: GitHub
- URL: https://github.com/paulkass/jira-vim
- Owner: paulkass
- License: gpl-3.0
- Created: 2019-03-31T02:44:53.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-07-04T00:30:57.000Z (over 4 years ago)
- Last Synced: 2024-11-14T16:45:29.090Z (about 2 months ago)
- Topics: jira, plugin, vim
- Language: Python
- Size: 3.61 MB
- Stars: 139
- Watchers: 5
- Forks: 6
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-list - jira-vim
README
# jira-vim
[](https://app.codacy.com/app/paul.kassianik/jira-vim?utm_source=github.com&utm_medium=referral&utm_content=paulkass/jira-vim&utm_campaign=Badge_Grade_Settings)
[](https://travis-ci.org/paulkass/jira-vim)
[](https://gitter.im/jira-vim/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](./LICENSE)
Jira-vim is a way to view your JIRA setup without the bloat of the JIRA UI.
Imagine browsing Jira on your computer. All those buttons, animations, and
fancy UI magic that you don't really need are really slowing down your
computer. It's not improving your productivity, on the contrary it makes you
wait and distract yourself while it loads features you'll never need! So I
created this: an attempt at de-bloating Jira by getting rid of the UI and using
the standard Vim environment that we know and love to display data that we
obtain from the API.
## Current Status: Working on the beta version
Ahoy, I compiled a tentative checklist of the stuff that will need to be done for the beta release. This checklist is a subset of all the stuff that will be done for the beta, so all the stuff here *will* be done, but this isn't necessarily the exhaustive list of all the things that will be included in the beta release. This also only includes new features, but not any tech debt tasks or technical housekeeping. Here it is:
- [x] Search Functionality
- [ ] Differentiate between various Issue types
- [ ] Colored syntax highlights
- [x] View issues assigned to you
- [ ] Update issue fields
- [ ] Creating new issues
If you have anything to suggest, please let me know!
You can also see what I'm working on right now by looking at [this github project](https://github.com/paulkass/jira-vim/projects/2).
Also, it will take me a long time to go through each of these checkboxes one by one and make them, so if you have a feature that you particularly like, I encourage you to [contribute](#contributing).
## Installation
With Pathogen, use:
cd ~/.vim/bundle
git clone https://github.com/paulkass/jira-vim
With Vim-Plug, use:
Plug 'paulkass/jira-vim', { 'do': 'pip install -r requirements.txt' }
### Dependencies on Python
Compile Vim with python3 for this plugin to function properly.
If you didn't use Plug, then install the `requirements.txt` file with pip. Usually the command is
pip install -r requirements.txt
## Documentation
I think I put most of the good stuff into `:help jiravim`, so definitely check that out for information about the commands and how to get the show on the road.
Once you got the environment set up, here is a basic workflow:
#### Basic Workflow
* Open your Kanban board with `:JiraVimBoardOpen `.
* Scroll up and down through the issues, and find one you would like to look at.
* Open the issue with `:JiraVimSelectIssueNosp`.
* Look at the issue, make notes about how wonderful your Product Manager is for writing detailed specs.
* You've had enough, you want to look at the other issues that the team must complete, so you return with `:JiraVimReturn`.
I will try to do my best to be as backward compatible as possible moving forward, but I can make no guarantees.
## Please Leave Feedback
If you do indeed try this plugin, please please please leave some feedback. I'm not the most experienced programmer, so if you have **any** comment or suggestion, either open an issue or send me an email at [email protected]. I will read all of your feedback (I promise).
## Contributing
Jira is a huge project, and many people use different parts of it. Doing this alone, for me, is a huge task, so I appreciate any help that comes by!
(You still have to read this boring text first though 😞: [Contributor Guidelines](./CONTRIBUTING.md))
### Testing
The project uses the [vader.vim](https://github.com/junegunn/vader.vim) plugin for intergration testing. Run
vim -Nc "Vader! test/*"
from the project root directory. Each pull request is tested with Travis CI and Codacy as well.
## ❤️❤️❤️ If you like this ...
Please consider giving it a rating at [https://www.vim.org/scripts/script.php?script_id=5800](https://www.vim.org/scripts/script.php?script_id=5800)
And please consider contributing to the project.