nDiki : ソースコード

プログラミング言語の仕様・振る舞いを確認するために小さいプログラムを書く

プログラミング言語の仕様・振る舞いを確認するために小さいプログラムを書く。 「この式を評価すると値は何になるの?」とか「この2つの書き方どっちが速いの?」とか「この正規表現にどうパターンマッチングするの?」とかを確認したい時。

当たり前の進め方だと思っていたんだけれど、そうすることを勧めたらスルー気味だったので。

特にスクリプト言語なら 「a.ほげほげ 」(Perl なら a.pl)なファイル作って実行してみればいいじゃんと思うのだけれど手間に感じるのかな。本丸のプログラムのソースコードを書き換えて試す(Apache 再起動して Web ブラウザでアクセスしてデバッグプリント読むとか)よりよっぽどはやいよ。あと、単体テストファイルでやっちゃうのもアリ。

それに適当に記事としてまとめておけば、今度は自分が他人に説明する時にそれを示せば済むようになるしね。

Emacs の ffap-perl-module.el でカーソル位置にある Perl パッケージ名のファイルを開く

「Vim で Perl ソースコード上でパッケージ名の上にカーソルがあるときに gf するとそのファイルを開くんだけど、……」という話が出て、あ、それ Emacs でもやりたいと思って調べて設定した。

最初は FFAP の設定。実は今まで知らなかったのだけれど ファイル名などをポイントしている時に Cx C-f するとそのファイル名を guess してくれるl FFAP というのが標準で入ってた。

 (ffap-bindings)

で有効になる。

これでファイル名は OK。Perl のパッケージ名からファイル名を guess してもらうには ffap-perl-module.el を使う。

• http://user42.tuxfamily.org/ffap-perl-module/

上記から ffap-perl-module.el を取ってきて load-path の通っているところに置く。で以下を設定に追加。

 (eval-after-load "ffap" '(require 'ffap-perl-module))

これで Perl ソースコード中のパッケージ名が書かれているところにカーソルがある時に C-x C-f するとそのモジュールファイル名を minibuffer にデフォルトで出してくれるようになる。捗る。

なおデフォルトだと system Perl の @INC にあるものを探しにいくようになっているので、perlbrew 下だったり Carton で入れた local/ 下だったり開発中のモジュールだったりを見つけられるようにするには ffap-perl-module-path を設定しておく必要がある。

 (setq ffap-perl-module-path
       '("/path1/to/lib"
         "/path2/to/lib"))

ITエンジニア逆求人フェスティバルではソースコードを見たい

両国の KFC Hall で開催された、株式会社ジースタイラス運営の2015年卒対象「ITエンジニア逆求人フェスティバル」という企業・学生交流イベントに参加してきた。この手のは5月のサポーターズ主催イベント以来。

5月の時はまだ夏前でインターンシップが目下の感心事といった感じだけれど、今の時期になると就職活動という意味合いが強い感じ。

「ITエンジニア」というくくりなので必ずしも Web 系志望じゃない方がいるのはあるとして、それ以前にエンジニア志望じゃない人も参加されていたのは運営に課題があるんじゃないかな。あと経験されている技術要素して Unity・OpenCV・Kinect などを上げている方が多かったかな。なにか恣意的な参加者人選なのだろうか。

特に Web 系は独学である程度やってみる・作ってみるという事ができる高速道路が敷かれている世界なので、学生時代からいろいろされている人も多い。やっている、やっていないで結構差が出るので、Web 系を目指しているけれども何もやっていないという方はすぐにでも何か始めると良いと思う。

もちろん選ばれる立場として、優秀な方々にそこで活躍したいと思われる企業にならなければと身を引き締めなおした1日でもあった。

以下所属組織とは関係ない個人的見解:

• プレゼンテーション用のノート PC にはソースコードを入れておいて、見せてもらえるようになっていると嬉しい。ざっと拝見したい。デモよりもソースコード。PowerPoint よりもソースコード。
  • GitHub にありますというのはナイスだが、ネットワーク環境によってはぱっと見られない可能性があるのでローカルに clone してある状態になっていて欲しい。
• エントリーシートの「授業でやりました的プログラミング言語列挙」はナンセンスなので無いと嬉しいし、運営もそのように誘導して欲しい(がっつり何かを作ったというのならアリだけれど)。
• ソフトウェアとあまり関係のないサークル活動の紹介とか(相当のリーダーシップの資質が感じられない限り)ほとんどスルーなのであまりアピールしなくても平気。

でも自分が学生の頃そんなの全然出来てなかった……。

GitHub トレーニングチームから学ぶ Git の内部構造 #githubjp に行ってきた

GitHub 主催の「GitHub トレーニングチームから学ぶ Git の内部構造」に行ってきた。会場は Yahoo! JAPAN のある東京ミッドタウン。

内容的には「入門Git」の始めの方で説明されている Git のデータ構造(もはやファイルシステム)について。「Git の内部: グラフ、ハッシュ、圧縮」というのがトピックとのことだったので、漠然と Git のソースコードレベルでの話題になるのかなと思っていたのだけれど、そうでなかった。

新しく知った事:

• ./git/objects/<..>/<filename> の<..> の2文字はオブジェクト ID の最初の2文字(大量ファイルのディレクトリ分割のためというのはわかっていたけれど、ああ単純に最初の2文字だったんだ)。
• git fsck でリポジトリの不整合が見つかっても復旧はできない。復旧はバックアップからすること。
• pack という処理がある。詳しくは後で調べる。

オブジェクトが不変でかつ同じ内容ならオブジェクト ID が必ず同一になることを利用して、オブジェクトファイルを共用していることを発表中「ハードリンク」と言ってしまったけれど、多くの人がファイルシステムのハードリンクで実現されていることと勘違いしていた模様。質問を受けて説明しなおしていたけど。

ちなみに実際にファイルシステム上でハードリンクになるのは、ローカルリポジトリを指定して clone した時。大きなリポジトリでもローカル内で clone する分にはストレージ容量的にはあまり気にしなくて大丈夫。

Git の contrib/diff-highlight で文字列レベルの差分ハイライトと lv (未解決)

Git の contrib/diff-highlight を使って行単位ではなく文字列単位で異なる部分をハイライトしてくれるという記事を教えてもらった。

• Git の diff を美しく表示するために必要なたった 1 つの設定 #git - 詩と創作・思索のひろば (Poetry, Writing and Contemplation)

自分の設定では .gitconfig の color のところは

 [color]
         branch = auto
         diff = auto
         grep = auto
         interactive = auto
         showbranch = auto
         status = auto

となっていて pager 指定は .bashrc で

 if command -v lv > /dev/null; then
   export GIT_PAGER='lv -Ou8 -c'
 fi

と今している。diff-highlight*1 を PATH の通っているところにおいて、

 GIT_PAGER='diff-highlight | less -R' git diff HEAD~..HEAD

とかすると文字列単位で差分が反転色で表示される。

lv だと \x1b[7m で反転させるとそれまでの色属性が落とされてしまうのか、行のそれ以降が黒白/白黒になってしまう。 lv v.4.21*2 のソースコードを軽くみたけどちょっとしっかり読まないと対応できなさそうなので、今日は諦め。

diff-highlight は Perl スクリプトなので、こちらでハイライト開始とハイライト終了時のエスケープシーケンスをいじって lv で見栄え良くなるようにするのが簡単でいいかもなあ。

2014年02月05日追記

nkf を通す方法を教えてもらった。

Vim の jellybeans カラースキーマに似た Emacs テーマ Ujelly

Vim の jellybeans カラースキームにインスパイアされて作られたという Emacs 24 のカスタムテーマ Ujelly を入れてみた。

• https://github.com/marktran/color-theme-ujelly
  • ujelly-theme.el --- Ujelly theme for GNU Emacs 24

custom-theme-directory を設定するほどでもないので、require できるところに ujelly-theme.pl を配置しておいて、

 (if window-system
     (when (>= emacs-major-version 24)
       (when (require 'ujelly-theme)
         (load-theme 'ujelly t))))

としてロードするようにした(ujelly-theme.el を読むとその中で自身のあるディレクトリを custom-theme-load-path に追加してくれる)。

今までは Solarized の dark を使っていたんだけれど、ディスプレイが暗い時(省電力のためノート PC の液晶モニタを暗くしている時)に見づらいなと思っていたのでもうちょっとハッキリした感じのにしようかなと。

Ujelly テーマでソースコードを開いてみたら、くっきりメリハリがあって見やすくテンションが上がった。いい感じ! (スクリーンキャプチャは Perl 5.18.1 の Data::Dumper のソースコードの一部)。

ただ実際に入れてみると Solarized は目に優しいなとあらためて実感して良さを再認識することにもなった。Solarized も捨て難いね。

• http://ethanschoonover.com/solarized
  • Solarized

今日のさえずり: C-t o してしまってソースコードが気がつくと壊れていて悲しい

• 13:28 Skype for Windows 6.11 は重いらしいので 6.14 にアップデートした。
• 16:24 tmux でプレフィックスに C-t を割り当てて C-t o で次の pane への移動慣れてきたなーと思ったら、 Emacs で C-x o でウィンドウ選択するつもりで C-t o してしまってソースコードが気がつくと壊れていて悲しい。
• 16:56 Skype for Android のアップデートに「アラートと通話が適切なスピーカーまたはBluetoothデバイスを通じて再生されるようになりました。」って書いてある。 Bluetooth ヘッドセット使えるようになったのかな?
• 22:18 Skype for Android を 4.6.0.42007 にアップデートしたら Bluetooth ヘッドセットで通話できるようになった。素晴らしい。
• 23:07 Gmail のビーコン対策、あれ結局アクセス自体はビーコンのサイトに行くと思うので設定を「外部画像を表示する前に確認する」に戻した。

ホテル三日月はいい値段とか【日記】

夏に竜宮城スパホテル三日月で2泊ぐらいどうかなーという話があったのでちょっと調べたのですが、7月下旬とかだと1泊2万円超なんですね。結構しますな。

それから、アプリ開発のチームにも入ることになったので iOS アプリの開発環境を用意した方が良いかなと思ったのですが「コードは書く予定ないですよね? であれば Xcode でソースコードが見られるぐらいでどうですか」となりました。確かに書く余裕は無いですね。

仕事で使っている15インチ MacBook Pro はまだ OS X El Capitan のままなので Xcode を入れるにはまずはそこのアップデートが必要。そこからか。

トライアル実装について書き出して情報発進するということ

保守が難しくなってきたライブラリを使うのをやめ、まだ導入していない新しいライブラリを使う実験的取り組みをしている担当者に「ドキュメントにまとめておいてほしい」とリクエストしたら「誰が何のために読む想定で書けばよいか」という良い質問をもらった。ドキュメント化で期待する価値について伝えられるよう整理しなおした。

ドキュメント化で期待する価値

今回のトライアル実装のドキュメント化で期待する価値は以下と考えている。

• 個人の学習: 取り組んでいるメンバ自身の理解が深まる。
• 資料化: ソースコードから読み取りにくい 「なぜそういう設計・実装にしたか」を今後保守する人が理解するときの助けになる。
• 組織の学習: 今後同じライブラリを使うことになる組織のほかのメンバが将来参考にできる。

ということで「今のチームメンバ」「将来のメンテナ」「将来の組織の他のメンバ」が読者の想定だ。

「詳細設計書」をまとめるより「今回やったこと」と「分かったこと」「考えたこと」「気付いたこと」(わかき)を整理して書き出すことが、形式知化とナレッジ共有に役立つと考えている。

「ドキュメントにまとめておいてほしい」には「成果物としてドキュメントを残してほしい」だけでなく「情報発信をするメリットを知ってほしい」という思いも含んでいたりする。

• すべての情報を共有する。情報閲覧者が判断する。
• 私が情報発信を勧める理由
• 「わかき」分かったこと・考えたこと・気付いたこと

[ opinion ]

mkdocs-backlinks うまく使えず【日記】

髪伸びてきたので来週で床屋の予約をした。

MkDocs + Roamlinks Plugin で静的サイト生成している組織内公開ワーキングノートサイトでやっぱりバックリンクが欲しいなと思って mkdocs-backlinks v0.9.1 試してみた。

がバックリンクを出力させられず。ソースコードを読んでみたがうまく動かない理由は分からずじまい。

今日のさえずり: 泣いてるウサギじゃないのだ

• 09:50 髪伸びてきたので来週で床屋の予約をした。
• 12:52 泣いてるウサギじゃないのだ。 https://twitter.com/...
• 13:35 今のミーティングで Plantronics M55 Bluetooth ヘッドセットにビリビリという音が混ざっていたのちょっと気になる。
• 13:35 買ったの2014年2月だし、そろそろ寿命なのかもしれない。
• 13:51 音質重視のイヤホンより通話向けヘッドセットの方が、Google Meet 音声の圧縮感が気にならなくて良いんだよね。
• 16:57 別のイヤホンでもビリビリしたので、ヘッドセットの問題じゃないっぽい。
• 19:53 mkdocs-backlinks v0.9.1 試してみたけどバックリンクを出力させられなかった。ソースコードを読んでみたが、うまく動かない理由は分からず。
• 26:10 2023年2月22日 (水) したこと - 来週の床屋を予約する - mkdocs-backlinks を試す