ライブラリやフレームワークを早く使いこなす方法

Share
ライブラリやフレームワークを早く使いこなす方法

ライブラリやフレームワークを早く使いこなす方法

このブログでは自分なりに得た個人開発についての方法論をいろいろと紹介している。全工程を自分でやらなければならない個人開発は、自身の能力を底上げするのに最高の方法でもある。その過程で、アプリをよりよいものにするために新しいライブラリやフレームワークの導入を検討する事も多々あるだろう。

コードを書く時間というのは実は意外に短くて、基本的に作業時間の40%以上は勉強や調べ物に費やされる。以前、WakaTimeというコーディング時間を計測するサービスで計ってみたら、週に20時間程度しかやってなかった。となると、ドキュメントを読む時間やそれを理解する時間は、場合によってはボトルネックになりうるという事だ。言い換えると、ライブラリやフレームワークの使い方を素早く把握できれば、仕事の速さが大きく向上する。

本稿では、技術の使い方を素早く把握して手早く自身のプロダクトに適用するための考え方をシェアしたい。

まず技術を学ぶことは目的ではない事に注意する。アプリを作ることが目的なので、使いたい技術の全容を把握する必要は全くない。超初心者はともかく、本を買ったりして1ページ1ページありがたく目を通すなど時間の無駄。本を読んでいる自分に酔っている事に気づいた方がいい。基本を把握したら、あとは分からないところを掻い摘んで調べればいい。

知らないことを恐れる必要はない。エラーにぶつかることも恐れる必要はない。自分は今もしかしたら非効率だったり間違ったやりかたで作っているかもしれないという不安を受け入れる。ハードウェアだと間違えば壊れてしまうリスクがあるけど、ソフトウェアは何度でもリセットできる。

何かと教科書のようにまとまった情報を求める人がいる。確かに部分的な知識で車を運転すれば死の危険があるけど、ライブラリを誤って使って死ぬことはまず無い。だから「なんだこのAPI?叩いてみよう」ぐらいの気軽さでいい。

一般的に広く使われるフレームワークやライブラリは、その使い方に綺麗な一貫性がある。なぜなら、不規則で全部まる覚えしなければならないような技術は使いづらくて人々に受け入れられないから。

すごく単純な例を挙げると、PHPにstrpos(A, B) という関数がある。この関数は、 A で指定した文字列の中から B を探して、何文字目に見つかったかと返すもの。添字はゼロ番目から始まる。つまり、3文字目に見つかれば2が返る。さて、もしBが見つからなかったら何が返る?

答えはFALSE。これは覚えるしか無い。じゃあ次、 array_search(A, B) という関数があって、これは B の配列から A を探して、何番目の要素に見つかったか返す。さて、要素が見つからなかった時の戻り値は NULL か、それとも -1か?

いやいや、答えはFALSE だ。NULL か -1 かという選択肢に違和感を覚えた人は要領がいい。もし素直にうーんと悩んじゃった人は、教科書的に丸覚えしようとしている。strpos も array_search も中身を探すという内容の関数なんだから、見つからなかった時の戻り値がもしそれぞれ違ったら設計に一貫性が欠ける事になる。だからおかしい、という考え方が重要。

PHPには他にも strrpos という似た関数がある。見つからなかった時の戻り値は…もうドキュメントを読まなくてもお分かりだろう。

いい技術は名前にもしっかり一貫性がある。だから全部覚えなくてもなんとなく「こういうメソッドを探してるんだけど、こんな名前でありそうだなー。ほらあった!」と推測できることが大事。

例えばElectronのBrowserWindowというクラスには沢山のメソッドが用意されているけど、命名規則がしっかりしていてとても探しやすい。ウインドウを最大化する maximize() というメソッドに対して、最大化されているかどうかを調べる isMaximized() というメソッドがある。もうお分かりのように、 minimize() と isMinimized() も同じく用意されている。

まぁ最大化と最小化も出来るんだからフルスクリーンもこのクラスで出来そうだよね、ほら setFullScreen() と isFullScreen() があった。と、こういう感じで推測していく。もしフルスクリーン処理だけ別のクラスに用意されていたら、設計がおかしいか何か別の事情があると考える。

このように、相手の気持ちを慮れる人の方が人付き合いが上手いように、設計者の気持ちを想像できる人の方が技術と上手く付き合える。

上記で述べたような法則は、典型的な良いソフトウェアの特徴。だから自分がコードを書くときも同じようにルールを意識すると、後々助かる事が沢山ある。なぜなら、一ヶ月後の自分は別人だから。

時間が経って綺麗サッパリ忘れた自分が過去の自分のコードを読み取る時、簡潔なルールに沿って書かれていれば、「あの処理はあそこにあるっぽい」とすぐに把握して作業を再開できる。サーバを書いて、クライアントを書いて、一ヶ月後にまたサーバを書く、という事はざらにある。その場しのぎのコードは身を滅ぼす。継続的に個人開発していくためには、自分の過去のコードをすぐに把握できる事がとても大事。

この記事があなたの個人開発の手助けになれば嬉しい。

使ってね!!

Read more

個人開発で日本から海外へ、10年間の歴史 — ひろしさんとの対談(前編)

個人開発で日本から海外へ、10年間の歴史 — ひろしさんとの対談(前編)

数週間前、ひろしさんのポッドキャストにゲストで出演しました。お互いの長い個人開発の経験について語り合いました。英語版を作成する過程で、日本語でも綺麗に整形した書き起こしが出来たので、こちらに掲載します。お楽しみください。 ※ギアアイコンをクリックして、音声と字幕を日本語に変更できます。 00:00 イントロ:TAKUYAさんようこそ 01:32 TAKUYAさんの自己紹介:WalknoteからInkdropまで 04:54 独立への踏み切り方:慎重派と勢い派 06:51 個人開発がフリーランス案件につながった 09:17 Inkdropで食えるようになるまで 12:15 なぜ最初から海外市場を狙ったのか 14:54 AI登場前、英語コピーに苦戦した話 16:18 AIバイブコーディング時代をどう見ているか 17:24 全てのコードを一行ずつレビューする使い方 21:06 AIは新幹線:速さの先にあるもの 25:53 AI時代に「感性」が大事になる 27:

By Takuya Matsuyama
「一汁一菜」にAI時代の生き方が詰まっている

「一汁一菜」にAI時代の生き方が詰まっている

どうも個人アプリ作家のTAKUYAです。 今回は、AI時代を開発者・クリエイター・表現者としてどう健やかに生きるか、について考えていることをシェアしたいと思います。ここでの「健やかに生きる」とは、心身の健康を保ちながら、ものづくりを楽しみ続けるという意味です。 読者の中にも、最近のAIの急速な進化の中でどう生き残り、さらに活躍していくかを悩んでいる方は多いのではないでしょうか。正直、すべてに対する正解はわかりません。未来を正確に予測できる人はいないからです。 でも自分は、ソフトウェア寄りのアーティストとして生きる上で大事なのは、「戦略」や「堀(moat)」を築くことよりも、「生きる方向性」 だと思っています。 人生とは速度ではなく方向である – ゲーテ 自分はどこに行きたいのか?何を見たいのか?それが大事です。戦略は状況に合わせて柔軟に変えればいいからです。 今回は、日本の文化からいくつかの生き方の原則を探ってみたいと思います。 最近、料理研究家の 土井善晴 さんの 「一汁一菜でよいという提案」 を読んで、日々のリズムを健やかに保つためのヒントがたくさん詰まっていると感じまし

By Takuya Matsuyama
Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

💡本記事は英語ブログの日本語訳です。 どうも、TAKUYAです。 AIコーディングでは専らClaude Codeを使っています。最初はtmuxでターミナルの右側にペインを分割して使っていたのですが、幅が狭すぎてメッセージやdiffがまともに表示できず、使いづらかったです。 <Prefix>+zでペインを最大化すればいいのですが、毎回やるのは面倒でした。 そこで、ポップアップウィンドウでClaude Codeを起動するようにしました。キーバインドを押せばセッションが開き、閉じてもバックグラウンドで動き続けるので、すぐに再開できます。 この記事では、それを実現するためのtmuxの設定方法を紹介します。 動画で見る(英語): ポップアップウィンドウはサブプロセスを維持できない tmuxのdisplay-popupコマンドを使うとポップアップウィンドウを表示でき、ちょっとしたツールにすぐアクセスするのに便利です。 僕はlazygitでgitの状態をサッと確認するのに使っています: bind -r g display-popup -d '#{pane_current_path}'

By Takuya Matsuyama
Keychron K2 HEを無刻印化する手順

Keychron K2 HEを無刻印化する手順

どうもTAKUYAです。KeychronさんにK2 HEをお願いしたら音速で送ってくれたので、無刻印化してみました。どうやったのか過程をシェアします。 Unboxing 上はKeychron Q1です。これは3年間ぐらい使ってきました。キーキャップが若干くたびれていますね。でも問題なく今まで使えていました。そろそろ飽きてきたので新しいキーボードを試したいと思い、前から気になっていたK2 HEを試すことにしました(写真下)。 Amazon | 【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、2.4GHz・Bluetooth無線対応、QMKプログラム可能、アルミ+ウッドフレーム、USレイアウト、RGBライト、Mac Windows Linux対応 (ブラック) | Keychron | パソコン用キーボード 通販【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、

By Takuya Matsuyama