"
" 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 検索