Ⅰ. 插件描述
yet another redmine source for unite.vimⅡ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin 'basyura/unite-yarm':source %
:PluginInstall对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle 'basyura/unite-yarm':source %
:NeoBundleInstall使用VimPlug管理器安装
在你的.vimrc下添加:Plug 'basyura/unite-yarm':source %
:PlugInstall使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/basyura/unite-yarmⅣ. 文档说明
"
" Version: 0.1.4
"
" Author: basyura <basyrua at gmail.com>
" Licence: The MIT License {{{
" 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.
" }}}
yet another redmine source for unite.vim
本家がないので yet も糞もないけど、もっといいのが出てくることを期待して
使い方
Unite yarm
チケット一覧の表示(かつ、一覧をキャッシュ)
キャッシュがあればそれを表示
パラメータ(パラメータを指定した場合はチケットを取り直す)
!
チケットを取り直す(条件未指定時は全ての open チケットを取得)
project_id (or project)
プロジェクトID (番号 or 識別子)
status_id (or status)
ステータスID (番号 or 識別子)
tracker_id (or tracker)
トラッカーID (番号 or 識別子)
assigned_to (or assigned)
アサインID (番号 or 識別子)
limit
検索対象チケット数
例1) Unite yarm:project_id=hoge:status_id=open:limit=100
例2) Unite yarm:project=hoge:status=open:limit=100
Unite yarm:!
キャッシュを破棄してチケットを取り直す
アクション
open
vim でチケットを開く
browser
ブラウザでチケットを開く
reget
チケットを取り直す
設定
let g:unite_yarm_server_url = 'http://localhost:3000'
サーバの url
let g:unite_yarm_access_key = 'your API access key'
認証に使用する API Access Key
定義されていない場合は更新不可
更新できるのは redmine の head or stable branch を使用している場合だけ
let g:unite_yarm_limit = 25
取得するチケットの数
let g:unite_yarm_backup_dir = '/tmp/yarm'
バックアップ先ディレクトリ
定義されていない場合はバックアップしない
必要なもの
webapi-vim
https://github.com/mattn/webapi-vim.git
open-browser.vim
https://github.com/tyru/open-browser.vim
チケット表示
url
Enterで該当ページをブラウザで開く
:w or :wq
チケットを更新(サーバに put)
保存済みチケットと更新対象(キャッシュ)の
updated_on が一致しない場合は
既に他ユーザから更新されていると判断して更新を止める
(排他をかけているわけではないので、微妙なタイミングで更新を検知できないこともある)
開始日、終了日、達成率
start_date : 2010-12-10
due_date : 2010-12-25
done_ratio : 70
↓
start_date : 2010-12-12
due_date : 2010-12-27
done_ratio : 40
: 以降の文字列を修正して保存すると更新される
チケット検索
#1234 と入力すると以下の候補が表示される
[get] #1234この候補を選択すると該当チケットを検索して表示する
TODO
・カスタムフィールドによる絞り込み
・コマンドの <Plug> 化
・チケット表示からの最新化(チケットの取り直し)
・サーバ切り替え
・API KEY 切り替え
redmine の API まち
・wiki の CRUD
・チケット検索
・wiki 検索