Introduction of creating Emacs Lisp Package

Transcript

1. パッケージ作成
2. はじめに • “info elisp” の Packaging の章を読みましょう
3. チェック項目 • ヘッダ , フッタは適正か • メタ情報は適切か • 必要最低限の環境でどうさするか • バイトコンパイル時に警告 , エラーが出ないか
4. ヘッダ / フッタ • 1 行目は ファイル名 --- 概要 概要は M-x list-packages Desription カラムに表示 される • 最終行は ;;; ファイル名 ends here
5. メタ情報 • 作者 • バージョン • 依存関係 • パッケージコメント
6. 必要最低限の環境で動作するか • Cask を使おう (el-get でも可 ) – bundler 的なもの – 依存関係を記述 • cask exec emacs -Q -l my-package.el としてエラーが出なければ依存関係は適切 ( 特定の関数実行時にロードする場合は除く )
7. Cask ファイル例 ;; repository (source gnu) (source melpa) ;; read dependencies from helm-ag.el (package-file "helm-ag.el") (development (depends-on "ert") (depends-on "helm-projectile"))
8. バイトコンパイル • 変数名 , 関数名の typo の検知 • lexical-binding が有効だと未使用変数も指摘 • deprecated, obsoleted な関数 , 変数の指摘 • バイトコンパイル時も cask exec emacs -Q
9. 名前付け ( 関数 , マクロ , 変数 ) • Emacs には名前空間が一つしかない – 安易な名前は容易に衝突する • パッケージ名を各名前のプレフィックスに使う • 名前が長くなるが , 補完を使えば耐えられる – 重複するパッケージがないか事前に確認仕様 • melpa, el-get のレシピ名を確認
10. •遅延ロード対応 • 必要な関数に autoload cookie をつける ;;;###autoload ← 該当する S 式の前に追加する
11. テスト • テストパッケージは標準 • travis-ci 等の CI サービスの利用も難しくない
12. Enjoy Emacs Lisp Hacking