mikutterコードリーディングの手引き
この度、久々にOSC京都に行けることになりました!わっほーい!
しかしながらこの2年ほど、まったくOSSな活動をせずにダジャレを量産するおっさんと化していたワタクシ。
このままだとアトリウムに着いた瞬間にておくれ達に拉致られて、京都湾(?)に沈められる!
と言う強迫観念に苛まれて夜しか寝れない体になってしまったので、
これまでのノウハウを生かしてmikutterのコードを読むときに知っといた方がいいことを纏めることにしました。
一人でもmikutterに興味を持ってソースをいじり始める人が増えますように。
前提
ソースコードの入手
公式サイトからgitコマンドで取得できます。
GitHubにあるmikutterリポジトリは有志がメンテしているもので、バージョンが古い可能性があります。
git clone git://mikutter.hachune.net/mikutter.git
mikutterのディレクトリ構成
|-- core | |-- boot | |-- lib | |-- miku | |-- mui | |-- plugin | |-- skin | |-- system |-- deployment |-- tasks |-- test
core/boot
mikutterの起動直後に動き出す処理がまとまっています。
コマンドラインオプション解析や(GTKプラグインが無い時の)イベントループ、プラグイン読み込みなどのコードがあります。
core/mui
mikutterのGUI(GTK2)のコードが格納されています。GUIを改造したいときは大体ここ。
後述のcore/plugin/gtkにはGTKを呼び出すコードはほとんどないので注意しましょう。
core/system
システムメッセージをTLに表示するためのユーザー(所謂みくったーちゃん)のモデルが定義されています。
core/plugin
標準プラグインが格納されています。後述します。
development
大体のLinuxディストリビューションで使えるパッケージ「AppImage」生成用のファイルが格納されています。
tasks
国際化のための翻訳関連のファイルが置いてあります。
test
ライブラリのテスト用のコードが格納されています。
標準プラグイン
mikutterはプラグイン機構が非常に柔軟で、主要な機能もプラグインとして実装されています。
その数なんと72個!この企画を選んだことを後悔しつつ、簡単に説明していきます。
core/plugin/achievement
mikutterを使っていると突如付与される「実績」を管理するプラグイン。
管理するのが仕事なので、実績の発動条件や実績メッセージは実績を授与する各プラグインに分散しています。
core/plugin/bitly
メッセージ含まれるURL短縮サービスBitlyで短縮したURLを展開するプラグイン。
core/plugin/bugreport
たまによくmikutterが落ちた時に、作者にバグレポートを送信するプラグイン。
core/plugin/account_change
「Twitterやその他のサービス」(World)のユーザーアカウントを管理するGUIと、アカウントを切り替えるGUIやコマンドを提供するプラグイン。
core/plugin/command
「本文をコピー」「返信」などのmikutterの標準的なコマンドが定義されています。
また「複数のメッセージが選択されている」などのコマンドが実行できる条件も定義されています。
自作コマンドを作るときにお世話になります。
core/plugin/console
Alt + Xで呼び出せるmikutterコンソールを司るプラグインです。
core/plugin/core
なんだこれ?
起動完了後にイベントフィルタのマルチスレッド動作を許可する感じ?
core/plugin/current_world
「現在選択されているアカウント」っていう概念を表現するプラグイン。
core/plugin/extract
mikutterの強力なメッセージフィルタ機能「抽出タブ」を司るプラグイン。
core/plugin/followingcontrol
プロフィール画面にフォロワー・フォロイー関係を表示するプラグイン。
core/plugin/gtk
GTK2によるGUIを司るプラグイン。
メインウインドウやダイアログと言った、大物のGUI部品のコードがあります。
TLなどの中身は、前述のcore/muiを参照すること。
後はイベントループがあったりします。
core/plugin/gui
通常、GUIを持つアプリはツールキット(mikutterの場合GTK2)と密接な関係があるので、
別のツールキット(Qtとか)を適用しようとするとめっちゃ改造が必要です。
しかし、mikutterはGTK以外のツールキットを使ったGUIプラグインが出てくることを想定して、
画面の操作はこのGUIプラグイン経由で行うことになっています。
core/plugin/guide
mikutterをはじめて起動したときに始まる茶番チュートリアルを司るプラグイン。
ここで使われてるTLメッセージにボタンが表示できる機能は有用なので、ぜひとも汎用化したいですね。
core/plugin/image_file_cache
画像ファイルをキャッシュする仕組みを提供するプラグイン。
core/plugin/intent
TLのメッセージのURLを開くときの処理を行うプラグイン。
マストドンのURLはブラウザじゃなくてマストドンプラグインのタブで表示したいとか。そんなことが出来る仕組みです。
core/plugin/libnotify
notify-sendコマンド経由でOSの通知ポップアップを表示するプラグイン。
core/plugin/mastodon
mikutterがメインターゲットとするSNS「Mastodon」と通信するためのプラグイン。
金具さんが作ってたWorldonっていうプラグインを取り込んだ形になります。
core/plugin/message_detail_view
mikutter 3.4で搭載された「詳細タブ」を司るプラグイン。
core/plugin/message_favorite
同じく「詳細タブ」機能のふぁぼられたユーザー一覧部分をつかさどるプラグイン。
core/plugin/modelviewer
mikutter 3.9から導入された汎用モデルビューワのプラグイン。
core/plugin/notification
ウインドウ下部のステータスバーにmikutterのおもしろ最新情報を表示するプラグイン。
core/plugin/openimg
画像のURLから実際の画像を得るためのプラグイン。
core/plugin/photo
画像のURLから画像モデルを得るためのプラグイン。
core/plugin/photo_support
画像を保持するサービスから具体的にどうやって画像を取得するかを定義するプラグイン。
core/plugin/profile
「プロフィール」タブの言語ファイルのみが格納されている。
enと言いながら中身がもろ日本語なのウケる。
core/plugin/proxy
設定画面の「プロキシ」の設定項目と、Net:HTTPクラスに対するモンキーパッチ。
core/plugin/quickstep
mikutter 3.9の新機能「Quick Step」。
core/plugin/skin_setting_gtk
設定画面の「スキン」の設定項目を提供するプラグイン。
ちなみにこれは拙作だったりします。
あー、ヤバいなぁ。本体の進化に取り残されてるなぁ。やっぱりとしぁさんに京都湾(?)に沈められるのでは。
core/plugin/smartthread
「会話スレッド」タブを司るプラグイン。
core/plugin/spell
mikutter 3.6から導入された、1つ以上のModelが連携する処理を定義する仕組み「Spell」を提供します。
core/plugin/user_detail_view
「プロフィール」タブを司るプラグイン。
core/plugin/web
クリックしたURLを外部ブラウザで開くためのプラグイン。
mikutterに特化したRuby Gemたち
mikutterを読み解くには、mikutterに特化したいくつかのgemも読み解かないといけないかも知れません。
これらは元々はmikutterに内蔵されていた処理ですが、その汎用性の高さからgemとして切り出した方が世のため人のためになると言う判断なんだと思います。
他のgemと違ってWebに使用例が転がっている状況ではないので、mikutterでの使用箇所をExampleだと思って頑張ってください。
diva
様々なメンバを保持する「モデル」を定義するためのライブラリ。
delayer
処理を登録しておいて、暇になったら実行してくれる。
pluggaloid
mikutterのプラグイン機構を実現するライブラリ。
delayer-deferred
delayerにnext()とかtrap()みたいなdeferred由来のメソッドを追加したもの。