Coding Rule

はじめに

ここの内容は今のところ叩き台レベルであり、今後変更される可能性がある。(TODO 早めに議論して fix できる部分から fix させていく)

Indentation

スペース2文字でインデントを行う。 このために以下の modeline を全てのスクリプトファイルに追加する。

" vim: tabstop=2 shiftwidth=2 expandtab

Exceptions

vital.vim はライブラリであるため、エラーの通知は例外を投げることで行う。直接 :echo などをしてはいけない。 例外を投げる場合は、vital: {module-name}: と言う prefix を付ける。

Prohibited features

以下の機能は、複数の vital がインストールされていた場合に衝突する可能性があるため、基本的に使用してはいけない。

• ユーザー定義コマンドの定義
• キーマッピングの定義
• augroup/autocmd の定義
• グローバル変数の定義/参照

ただし、これらの定義を補助する機能を提供する目的のライブラリなどに関しては例外となる。

Comments

Language

Always in English.

Folding comments

折り畳みコメント(" {{{ のようなもの) は基本的に付けない。

Abbreviation of commands/options

コマンド名・オプション名は省略してはいけない。

• 悪い例: fun ..., &tw
• 良い例: function ..., &textwidth

Naming

関数名、変数名はcamelCaseではなくunderscoreにする

• 悪い例: thisIsAPen()
• 良い例: this_is_a_pen()

Empty lines

• 関数定義の間に一行の空行を入れる。

" NG
function! s:hoge()
	
endfunction
function! s:foo()
	
endfunction

" OK
function! s:hoge()
	
endfunction

" Insert an empty line between functions
function! s:foo()
	
endfunction

• functionの直後、endfunctionの直前に空行を入れない。

" NG
function! s:hoge()

  let value = 10

endfunction

" OK
function! s:hoge()
  let value = 10
endfunction

Don't use l: for local variables

ローカル変数を使用する場合は l:をつけない。

ただし、以下の場合は l: を使用する。

• buffer localなoptionの値を参照するとき (例: &l:include)
• ローカル変数 count を使用するとき (例: let l:count = 10)

count という変数名を参照してはいけない

count という変数名を参照する場合は必ず l:count か v:count を使用し、count という変数名を直接参照してはいけない。

これは、count が v:count と同等であり混乱を避けるためである。

function! s:()
    " OK
    " ローカル変数で count を使用する場合は
    " l: を付属させる
    let l:count = 10

    " NG
    " count を参照する場合は v: か l: を付属させる
    " この場合は v:count が参照される
    echo count

    " OK
    " l:count を参照する
    echo l:count

    " OK
    " v:count を参照する
    echo v:count
endfunction

object-orientedなインタフェースを提供するか (例: newして得た辞書がいろいろ関数を所持している)

必然性があるときのみ提供し、そうでないときはベタな関数を提供する (どうせ名前空間があるので)。