130427 kansai-emacs-github

githubとコードレビューとemacsshiba_yu36

13/04/27 kansai.emacs 07

自己紹介

shiba_yu36 shibayu36

or etc...

http://shibayu36.hatenablog.com/

•株式会社はてな

•アプリケーションエンジニア

•はてなブログ

•外部API、課金などの基盤周り

Work

やっていること

•Cinnamon

•Kyoto.pm•perlbrew.el•open-github-from-here.el

github使ってますか？•仕事で？

•趣味で？

•複数人で？

仕事で使っています•複数人での開発

•品質保証のためのコードレビュー

•コミュニケーション

今日の話• githubのコードレビューの場面ごとに細かくツールを作っていった

•最終的にemacs拡張が出来た

• open-github-from-here.elの紹介

• emacsの話は少なめかも

コードレビューでの一場面

こういうクラスどう思う?

github上の特定ファイルのURLを示す

•最初はリンク辿ってた

• https://github.com/shibayu36/emacs/tree/master/README.md

•面倒

• terminalからfile指定で一発で開けると捗るかも

•現在のブランチのファイルを開けたら更に嬉しい

open-github-from-file

$ open-github-from-file (ファイル名)

open-github-from-file•ファイルを指定すると

•現在のブランチの

•指定したファイルのURLを

•ブラウザで開く

簡単なデモ• open-github-from-file open-github-from-here.el

• developmentブランチ

技術的Tips• https://github.com/(user)/(repo)/tree/(branch)/(filename) を開く

• user、repo、ブランチ、ファイルを取得すれば良い

技術的Tips• host名(GHEに対応)

• hub.host• user, repo• remote.origin.url

技術的Tips• branch名• git symbolic-ref HEAD

• refs/heads/(branch)

技術的Tips• repo内file path

• git rev-parse --show-toplevel• repository topのpath

•指定されたファイルとの比較

•それぞれの情報からURLを構築

コードレビューでの一場面

こういう書き方どう思う?

ファイルの行がハイライトされたURLを示す

•ファイルURLは行をハイライトできる

• //shibayu36/emacs/tree/master/README.md#L3..L10

•このへん、を示すのにハイライトが使える

open-github-from-file•行のはじめと最後を数字で指定出来るように改善

open-github-from-file

$ open-github-from-file ファイル名 行始 行終

簡単なデモ• open-github-from-file open-github-from-here.el 41 57

技術的Tips•行をフラグメントで指定するだけなので特に無い

ファイルの行番号覚えてないよね...

問題

ファイルの行番号覚えてないよね...

それemacsで簡単にできるよ

問題

open-github-from-here.el

出来ること• emacsの現在のバッファからgithubに飛べる

• regionが指定されてたらその部分をハイライトする

デモ

インストール

el-getの場合el-get-install open-github-from-here

https://github.com/shibayu36/emacs-open-github-from-here/

インストール

手動の場合git cloneして、load-pathを

https://github.com/shibayu36/emacs-open-github-from-here/

技術的Tips• URL構築は先ほどと同じ

• shell-command-to-stringで外部コマンドに任せてる

技術的Tips• emacsでファイル名、region位置を取得

技術的Tips• browse-urlコマンドでブラウザを開く

まとめ•複数人で開発して細かいツールを作っていったら少しずつ便利になった

•小さいことから作っていくとだんだん便利になる

• open-github-from-here.el良ければ使ってみてください

コードレビューでの一場面

こういう変更どう思う？

github上の特定commitのURLを示す

コードレビューでの一場面

•最初の頃はURL手打ちか、リンクを辿る

•面倒

• terminalからcommit指定で一発で開けると捗りそう

open-github-from-commit

• commit(a235fa, HEAD^)を指定

•現在のrepositoryの

•指定したcommitのgithub URLを

•ブラウザで開く

open-github-from-commit

$ open-github-from-commit (commit名)

簡単なデモ• open-github-from-commit

• open-github-from-commit HEAD^

技術的Tips• https://github.com/(user)/(repo)/commit/(commit) を開く

• user、repo、commitを取得すれば良い

技術的Tips• host名(GHEに対応)

• hub.host• user, repo• remote.origin.url

• commit

•入力, default: HEAD

技術的Tips• commit

•入力

•取得した情報からURL構築