koheisg.dreamin.ccRSS

rspec-daemonの個人的な設定が決まった

RubyKaigi2024 お疲れ様でした。

別にRubyKaigi関係ないけど、 rspec-daemon の設定を今更してみたのでメモ。

ちょっとペアプロしたときに、動いてたはずのGuardが動かずファイル保存したらrspec実行みたいなことが上手くいかなくなっていた。

rspec-daemonは追加とかは公式ドキュメントを見ればいいだけなんだけなので、そちらに譲るとして、公式ドキュメントにはleaderで実行みたいなのしかなかったので、僕はこういう設定にして、保存したらrspecが実行されるようにしました。

vim.api.nvim_create_autocmd({ "BufWritePre" }, {
  pattern = {"*_spec.rb"},
  callback = function()
    local specfile = vim.fn.expand('%')
    vim.fn.system('echo ' .. specfile .. '| nc -v 0.0.0.0 3002')
  end
})

rspec-daemonはデーモンを $ rspec-daemon で立ち上げておきつつ、別でシグナルを送らないとrspecが実行されないのです。 が、逆に echo $specfile | nc -v 0.0.0.0 3002 の部分はデーモンが立ち上がってないと空振りしてくれるので、この設定で気に入りました。

Neovim って結構色々遊べそうですね。

ソフトウェアファーストなはずの会社が、いつの間にか顧客開発できなくなってる問題

ソフトウェアファースト

エンジニアを採用して、投資したら、ちゃんとその分以上の売上をペイできる会社というのはソフトウェアファースト企業ということです。 例えば、「エンジニアがこの機能をリリースしたら、XXX円の利益が出る。」「エンジニアがサーバーを落としたらXXX円の損失になる。」という状況が作れている会社です。

イメージしやすいのはソーシャルゲームの会社でしょうか。メルカリさんのようなC2Cの会社もトランザクション毎に課金が走るのでわかりやすいでしょう。食べログさんやクックパッドさんなどの有料ユーザーも良いUXの機能を実装することで、アドオンのサブスクが提供できるので、ある機能のリリースによって有料会員が増えた減ったにつながるので、ソフトウェアファーストになっていそうです。

B2Cサービス企業は、Web上で集客し、Web上でマーケティングし、自社サービスのコンバージョンさせます。 ですので、そんなの大きなコンフリクトは起こりにくように思います。 (自社広告チームなどB2Bチームが成長してくると、成長エンジンが違うところにも発生するので、実は出てくるのですが、一旦無視)

B2B SaaSもソフトウェアファーストな会社です。業界特有だったり横断的だったりは色々ありますが、社内のインフラをSaaSで一手に解決するわけです。エンジニアがいなければ機能を作ることができません。「この機能があれば導入したい!」「この機能があればもっとお金払いたい!」という顧客の要望を叶えるのは常にエンジニアですよね。

B2B SaaS企業で起こりそうな部門間コンフリクト

だけれど、B向けSaaSの会社は営業さんが突破力を発揮して、一気に売上を作ってくるかもしれません。 そういう売上を立てらる優秀な営業さんが、「この機能があったら、XX売ってくる」と言うかもしれません。そして、実際にその機能を作ったら、その営業さんはXX売ってくるかもしれません。

こうなったら、ソフトウェアファーストが崩壊し始めています。 この営業マンが作る会社になっていきます。それで売れるのであれば、会社としては問題ないので、それでもいいかもしれません。

が、次第に起こることは、営業部門のアイデアをリサーチをせずにスケジュールが確定し、それによりエンジニア部門は社内受託開発のような立ち位置になり次第に疲弊していきます。 エンジニアが一人抜け、二人抜けしていくと、元々予定した納期に間に合わなくなっていきます。

そもそも、営業部門の外れなかったアイデアも、限界がいつかきます。(HiPPoというアンチパターン) スティーブ・ジョブズでもNewtonという大失敗作を作ったことを忘れてはいけません。

参考文献: アジャイルエンタープライズ

越境しよう

プロダクトが未成熟な時は、プロダクトに足りない機能を作ればいいだけなので、実はアイデアを出すのは簡単です。 しかし、プロダクトが成熟していくと新しい一手を生み出すにはとても難しくなってきます。

こうした時は越境するチームを作っていきましょう。 開発者を営業先に連れていきましょう。ユーザーインタビューをしましょう。開発の優先度の交渉を行いましょう。なぜ開発に時間がかかるようになってきているのか、順を追って説明していきましょう。

こうした時に必要なのは顧客開発の手法です。 リーンスタートアップ関連の書籍やデザインスプリント関連の書籍が参考になるでしょう。

リーン顧客開発 ―「売れないリスク」を極小化する技術 (THE LEAN SERIES)

SPRINT 最速仕事術――あらゆる仕事がうまくいく最も合理的な方法

プロダクトオーナーやスクラムマスターはステークホルダーに対して責任を負っているので、越境して経営毎変えていく必要がありますね。 あー、これは大変だ。本当に大変だ。でも、ビジョナリーなスタートアップなら、必ず変わることができますよ。

最近使うのをやめたもの、最近使い始めたもの

fish辞めた

fishすごく好きだったけど、起動が遅い気がしてやめた。 標準的なshellが使えないことがあるのもやっぱり不便だった。

fishはthemeとか補完とかが優秀で大体fisherでなんでも管轄するのが良い。

zsh使い始めた

その代わりzshにした。 zshはというと、そう言ったいけてるエコシステムがない気がする。 ohmyzshが圧倒的だけど、要らないものまでがっつり入ってきて起動が遅くなってしまったりして、嫌だ。まぁそれに自分を合わせる手もあるんだけれど。

Macのデフォもzshになったし、とある案件でzshを使ったときにかなり環境も整えたのもあって、zshの良さに気づいてしまった。 zshの設定は本当に最低限しか書いていない。aliasやfunctionは必要があったら足していってる。 自分で使うものだけ自分で管理できてて、大変気に入っている。

starship

fishやめてstarshipもやめた Zshでも使えたけれど、なんとなく起動がもたつく感じがした。 と言うのと、後述のp10kの体験がとても良かった。

p10k

僕はp10kというのを使っている。これはVCSやらの情報を出すのに便利なのと早い。テーマも複数から選べるので万人に勧められる。

vimやめた

色々秘伝のタレを綺麗にしたので、いい感じになっているので、いつでも戻れる。 Lsp周りもちゃんと設定してるけれど、とある理由でやめた。

neovim始めた

Vimでちゃんと設定したんだけれど、neovimはcoc系に頼ってる。 正直いらないものがあるので、ダイエットしたい。

copilotがneovimに公式が対応しているので、一旦乗り換えた。

dockerやめた

dockerもmacで使うのは辞めました。 必要があればLinux上で動かすようにしてます。

環境構築は好きだから大丈夫です。 IOの壁を越えられなかったって感じかな。やっぱりきびきび動いてほしい。

anyenvやめた

とても、これまでお世話になったけど、*envに縛られるのもなぁというので辞めました。 asdfを試そうとしたけど、ghqとgemsrcとrbenv pluginの連携が上手く行かなかったので、生でrbenvとnodenvを使うようにしました。

あと、地味にanyenvだとrubymineとの連携がめんどくさかったのに気づきました。

まとめ

色々やめて色々始めるぞ

shared_examples とshared_context の使い分けについて

Twitter眺めていると楽しい機能の話です。

shared_examples と shared_context は実装的には同じものですが、 個人的にはdescribeがテスト対象の明示、contextがテスト条件の明示で使い分けるのと同じように以下のルールでやっています。

  • itを共通化したいときはshared_examples
  • contextを共通化したいときはinclude_context
  • describeは共通化しない

shared_examples の使い方

Shared examplesのRSpec公式のドキュメント を見てみましょう。

RSpec.shared_examples "some example" do |parameter|
  \# Same behavior is triggered also with either `def something; 'some value'; end`
  \# or `define_method(:something) { 'some value' }`
  let(:something) { parameter }
  it "uses the given parameter" do
    expect(something).to eq(parameter)
  end
end

RSpec.describe SomeClass do
  include_examples "some example", "parameter1"
  include_examples "some example", "parameter2"
end

このようにinclude_examplesをすることで、テストする条件をまとめることができます。 include_examples は it_behaves_like と書いてもokです。

公式ドキュメントがわかりやすいですね! わかりやすいので、shared_examplesばかり使われている気がするぞ。。。

shared_context

次にshared_context。 以下はShared contextのRSpec公式のドキュメント の例を短く改変しています。*1

RSpec.shared_context "shared stuff" do
  subject { xxx }
  before do
    create(:stuff)
  end
end

require "./shared_stuff.rb"

RSpec.describe "group that includes a shared context using 'include_context'" do
  include_context "shared stuff"

  it "accesses the subject defined in the shared context" do
    expect(subject).to eq('this is the subject')
  end
end

個人的に上記のような shared_context はあまり好きではありません。 テスト対象であるsubjectやshared_methodがshared stuffの中に隠蔽されてしまっていて、何をテストしているかがわかりにくいからです。 私が書くなら以下のようになるでしょう。

RSpec.shared_context "shared stuff" do
  before do
    create(:stuff)
  end
end

require "./shared_stuff.rb"

RSpec.describe "group that includes a shared context using 'include_context'" do
  subject { nanika }

  include_context "shared stuff"

  it "accesses the subject defined in the shared context" do
    expect(subject).to eq('this is the subject')
  end
end

「subjectを毎回書かなくちゃいけない!」と思うかもしれませんが、テスト対象は毎回定義しません? じゃないと、何をテストしているかわからなくなってしまいます。 もちろんshared_contextに引数で毎回差し込むこともできるのですが、それだとsubjectを書くのと何も変わらないので、subjectは毎回書くようにしています。

うん。わかりやすい。

まとめ

shared_exampleはsystem specの権限管理的や暗黙的にテストしておきたいときに自動で発火するように仕込むのに便利です。*2 ちょっとしたテストのDRYのために、shared_exampleを使ってしまうとテストコードが変更に弱くなってしまうので注意しましょう。

一方shared_contextは「ある条件のユーザーを作る」や「ユーザー1でログインする」など再現性のある「条件」を作成するのに使うと便利です。 shared_contextはテスト条件を再利用するのに便利ですので、ちょっとしたテストのDRYのために使うことも多いでしょう。 このときに先述のsubjectを隠蔽するようなことをやってしまうと、私の経験上厄介なことになります。 *3

AAA(Arrange Act Assert)の考え方を知ってる人には、「あーAssertをshared_examplesで共通化して、Arrangeをshared_contextで共通化して、Actはベタで書くのね。なるほどね〜」となったと思います。

*1 shared_stuff.rbに shared_context 'shared stuff'が定義が省略されているので、それを個人的に解釈して補完して追記。 *2 暗黙的にテストしたい場合は、metadata を利用したものが便利です *3 その他には shared_contextもshared_examplesも別ファイルで管理することになるので、具体的な名前をつけたほうがいいよ!ってtwadaさんが言ってたよ! RSpec3で書かれた jnchito さんの記事 もあります。)

「コマンドがわからなかったら、ググる前にmanコマンドを打ってみよう」その前にtldr

うちのブログの 前回の更新 が man の話だったので、更新せざるを得ない。

ということで、これめちゃくちゃ便利ですね。

https://tldr.sh が公式ページです。 GitHubを見てみると、 かなりの数のコマンド が対応しています。 日本語 も結構対応していっていますね。

manよりもコミュニティドリブンなところがハマった人がすぐに貢献できそうで、tipsが貯まる感じになりそうで良さそうです。

例えば、 ls をとってみると、、、

$ tldr ls

ls

List directory contents.
More information: <https://www.gnu.org/software/coreutils/ls>.

- List files one per line:
    ls -1

- List all files, including hidden files:
    ls -a

- List all files, with trailing `/` added to directory names:
    ls -F

- Long format list (permissions, ownership, size, and modification date) of all files:
    ls -la

- Long format list with size displayed using human readable units (KiB, MiB, GiB):
    ls -lh

- Long format list sorted by size (descending):
    ls -lS

- Long format list of all files, sorted by modification date (oldest first):
    ls -ltr

完全に、よく使いそうなものから並んでいますね。。。。 ちなみに私は ll に ls -ltr をalias しております。

ちなみに難関コマンドの find と xargs の例も貼っておきます。 これは普通に便利じゃね?という気持ちになるかと思います。

$ tldr find

find

Find files or directories under the given directory tree, recursively.
More information: <https://manned.org/find>.

- Find files by extension:
    find root_path -name '*.ext'

- Find files matching multiple path/name patterns:
    find root_path -path '**/path/**/*.ext -or -name '*pattern*'

- Find directories matching a given name, in case-insensitive mode:
    find root_path -type d -iname '*lib*'

- Find files matching a given pattern, excluding specific paths:
    find root_path -name '*.py' -not -path '*/site-packages/*'

- Find files matching a given size range:
    find root_path -size +500k -size -10M

- Run a command for each file (use `{}` within the command to access the filename):
    find root_path -name '*.ext' -exec wc -l {} \;

- Find files modified in the last 7 days and delete them:
    find root_path -mtime -7 -delete

- Find empty (0 byte) files and delete them:
    find root_path -type f -empty -delete
$ tldr xargs

xargs

Execute a command with piped arguments coming from another command, a file, etc.
The input is treated as a single block of text and split into separate pieces on spaces, tabs, newlines and end-of-file.

- Run a command using the input data as arguments:
    arguments_source | xargs command

- Run multiple chained commands on the input data:
    arguments_source | xargs sh -c "command1 && command2 | command3"

- Delete all files with a `.backup` extension (`-print0` uses a null character to split file names, and `-0` uses it as delimiter):
    find . -name '*.backup' -print0 | xargs -0 rm -v

- Execute the command once for each input line, replacing any occurrences of the placeholder (here marked as `_`) with the input line:
    arguments_source | xargs -I _ command _ optional_extra_arguments

- Parallel runs of up to `max-procs` processes at a time; the default is 1. If `max-procs` is 0, xargs will run as many processes as possible at a time:
    arguments_source | xargs -P max-procs command

結構前からあるプロジェクトだったけれど、知りませんでした。 積極的に使っていこうっと。

それでも man を読むのは大事 だけどな。

コマンドがわからなかったら、ググる前にmanコマンドを打ってみよう

最近はVSCodeなどのIDEが開発に使う言語に問わずハイスピードで普及して、フロントエンドエンジニアでもバックエンドエンジニアでもコマンドを叩くことが少なくなってきたように思います。 若干老害トーク感がありますが、僕が新卒の頃は必ずサーバーにログインして何らかの作業を誰もが当たり前のようにやっていました。

それでも、少なくなったとはいえ、全くコマンドを叩かずに済むエンジニアはいないでしょう。まだ今日のGUIやその他のインターフェースは、CLI(Command line interface)より優れた部分はあれど、全てが優れているわけではありません。

CIやDocker、wikiではまだまだ現役のコマンド達

多くのCIはshellをサポートしていますし、Dockerでもやはりコマンドを使うことがあります。また、コマンドはコピペして簡単に再現できるので、まだwikiや手順書にこの順番でコマンドを実行してくださいと書かれることも多いでしょう。

意味がわからないコマンドに出会ったら?

wikiの中にわからないコマンドがあり、意味を知りたい場合はどうしましょう? 例えば $ ls -ltr の意味がわからなかったとしましょう。 $ ls の意味はわかっても、オプションの意味がわからない場合、あなたはどうしますか? ls -ltr とGoogleで検索すればある適切な結果が表示されるかもしれません。しかし、2020年現在全てのコマンドラインオプションで検索しても、なかなか Gooleは適切な答えを表示してくれません。とくに短いコマンドラインオプションについてはかなり不正確です。

manコマンドを使ってみましょう

man ls としてみましょう。 manはmanualの略です。こうすることで、lsのmanualを見ることができます。 英語でつらつらといろいろな説明があります。

先ほどの ls -ltr は ls -l と ls -t と ls -r の掛け合わせです。 manにはそれぞれのオプションがどういう意味になるかが書いてあります。

ほとんどの環境であればmanはlessと同じ形式で開きます。 lessでは / と打ち込むとページの最下部左に / と表示されるはずです。 これに続けて /-l と打ち込むと、-l にマッチする箇所がハイライトされたり、ジャンプできます。 ここで -l オプションにたどりつけなくても問題はありません。 検索がハイライトされた状態で、 n を押せば次のワード(nextの頭文字です)の箇所にジャンプできます。

何度か n を繰り返せば -l オプションの説明にたどり着けるはずです。 -t -r についても同じ要領で検索してみましょう。

 -l      (The lowercase letter ``ell''.)  List in long format.  (See below.)  A total sum for all the file sizes is output on a line before the long listing.
-t      Sort by time modified (most recently modified first) before sorting the operands by lexicographical order.
-r      Reverse the order of the sort to get reverse lexicographical order or the oldest entries first (or largest files last, if combined with sort by size

それぞれ、このような説明が見つかりました。これで理解できますね!

英語で何言ってるかわからない!!

はい、理解できませんでしたか。 仕方ありません。コンピュータのマニュアルは独特の単語があったりするので、この単語は少し難しいかもしれませんね。

でも、問題ありません。 Google翻訳やDeepLで翻訳してみるのでもいいですし、これだけわかれば検索するためん情報が圧倒的に増えました。 ls -ltr よりもGoogle検索が味方になってくれるはずです。

ls List in long format Sort by time Reverse the order くらいで、検索しても構いませんし、 ls 長いフォーマット 時間でソート 逆順 で検索しても構いません。これなら最悪teratailで聴いても教えてくれそうですね。

公式ドキュメントを読め、マニュアルを読めといわれてもなかなかできません。

公式ドキュメントやマニュアルを読むことが大事ということは、散々言われていますし、そこに書いていることは、おそらくみんな知っています。

しかし公式ドキュメントが読めないという壁にぶち当たっている人は多いようです。

公式ドキュメントが読めないのは使い方を知らないからではないだろうか?というのが私の仮説ですので、記事にしてみました。 次はRailsのドキュメントの読み方なんかを書いてみようかなぁなんて思います。

ModelのValidationのRSpecの書き方について

railsでテストコードを少なくする技術 - TDD on railsの間合い - Qiita

以前、上記のような記事を書きました。

「Model SpecやRequest Spec/Feature Spec(今ならSystem Spec)を中心に書いて、実装速度を上げていこう」という話でした。

その後、Ruby on Railsのコードを読み書きする中で、自分自信の考えが少し変化しました。ここで一度新しい僕のRuby on Railsでのテストとの向き合い方をまとめたくなりました。

いろいろと変化している部分があり長くなるので、今回はModel SpecのValidationの書き方を以前のコードと比べつつ見ていきましょう。

以前の記事に書いてあるModel Specのコード

前述の記事のvalidationのテスト という項目のコードです。(一部改変しています)

describe Post, type: :model do
  describe &#39;#validate&#39; do
    subject { Post.new params }
    context &#39;全てのデータが正しいとき&#39; do
      let(:params) { body: &quot;iiyon&quot; }
      it { is_expected.to be_valid }
    end
    context &#39;正しくない場合&#39; do
      let(:params) { body: &quot;dame&quot; }
      it { is_expected.to be_valid }
    end
  end
end

validateのテストは下記のように describe “#validate” の中に書くようにしています。 letにmodelの引数に渡したいものを定義して、contextの中で遅延的にletしなおします。 いつもこのパターンでテストを書いて、paramsのパターンを微妙に変更するようにしています。

この考え方は基本的には変わりません。タイトルがテストを少なくすると言っていますが、これだと結構テストコードが増えそうですね。Modelはしっかりテストしましょうという考え方なのだということもわかります。

今の考え方が投影されたModel Specのコード

上記のコードを今ならどのように書くのかは以下です。

describe Post, type: :model do
  describe &#39;#valid?&#39; do
    subject { Post.new(params) }
    let(:params) { { body: body } }
    
    context &#39;when body is ok&#39; do
      let(:body) { &quot;iiyon&quot; }
      
      it { is_expected.to be_valid }
    end
    
    context &#39;when body is not ok&#39; do
      let(:body) { &quot;dame&quot; }
      
      it do
        expect(subject).to be_valid
        expect(subject.errors.full_messages).to eq [&#39;Body is shold be iiyon&#39;]
      end
    end
  end
end

ほとんど以前の記事と考え方は変わってはいないのですが、変わった部分に関して解説を行っていきます。

describe に対応する subject と context に対応する let

describe '#メソッド名' の直後に subject を持ってくるのは昔から読みやすくて好きなので、変わらずですね。better specなどでも紹介されている方法です。

subject { Post.new(params) } として params を一括で let に切り出しています。ここは多少の拘りがあって、差分だけを context 内の let に持っていきたいという気持ちの表明です。 仕様変更で追加の attribute が必要になったときに、読みやすくなることを期待しています。

エラーメッセージのテスト

続いて、大きく変わった部分はvalidationがエラーになるときに、必ずmessageエラーをテストするようになりました。

これがテストできていないと、view側でエラーになったときに予期せぬ表示になってしまいます。また、i18nなどを使っているとテストができる部分がなくなってしまうので、これを書くようにしています。このテストを書くようになってから、組み込みvalidationだからといって省略することは少なくなってきました。

そもそも、Validationのテストは shoulda matcher などに任せてしまう人も多いと思います。私は shoulda matcher が使えるテストなら、Railsが用意してくれているValidation用メソッドについてはテストを省略することが多かったです。 しかし最近ではRailsが用意してくれているValidation用メソッドであったとしても、テストを書くことが増えてきました。それは前述のエラーメッセージをテストしたいという理由です。

まとめ

以前の主張と比べて、少し保守的なコードを書くようになったように感じました。 しかし、以前の記事も「テストコードを少なくしたい」という欲は見えつつも、「十分にModelはテストするように」というように読めました。

大きく変わったのはデフォルトのValidationも好んで書くようになったことでしょう。エラーメッセージをテストする効果を体感することで、しっかりと書くようになりました。

入力値のvalidationはパラメータが増えれば増えるほど、掛け合わせの数も増えますし、特にRailsのValidationは ifオプション や with_options などがでてくると一気にどんどん肥大化していきます。 肥大化させないテクニックやValidationに頼らないようにするテクニックももちろんありますが、またValidatorクラスにロジックを移譲したり、Serviceクラスにロジックを移したりする際にもテストは非常に有用になってきます。

少し保守的な主張になったのは開発を進めていく中で、バグや設計ミスなど痛い目にあった部分が、テストにフィードバックされて、テストの書き方が変わったという意味で私の成長なのかもしれません。

想定突っ込み集

以下は今回の主張したい内容と少しずれるので、まとめより下においておきます。

described_class は利用しないのですか?

described_class は利用する時もありますし、利用しない時もあります。 チームのメンバーがRSpecの特有の記述方法を使うと学習コストが高くなってしまう場合は使用しません。利用する時の気持ちとしてはクラス名に自信がないときです。レビューのタイミングや実装の後半になってテストの中まで影響が及ぶのは避けるためです。

FactoryBot は利用しないのですか?

ここで大体の実装案としては let(:params) { attributes_for(:post) } という方式でしょうか。これについては使うこともあります。しかし、FactoryBotのデフォルト値に関しては変化したときにテストが落ちることを優先したいため、あえてパラメータを自分で指定してテストする形にしています。 また subject { build(:post) } とする方法もありますが、こちらについてもValidationをテストする時に限ってはオブジェクトを自分で作ってテストをする形を採用することが多いです。

context は英語で書くようになったのですか?

英語で書くことが増えましたし、rubocop-rspec に指摘されるので、合わせてしまっています。日本語よりも目的語が見やすい気がしています。

describeが #valid? なのに subject { Post.new } なのが気持ち悪いです

わかりますが、 be_valid を使いたくて、このようにしています。 be_valid の方がテストが落ちたときの情報が多くて好きです。

突っ込み集まとめ

この辺りは好みの問題ですので、チームメンバーの意向と私の考えるメリットデメリットをすり合わせながら進めています。

DHHが選んだ『最も参考になった技術書 5選』と、その道標

Ruby on Railsの作者であるDHHは、2012年に投稿されたブログポストの中では5つの技術書を紹介しています。タイトルは『The five programming books that meant most to me』。

日本語でいうと「私がもっとも参考になった技術書 5選」といったところでしょうか? どのような本を選んだのかと、その本に関するエピソードや読み方?のようなものを書いていきます。

5つの本は以下になります。名著と呼ばれるものが並んでいますね。

ちなみにどの順番に読むべき?というtwitterの質問にも答えています。

『Smalltalkベストプラクティス』 『リファクタリング』 『ライトついてますか』 『PoEAA』『DDD』 の順番のようです。

ちなみに私は 『DDD』『リファクタリング』『PoEAA』『ライトついてますか』『Smalltalkベストプラクティス』の順番で読みました。最初にDDDに手を出したのは今思っても難解だったなと思います。若手がDDDを好んで読む傾向にあるようですが、それより先に読むべき本があるのになぁといつも思ってしまいます 笑

それではDHHの読むべきおすすめ順に筆者の感想や書評も交えつつ見ていきましょう。 ※ 引用部分の()内の翻訳は筆者が機械翻訳を参考にしながら翻訳したものです。

Smalltalkベストプラクティス

オブジェクト指向の考え方にプラスして、Smalltalkで使うイディオムなどエレガントな書き方などが解説されています。解決したい問題に対して、こういう書き方をする良いという引き出し増やせる本ですね。特にSmalltalkやRubyのような表現力が豊かな言語にはこのようなタイプは打ってつけな気がします。

デザインパターンやオブジェクト指向の原則を重視したタイプ本よりも、このような現実問題に対する答えを導いてくれる本の方が私も好きです。これの他の言語版があれば読みたいなぁ。 とはいうものの、どんな言語を使っている方にもおすすめできる一冊であることは間違いありません。

DHHもこのように評価しています。

Incredibly practical advice for what constitutes good OO code. It’s done in Smalltalk, but the principles are mostly universal. Probably my favorite nuts’n’bolts of programming design book. Very granular.

(何が良いオブジェクト指向のコードを構成するかについて、信じられないほど実用的なアドバイスです。Smalltalk で書かれていますが、原則はほとんど普遍的です。プログラミングデザインの本の中では、おそらく一番好きな本です。非常に細かい。)

The five programming books that meant most to me – Signal v. Noise

リファクタリング

The fundamental before/after book.[...] The trick to reading this book is to carefully read through every single refactoring pattern and then try to apply it on your code base (you don’t have to commit if it doesn’t fix things). You can’t just blow through it or you won’t really learn it.

(基本的なビフォーアフターの本です。(中略)この本を読むコツは、リファクタリングのパターンをひとつひとつ丁寧に読み通し、自分のコードベースに適用してみることです(修正できない場合はコミットする必要はありません)。この本を読んでも、ただ読み通すだけでは、本当の意味での学習にはなりません。)

The five programming books that meant most to me – Signal v. Noise

私自身はこの本にかなり思い入れがありまして、時折読み直したくなります。 リファクタリング自体はこの本を読む前からやっていました。でも、この本と出会って優秀な先輩にペアプロしてもらっているような感覚があったのです。僕は虜になってこの本にある内容をじっくりと学習しました。また所属していたチームのメンバーでもRubyエディションの輪読会をやりました。議論があることでさらに理解が深まりました。これも読書会がおすすめの本です。

私はリファクタリングをした際のコミットメッセージにリファクタリングカタログの名前を利用することが多くあります。Extract XXX methods to YYY Class といった感じですね。(Rubyの場合はmethod)

この本を読もうとしたとき、現在では3つの選択肢があります。 第一版はJava、第二版はJavaScript、そして前述のRubyエディションはRubyで学ぶことができます。おすすめは第二版のJavaScriptですが、得意な言語で学べるのはとても良いことだと思います。

↑第二版JavaScript

↑第一版Java

↑Rubyエディション、プレミアがついて高いです。 復刊運動も展開されているので、無理して買う必要はないと思います。

ライト、ついてますか

プログラミングを仕事でやる上では、問題解決をするのではなく、問題発見をすることはとても大事です。DHHも以下のように評価しています。

Nothing has increased my programming productivity more than being able to restate hard problems as simple ones.

(難しい問題をシンプルな問題として復元できることほど、私のプログラミングの生産性を向上させてくれるものはありません。)

The five programming books that meant most to me – Signal v. Noise

ときに型破りな手法を盛り込んででも、支持を得たRailsの作者らしい言葉ですね。

この本の共著者のワンバーグやトムデマルコ本は今でもとても人気があります。私も今彼らの本を一つ一つ読んでいっている段階です。 wikipediaにもよいまとめがのっています。

PoEAAについて

DHHはPoEAA本を以下のように評価しています。

Great inventory of many of the patterns that underpin Rails itself, as well as descriptions of many of the “new” approaches that people advocate today (like transaction scripts and service layers). You won’t necessarily implement most of these patterns yourself, but it’s an invaluable resource to understanding the differences in architectures and why framework work the way they do

(Railsを支える多くのパターンと、人々が提唱している「新しい」アプローチの多く(トランザクションスクリプトやサービスレイヤーなど)について書かれています。必ずしもこれらのパターンの多くを自分で実装する必要はありませんが、アーキテクチャの違いやフレームワークがなぜそのように機能するのかを理解するための貴重なリソースとなっています。)

The five programming books that meant most to me – Signal v. Noise

『Rails自体を支える多くのパターン』を例に上げるとたくさんありますよね。ActiveRecordパターンをはじめ、フレームワークの足回りに必要なものがたくさんRailsに詰め込まれています。詳しくみていくのは別の機会に譲りたいです。

少し補足すると、この本は伝説の読書会が開かれていた本でもあります。 なぜ、伝説かというと参加者が錚々たる面子です。検索すれば当時参加されてた猛者の記事がたくさんでてきます。

アジャイルサムライの訳者でも角谷さん曰く、

高橋さんはもちろん、ひがやすをさんも来てくれてました。あとはt-wadaさん(和田卓人氏)とかogijunさん(荻野淳也氏)とか。伊藤直也さんも1回だけだけど来たことがあります。そういえばsecondlifeさん(舘野祐一氏)と初めて会ったのもこの読書会

よしおか×角谷対談「勉強会に眠る宝物」 - @IT自分戦略研究所

メガベンチャーのCTO経験者やOSSで成果を出されてる方がずらり。検索すると、ここに名前がないメンバーでも凄い方が参加されて、ブログを書いていたのがわかります。このころのブログ文化はほんとうに今のtwitterで一瞬で消費されてしまう文化とはちょっと違いがありますよね。

日本語で読む場合は翻訳が現在我々がよく使っている用語と少し違ったりします。 私は原著で読む挑戦をしたのですが、英語の穴を埋めるために、2016年あたりに読書会をクックパッド社やTMIX社で開いてくれていたころに参加しました。

1人で読むのがしんどい方はコミュニティの力を利用できるのも、現代のテクニックかもしれませんね。

洋書はこちら。

DDDについて

DHHはDDD本を以下のように評価しています。

It’s a slug to work through, but the ideas are worth it. It’s a great primer on how to turn a problem space into a beautiful OO domain model.

(読むのは大変だけど、アイデアに価値がある。問題空間をどのようにして、綺麗なオブジェクト指向的なドメインモデルに落とし込むことについての素晴らしい入門書。)

The five programming books that meant most to me – Signal v. Noise

これだけではRailsとDDDの関係を解き明かすことはできません。 まずはDDDでよく議論になる部分を整理するところから先にはじめ、またの機会に詳しくみていきましょう。

また読むのはわりと難しいです。私はこの本を読んで、長い間意味を理解できずにいました。 こちらもDDDコミュニティの力を使って読むのもよいかもしれません。自分の会社の有志で読書会もいいかもしれませんね。

まとめ

DHHが参考になった技術書を自分でも読みつつ、その技術書の評価と合わせて紹介しました。この記事を土台に、Railsと技術書の関係に迫る次の議論を別の記事で展開できればと思います。

補足

ちなみにDHHの記事日本語訳を書いてくれた方がいたと思ったのですが、もしご存知の方がいらっしゃったら @koheisg にリプライくださるとうれしいです。

system specとそのrandom落ち (flaky test) との戦い

randomにテストが落ちてしまう

どんな種類のテストでもrandomにテストは落ちてしまうことがあります。 Ruby on Railsを利用している場合にもっともこのような不安定なテスト (flaky test) になりがちなのは、Capybaraを利用したsystem test/system specではないでしょうか。 私がrandomに落ちるテストと戦った中で得た経験をここに記しておきます。

基本的に自前で sleep はしなくて良い

ページ遷移の直後や描画された直後にclick_linkやclick_buttonなどを実行すると、ブラウザの描画よりもブラウザを操作するテストの実行が早く走ってしまいrandom落ちを引き起こします。 そういうときの解決策として sleep 0.5 などとして、テストの実行を止めるアイデアを思いつくでしょう。

しかし、capybaraは Capbypara.default_max_timeout までは、対象のコンテンツを探してくれるメソッドが用意されています。 ですので、基本的に自前でsleepする必要はありません。

例をいくつか挙げておきます。

click_link &#39;次へ&#39; # ここでrandom落ちしたら
within &#39;.some_dom&#39; do # 次への親要素を探すまで待たせる
  click_link &#39;次へ&#39;
end
find(&#39;.next&#39;).click # 次へのリンクを探してからクリックする
expect(page).to have_content &#39;some content&#39; # 画面遷移の直後の場合は expect も有効です
click_link &#39;次へ&#39;

within / find で超えられない壁

find(&#39;.some_dom&#39;).click # .next_domが表示される
find(&#39;.next_dom&#39;).click

このようにある操作をしてから、表示するコンテンツを操作する場合、capybaraの操作ブラウザの表示より早く、.next_dom が表示する前に .next_dom をfindして見つからずにエラーになることがあります。

find(&#39;.some_dom&#39;).click
Timeout.timeout(Capybara.default_max_wait_time) do
  loop until find(&#39;.next_dom&#39;, visible: false).visible?
end
find(&#39;.next_dom&#39;).click

上記のようにすることで、 .next_dom が必ずある状態を担保してからクリックすることができます。 ここで安易にsleepしてしまうと、時間がもったいないのでCPUのスピードでloopさせるというのがポイントです。

ただ Capybara.default_max_wait_time が長い時間設定されていると、本当に落ちるべきテストが落ちるまでの時間が長くなります。 --fail-fast なども活用しながら、できる限り短い時間を設定したほうがCIのスピードには寄与するでしょう。

楽観的UIの壁

楽観的UIとはクリックした操作のサーバー側の成否に関わらずユーザーにUI操作を続けさせるというものです。

  • 投稿ボタンをクリック
  • 非同期でサーバーにリクエスト
  • サーバーからのレスポンスを待たずに、投稿した内容を表示

というようなものです。

普通のUI操作のテストでは、サーバーサイドの変化については問題になりません。 しかし、サーバーサイドで発番されたデータなどを確認しないと、次のテストに移れいないようなテストもあります。 (本来テストとして別のシナリオにわけるべきですが、生成されるデータ複雑な場合などはfixtureを用意するコストが高い場合もあります)

click_button &#39;投稿&#39;
expect(page).to have_content &#39;thank you.&#39;&#39; # とりあえず投稿ボタンが押されたら表示される、成功したら裏でメールが送られる
visit post_path(Post.find(token: &#39;now_token&#39;)) # メールに乗っているリンクを押すには投稿の裏で生成されたpostが必要

そのような場合は wait_for_ajax のようなメソッドを作りましょうというのが慣例となっています。自分はjqueryが必要なこのギミックがあまり好きではないのですが、楽観的UIとサーバーサイドのデータを合わせ技で確認しないとできないテストでは仕方なく使いました。

click_button &#39;投稿&#39;
expect(page).to have_content &#39;thank you.&#39;&#39; # とりあえず投稿ボタンが押されたら表示される、成功したら裏でメールが送られる
wait_for_ajax # ajaxリクエストが終わるまで待つ
visit post_path(Post.find(token: &#39;now_token&#39;)) # メールに乗っているリンクを押すには投稿の裏で生成されたpostが必要
def wait_for_ajax
  Timeout.timeout(Capybara.default_max_wait_time) do
    loop until page.evaluate_script(&#39;jQuery.active&#39;).zero?
  end  
end

そもそも動いているDOMは表示されていてもクリックできないという壁

後述する参考文献をあたって欲しいのですが、そもそも動いているDOMはクリックできません。そこであまりにも動きが多いページのテストは以下を設定することで、解決するかもしれません。

Capybara.disable_animation = true

それでもクリックできない (sleep の方がましかも)

それでもclickに失敗することがあったので、こういうギミックに改良したりしました。。。画面先するまで押したる!ということです。

wait_for_path_change(&#39;next_path&#39;) { click &#39;次へ&#39; }
find(&#39;.next_path_dom&#39;).click
def wait_for_path_change(path, wait_time = Capybara.default_max_wait_time)
Timeout.timeout(wait_time) do
  yeild if block_given?
  loop until page.current_path == path
rescue TimeoutError =&gt; e
  pp e
  if block_given?
    yield 
  else
    raise e
  end
end

だいぶバッドノウハウになってきました。 素直に sleep 0.5 とした方が全体的なメンテのしやすさは秒数でできるので便利かもしれません。。。

まとめ

他にもランダム落ち。特にsystem specやjsを有効にしたfeature specでは苦しめられることが多いと思います。このように知見がたくさんでてくると嬉しいので、自分からシェアしてみることにしました。

補足(というかメモ)

ランダム落ちとの戦いのときは、、以下のコマンドを多用しました。

$ RSPEC_RETRY_RETRY_COUNT=0 rspec --fail-fast --order=defined

参考文献

Ruby on Railsでバッチ書く時どうするか問題

別に問題じゃなさそうなことに問題って名前をつけたのは公式で用意してくれているバッチインターフェースが二つあって、いつも迷っちゃうからだ。

$ rails foo:bar:baz

のようにコマンドを作れるのがrake taskです。 これは普通にrails db:migrateやrails g scaffold Fooのようにいろいろなところで開発者が使うからおなじみのコマンドです。

もう一つのインターフェースが、rails runnerと呼ばれるやつで、こちらは引数に自由にruby(しかもrailsの資産をつかった)のコードを書くことができる。

普通にバッチを書くならどっちでも問題ない

基本的にどっちを使っても問題はありません。しかしrails runnerを作るときはインターフェースを自分で考える必要があります。以前言及した記事としては app/batches 配下にバッチフレームワークのようなものを作り、 rails runner FooBatch.run のように書くものでした。

自前のバッチフレームワークのようなものが必要なのはひょっとしたら過去の時代の話かもしれません。例えばkuroko2やjenkins、rundeckのようなcron replacementと呼ばれるツール群を使えば、共通処理で書いていた排他制御やロギングなどをそちらに任せることができます。そしてkuroko2やjenkinsの先ではrailsの入ったdockerを実行させるようなことも簡単にできます。 また、dockerの話を続けるとk8sのcronojobを使えばGKEやAKSのサポートの上で、kuroko2で得ていた問題を吸収することができます。

rails runner と rake task のどちらを使おうとも、結局バッチを実行するツールが実行するインターフェースはdocker runのようなものだったりするわけです。

そもそもバッチっていつ書く?というもう一つの問題

そもそもrailsをつかっているということは、おそらくはWebサービスのバッチを動かすということだと思います。 基本的にバッチ処理にしなくてもバックグラウンドジョブを利用するようにした方が、エンドユーザーにとっては処理完了のタイムラグも短くsidekiqやrescueのようなワーカーを使えばリトライも自動的に行ってくれるというメリットがあります。

それでもバッチ処理はある時点で行う集計を伴う処理には必要なものであると言えます。

思考停止でバッチにやらせない判断をする

僕は新規のサービスに携わることが多いですが、ほとんどバッチを使う機会がなくなってきている印象にあります。集計は基本的にredashのようなツールを用いるため、railsが関与することは減らすことができています。

一方ジョブキューの処理はちょっとしたデータの更新や重い処理を行うのにも非常によく使うようになってきています。 例えばトランザクションに影響されないAPIコールなども可能な限りバックグラウンドジョブで行うようにしてretryの判断をジョブキューで行わせるようにしています。

これは月次や日次のバッチに書き直そうとなるときもあるのですが、一旦ジョブキューで行わせるように検討してから、時間がかかりすぎるからバッチにしましょうと後で移行することも増えてきました。

そこで浮上する第三のバッチインターフェース

これはバッチように作られたインターフェースではないのですが、activejobでバッチ処理をキックする運用をやって意外とうまくいくじゃんという成功体験がありましたのでシェアします。

namecpace :es do
  task index_rebuild: enviroment do
    ElasticSearch::IndexRebuildJob.perform_now
  end
end
class Elasticsearch::IndexRebuildJob &lt; BatchJob
  def perform(foo)
  end
end

こんな感じでindex rebuildを最初は管理画面から実行して行っていたのですが、時間がかかるようになりワーカーサーバーとは別のコンテナで実行したいという要望がでてきました。 そこでrake taskから同期的にActiveJobを呼び出すという荒技をやってしまうと意外とバッチインターフェースとしてしっくりきました。

上記では BatchJob を継承していますが、rake taskでは難しかった処理の共通化をフックメソッド before_perform などを使って制御することも可能になります。

まとめ

ここ最近バッチ処理どうしようかなぁという人をちょいちょい見かけたので、だらだらと書いてみました。

hubコマンドを窓から捨てて、ghへ移行した話

GitHub が新たに開発した GitHub用のCLIツールがめっさ便利なので、勢いあまって記事を書いたのですが、塩漬けにしていたので、とりあえず公開。 もう速報性はなくなってしまったけれど、便利に使っています。便利。

cli/cli: GitHub’s official command line tool これね。

hubコマンドクッソ便利(でした)

$ git push origin feature-bransh

したあとは、そのまま

$ hub pull-request -o

とするのが手癖として根付いています。

hubコマンドに対する不満

手癖になってはいるのけれど、解決できていない問題がありました。 それはPull Requestをdraftで生成できないことです。

ですので、DraftのPull Requestを作りたい場合は $ hub browse を使ってブランチを表示。その後、ブラウザ上でPull Requestを作成していました。

$ gh pr create -w という革命

$ gh pr create -w

これを使えば今までやりたかったPull Requestの作成が簡単になるだけではなく、全てをdraftで作ってから細かい点をブラウザ上で修正するというワークフローがやりやすくなりました。

見た目を伴う修正の場合は、スクリーンショットをPull Requestのdescriptionの項目に貼ったりしますので、この辺りも便利です。

$ gh pr create -df を使えば完全に作業途中のpull requestを一時保存するのにも使えます。

gh コマンド便利

hubコマンドは手癖になってしまっているので、とりあえず今から $ brew uninstall hub を実行します!!!

コダテルというコワーキングスペースでリモートワークをしてきました

オンラインコミュニティnoraneeresのメンバーと一緒に、愛媛県八幡浜市に行ってリモートワークをしてきました。

リモートワークで場所を変えるというテクニック

リモートワークについて書かれた『強いチームはオフィスを捨てる』(原題:REMOTE)の本の中で、いくつかリモートワークの落とし穴にはまらないようにするアイデアが書かれています。その中の一つを紹介します。

全く問題ない人もいるけれど、人によっては、ひとりきりだと仕事に集中できなくなることがある。そういう人のためにシンプルな解決策を教えよう。 ノートパソコンを持って、Wi-Fiのあるカフェに行けばいいのだ。

私は、シェアオフィスを借りて作業をしているのですが、「何か集中できないなぁ」というときには、家に帰ったりカフェに行ったりします。 シェアオフィスで集中できなったのに、カフェだと集中できたり、家だと集中できたりするので、不思議なものです。

その延長線で、愛媛まで行ってみた

さて、今回はその延長線で愛媛まで行ってみました。 (まぁ集中力に悩みを抱えていたわけではないのですが、いい機会だったので)

コダテル

コダテル さんはなんと宿泊機能がついたコワーキングスペースです。 東京から飛行機と車でちょっと足を伸ばせば、そこで作業ができて、お昼に東京より新鮮な魚が食べれて、夜に温泉が入れて、めっちゃ美味しい居酒屋で飲めます。

コワーキングスペースといっても、東京のIT企業系の人とかがバシバシ働いているような感じではなくて、ふらーっと地元の高校生がやってきたりする緩さが良かったです。

↑ は僕がいた時ではないけれど、コダテルの浜田さんのツイート。なるほどカオスとも呼べるか(笑)

あと、コダテルの会員さんの人たちに地元の魅力を語っていただく会もしてもらい、地元を盛り上げていく人たちの熱さを感じました。

愛媛での集中力について

コダテルさんが快適だったので、めっちゃ普通に仕事はできました。 オンラインMTGもビデオ通話していたのですが、wifiも問題なくつながりました。 コダテルさんめっちゃ働きやすかったです。

じゃぁ、成果がめっちゃ上がったか?というと、ぶっちゃけそうではなかったです。 この写真のとき障害発生してて、あたふたしてましたし。。。

東京に帰ってきてからの集中力が上がったきがする

ただ、愛媛から帰ってきてから、仕事への集中力が上がった気がします。 やはり旅行のようなものを体験すると、何かにスイッチが入るんでしょうね。 (本当に佐田岬の景色は最高でした)

毎日は難しいかもしれませんが、1年に一度くらいは遠く離れた場所でリモートワークをするのは効果的だなぁという感想を得ました。

多拠点生活をする人たちはこういう感覚を求めているんでしょうね!わかった気がする。

開発合宿とかも、合宿中じゃなくて帰ってきてからに効果があるのかも。

泊まれるコワーキングええやん!

コダテルさんのように泊まれるコワーキングスペースは次回やるときも選択肢に入りそうですね!

合わせて読みたい

エンジニア4人で徒党を組んでフリーランス社員旅行 in 愛媛・八幡浜をしてきた話。 フリーランスエンジニアだって、開発合宿とか社員旅行とかいきたい #愛媛編 フリーランス合同社員旅行vol1 in愛媛を開催した話

一緒に行った人たちの記事。完全に旅行って言ってて、仕事してなくて草。リモートワークしに行ったのは僕だけだったw

泊まれるコワーキングスペースに東京からエンジニアのみなさんが遊びに来てくれた! コダテルの浜田さんの記事。とてもいい人でした!いい人オーラが滲み出てるタイプ!

エージェント完全脱出マニュアルというタイトルでLTしてきました(しがないラジオmeetup 4)

はい。 #しがないラジオmeetup 4 - connpass に参加してまいりました。 (そういえばpodcastの話はあんまりしなかったな〜)

しがないラジオmeetupとは

『しがないラジオ』というpodcastを一回でも聞いたことがある人が参加できるmeetupです。podcast好き率高めですが、エンジニアとかそういう縛りは特にありません。 今回は公募枠LT5枠とスポンサーLT1枠、パーソナリティのお二人のLT2枠と、懇親会という内容でした。

エージェント完全脱出マニュアルというタイトルでLTしてきました

見事、公募枠のLTに当選し登壇してきました。 最近、登壇とかやってなかったし、LTにしては10分と割と枠があったので、緊張感もあり楽しめました。

なんだか、見境のなくあやかりまくったスライドが気がついたらできてました。ごめんなさいmm

10分のLTにスライドは40枚。 緊張と早口で大阪弁全開でまくしたて立ったぜ。

なんでこのテーマか???

よくどうやって仕事を受注してるんですか?ということを聞かれるので、自分でもよくわからんなぁと思い話してきました。

twadaさんとかkakutaniさんとかa_matsudaさんとかmizchさんとか、業界の中でプレゼンスを持っている方には足元に及ばない僕が、どうやってお仕事を受注してるかという話で。

エージェントでフリーランスになる話はごまんと存在する

それもそのはず、エージェントが大量にアフィリエイトをやってますから。。 また、最近こういう書籍も出版されて、なかなか的を射ているので、私がとやかくいう必要はないでしょう。 エージェントで仕事をするための、まとまった話は以下の本に書いてあります。


エンジニアがフリーランスで年収1000万円になるための稼ぎ方

それより先の話をしているのはこの本です。


ITエンジニアが独立して成功する本~年収2000万円を稼ぐ! 単行本 – 2005/1/21

この本はちょっと。ファーストステップにはちょっと歩幅が長い本かもしれないとおもいました。

しがないmeetupで話すべき内容だったか謎 (笑

というわけで、普通のエンジニアがエージェントを経由せずに仕事を受けるにはどうしたいいか?という内容が必要なのじゃないか?と考えたのですが。。。

なぜかフリーランスエンジニア向けの内容を考えていないんだけど、よく考えたらSIer脱出とは似ているけど、関係ない話だった。

なんで、この話をしようと思ったんだっけ?と考えいたのですが、、、

多分VOYAGE GROUPでこの話をすることが自分の中での何かの記号になったんだと思う

僕にとってはエージェント経由で常駐していたVOYAGE GROUP(以下VG)で、自分で仕事を取れるようになり、この話をすることに意味があったので、直感でこの話にしてしまったのでしょう。

今の僕にとっては、VG時代の繋がりは大事で、今もお仕事で付き合いがあったりする。VGの人は優秀なので、転職先や独立先で自分に仕事のお誘いをいつもくれる本当にありがたいことだ。

VGも新陳代謝で人が入れ替わっていくけれど、ajitoには変わらないメンバー(退職済み含む(爆))がいる。 今日はajitofmの舞台ということもあって、しがないリスナーにも興味のある方々がいたので、ajitoをみたいと言っていた人々と一緒に見学してきました。

綺麗になったVOYAGE GROUP楽しそうでした。

さらば!fat controller - scaffoldで生成されたようなコントローラーを意識しよう!

流しのRails業でチームの中で共有したtipsをちょっとずつブログにも書いていくぞという。気持ち。 ちょっと初心者向けの話題のように思うかもしれないけれど、私もなんども苦しんだことなので。

$ rails g scaffold Book name:string price:integer

scaffoldでこのように生成したとしよう。 そうすると、BooksController#create は以下のように生成される。

# POST /books
# POST /books.json
def create
  @book = Book.new(book_params)

  respond_to do |format|
    if @book.save
      format.html { redirect_to @book, notice: &#39;Book was successfully created.&#39; }
      format.json { render :show, status: :created, location: @book }
    else
      format.html { render :new }
      format.json { render json: @book.errors, status: :unprocessable_entity }
    end
  end
end

もう少し簡易化してみましょう。

# POST /books
def create
  @book = Book.new(book_params)

   if @book.save
     redirect_to @book, notice: &#39;Book was successfully created.&#39;
   else
    render :new
  end
end

respond_toを排除し、HTMLしか返さないようにしてみました。 何の変哲も無いcreateアクションに見えるでしょうが、これがrailsのcreateの基本形です。全てのPOSTをこの形で書けるようにすべきです。

例えば、Serviceクラスを使う時はこうなっていると綺麗です。

def create
  if BookRegisterService.call(book_params)
    redirect_to :show, notice: &#39;Book was successfully created.&#39;
  else
    render :new
  end
end

save modelのインターフェースを委譲されたmodelでデコレーターパターンを用いて実装すると、もっと元の形に近いままです。

def create
  @book = Manga.new(Book.new(book_params))
  if @book.save
    redirect_to @book, notice: &#39;Book was successfully created.&#39;
  else
    render :new
  end
end

MangaはBookクラスから委譲されたインターフェースを持っています。

class Manga
  delegate_missing_to :@book
  def initialize(book)
    @book = book
  end
  def save
    # Manga固有のロジックをここに書く
    @book.save
  end
end

Formオブジェクトも似たような形にできます。

def create
  @book = BookForm.new(book_params)
  if @book.save
    redirect_to @book, notice: &#39;Book was successfully created.&#39;
  else
    render :new
  end
end
class BookForm
  include ActiveModel::Model
  attr_accessor :name, :price
  def save
    if valid?
      # フォームが正しかった時の処理
      true
    else
      false
    end
  end
end

とりあえず、今日はここまでにしておきます。

DHHの記事のメモ

プロジェクト管理ツールBasecampの最高技術責任者、デイヴィッド・ハンソンさんの仕事術 | ライフハッカー[日本版]

iA writerを知ったのも、この記事だった。 自分のタスク管理のやり方を見直そうとなんとなく調べていたら、こんな記事を見つけた。 確か、以前にも読んだことがある内容だったんだけれど、iA writerもタスク管理の方法も試せていなかった

DHHという憧れの人物のタスク管理が響かないタイミングもあるんだな。本当に人生はタイミングですね。

記事で印象に残ったこと

私はほとんどのことにNoと言っています。そうすれば、自分で本気で選んだ少数のことにだけに、完全にコミットできます。 余計なことは人生から取り除けば時間はたっぷりあるはず。

明日はいくつかNoと言えるようにしたい。

メールのInboxを空にすることには執着しています。

僕はメールはほとんど見ないけれど、DHHのGTDの基本はメールになっているよう。 また、slackは本当に有害だと思うので、どうにかしたい。 あとはtwitterを読まないということも大事だよなぁ。フォローを減らすなりリストしか見ないなり情報を減らす必要がありそう。

一般的に私がトラッキングするのは、自分のコントロールが及ばないことに関してだけ

私の場合はomnifocusを整理する必要がある。 自分のタスクもかなりトラッキングしてしまっていて、この辺の使い方をマスターする必要がある。小さなチーム大きな仕事ではTodoListは11個までにしようっていってた気がする。 GTD的にいうとnext actionは11個までで良さそうだ。

DHHマニアとして

RailsやBasecampの記事をひたすら漁ってる自分としては、日本語で読める記事が意外なところにあって見落としていた。DHHリンク集を作ろうかな(笑

iA writer に感動しました。

iA writer というソフトを知ってますか??

このソフトはめっちゃいいです。このソフトが刺さる人は下記のランディングページの動画を見ただけで釘付けになって、とっさにダウンロードしてしまうはずです。

iA Writer: The Benchmark of Markdown Writing Apps

何がいいって、書けば書くほど集中できます。 これをweb上で体験させるのはそう簡単ではないよなと諦めの境地に行けるような気分になります。

これに近い書き味のものにDropbox Papperがあります。 ただ、やはりブラウザの限界といったところでしょうか、iA writerがうたっているfocusという部分に多少の不足を感じてしまいます。

iA writerがあれば文章を書くのが楽しくなる

iA writer上に文章を打ち込むのが本当に楽しい。 ずっと長い間文章を書いていたくなる。 個人的にomnifocusに出会った時の感覚に似ています。omnifocusもひたすらにタスクを分割したりタスクを入力したくなるツールです。(ただtodoアプリはそんなにたくさん入力してもいいことは少ないのだけれども)

これだけ文章を入力することが苦でなくなるというのは本当にありがたいです。 本当にいろいろな文章が書けそうです。

僕がフリーランスエンジニアとして感じる壁

転職活動をすることを表明しましたが、 今現在自分が壁と考えていることを書きます。

権限の壁

私の経験上AWSの管理者権限をフリーランスエンジニアとして、任されることは少ないです。 AWSのサービスをフル活用して貢献するためには、 AWSやインフラに精通し、社外だとしてもこの人間に権限を委譲した方が生産性が高いと認定された場合に限ります。

こういった権限はAWSだけではなく様々な重要な意思決定に絡んできます。

組織の壁

フリーランスのエンジニアが組織構造に対して助言することはあっても、 そこに対する意思決定までのプロセスが常に公開されていることは少ないです。 ある程度の規模の会社で経営経験があり、経営者に対してのアドバイスを求められる場合にのみ、 それらが委譲されるでしょう。

お金の壁

フリーランスはお客さんの事業へのお金の決裁権は通常は一切持ちません。 たまに予算を任せてくるような案件もありますが、その予算を承認するプロセスに立ち入ることはできません。 圧倒的な政治力があれば、権限の壁や組織の壁と同じく超えることは可能かもしれません。

壁はフリーランスのままでも超えられる

私は一般的にフリーランスに立ちはだかる壁を超えて来ました。 (リーダーは任せられない、マネジメントは任せられない、インフラは任せられないetc)

この三つの壁は越えられないものではありません。 自らの能力が高ければ、フリーランスのままでも突破することのできる壁です。

ただ、これらの壁を越えるには私の現在の能力では少し難しそうです。

私が壁を越えるために

正社員であれば、様々な制約がかかる代わりにこれらの壁を越えるためのサポートが得られると考えています。 そして、これらの壁を突破すれば、視座が高まり解決できる課題も増えると考えています。

私は一度会社にコミットして、この壁と向き合おうと考えました。 3つの壁を超えて、能力を上げて行きたいです。

意識低いrubocopの運用の仕方

rails 界隈では Sider の普及に伴い rubocop を業務で使っている方も増えてきたのではないでしょうか? しかしながら、一度荒れ果てた荒野にrubocopを放っても成果はほとんど上がらないことでしょう。 必要なのは、すべてのコードを綺麗にするぞ!という高尚な志ではなく、現実を少し改善すれば、それでOKという意識低い気持ちな気がします。

--lint オプション

rubocopには -l または --lint というオプションがあるのをご存知でしょうか? こいつはlintオプションと呼ばれるやつで、bugに繋がりやすい警告レベルを指摘してくれます。

こいつをまずデフォルトにしましょう。 .rubocop ファイルに --lint と記述すると、rubocopのコマンドが常に--lintオプションがついた状態で実行されるようになります。 .rubocop ファイルを使うことで、プロジェクトのメンバー全員がそのオプションをつけてrubocopを実行することができるため、「 rubocop -l と実行してください!」などと呼びかける必要がなく便利です。

rubocop_todo.yml と向き合う

次にこの状態で、rubocop_todo.yml を生成します。 rubocop --auto-gen-config

プロジェクトにこれ以上 --lint に違反するコードを入れないようにするためです。

rubocopを入れると、rubocop対応で色々と対応工数が増えてしまうと恐れている方もいらっしゃると思いますが、 この --lint オプションは宗教戦争的なものはほぼなく、バグに繋がる恐れがあるか?という観点での指摘です。

さて、auto-genされた rubocop_todo.yml には問題が山積です。 これらは指摘事項を修正していかなくてはなりません。

todoファイルと向き合いきれなかった場合

rubocop_todo.yml ではルールをファイルあたりで抑制してしまうため、 todoファイルを全部修正できない場合は、問題の箇所を特定してコメントアウトで警告を抑制する方法をとったほうが良いでしょう。 じゃないと、 rubocop_todo.yml に記載されたファイルは治安が悪化して行きます。

一日1cop修正

私のプロジェクトでは1日に一つだけ、これを実行していくことを行いました。 修正はコミットを細かく分けて、tmpブランチからcherry-pickをしてmasterにマージする量を調整する形をお勧めします。 (OSSである dev.to では一つのpull requestがマージされたら新しいpull requestを作るという方法をとりました。)

rubocop_todo.ymlを消すことができれば、これでとりあえずrubocop -lに適応した状態を作ることができたということです。

--lint 以外のオプションと向きあう

次の段階としてrubocop -lをやめて、rubocop.ymlを設定していくというステップがありますが、これは次回以降に。 まずは、--lintで怒られないくらいを目指すのはいかがでしょうか?

FactoryBot.lintの困るところ。

associationをデフォルトのfactoryではnilを渡す

一般的にFactoryBotは大きなプロジェクトになってくると無駄なデータを作成する可能性が増えてきます。 例えば、こんな時。

factory :tag do
  article
end

it do
  create_list(:tag, 10)
  # 10個タグがある場合のなんらかのテスト
end

articleがtagを複数持てるDB構造になっているとして、 tagが10個以上付いているページのfeature specなどを書きたい場合がある時に、 上記のような書き方をしてしまうと、tagが10個だけできればいいものの、articleも10個できてしまうのです。

これを抑制するために、

factory :tag do
  article { nil }
end

このようにartilceは敢えてnilを渡して、validateエラーが起こるようにしておきます。 そうするとうっかり、 create_list(:tag, 10) なんて書いてもテストが落ちるようになり、、

it do
  create(: article)
  create_list(:tag, 10, article: article)
  # 10個タグがある場合のなんらかのテスト
end

おそらく、このようなテストになってくれるはずです。

あくまでデフォルトの話であって、traitを使う分には特定のcontextの名前を入れることができるので、問題ないと考えています。

factory :tag do
  trait :with_article do
    article
  end
end

↑みたいなのはOK

FactoryBot.lintの困るところ

で、この方針でfactorybotを運用すると困ることがあり、、 FactoryBot.lintは factory_botで作成されたDBテスト用のファイルの治安を守るためのFactoryBotがデフォルトで持っているlint機構です。

factory :tag do

  article { nil }
end

何と、こんなFactoryBot.lintは許されないのです。 validateエラーを敢えて起こしているのに、validateエラーになっちゃう。

ので、 strategy: :build のオプションを使ったlintを実行しています。 しかしながら、buildのlintは意味があるような無いような。。。 そもそも、関連にnilを渡すようにするのって多分気持ち悪いって方が多い気もします。(僕も最近まではそうでした。

皆さんはどのようにFactoryBot.lintを運用されていますか??

2018年夏フロントエンド×Railsの事情

このテーマ。僕はずっとずっと悩んで来た問題です。railsdm周りで話題になってたっぽい。

ベストプラクティスというものはまだ見えない。 でも、いろいろな実績が出て来たし、自分でもいろいろやって見たのでまとめて行きたいと思います。

1. sprokets + turbolinks + webpacker + stimulus

basecamp wayですね。 それぞれハマりどころが多くrailsに精通していないと使いにくいと思います。 DHH信者にオススメの設定です。

気持ちはわかるけど、染まって見るのもなしではないかな。

2. webpacker + react(or other javascript view library) (+ some cssloader || sprokets)

部分的にreactなどのviewを使う設定。場合によってはcssもstylesheet_pack_tagを使うパターン。 個人的にはこのパターンってreact使う必要ある?という気もします。 が、例えばKPIに直結する非常に重要な機能だけをSPAにして、 UXを最大化するのに使える構成ではあると思います。

この場合はsproketsを捨てない方が無難な気もしますが、 reactの中でcssを使いたい場合や、依存ライブラリをいい感じにシュッとしたい場合はwebpackerに頼ってしまうのもいいでしょう。

3. webpack + rails(without sprokets and webpacker)

例えばsproketsを捨てるのようなやつ。 railsでレンダリングするのは完全に捨てないまでも、 webpackerを通じてwebpackをコントロールするのに融通が効かないのは嫌だという場合にオススメな構成。

確かにハッシュダイジェストは捨ててもええっすね。

4. webpack + rails api

railsは完全にapiに成り下がるパターン。 フロントエンドは完全にjavascript wayに集中できる。 しかしながらSPAで全部作るのは大規模案件には骨が折れる作業にはなりそう。 特に管理画面系なんかはまだrailsに一日の長がある印象。

管理画面は別でrailsでサクッとmicroserviceで作ったりrails engineを採用したり工夫すると工数の削減も進むかも。 BFFとしてのrails apiといったところ。

ただ、そもそもBFFをrailsがある必要がどこにあるだろう。 他の言語でもswaggerやgraphqlを利用すればrails並みに工数を削減することもできるだろうしね。

けど、それでもrailsがいいって時はこれが無難ですよね。

まとめ

個人的にはオススメは4。逆に1という手もある。 一般的には2,3が多いけど、2,3が最も辛い。

再現テストの話

テストコードで再現テストをしてから、bugfixするやつ。

不具合にテストを書いて立ち向かう - t-wadaのブログ

これうまく行ったら超気持ちいいけど、いつも気持ちいいとは限らないのでメモ。

バグのパターンがユニットテストとしてエッジすぎ

だいたい再現テストコードがエッジなパターンすぎて、 仕様を説明する助けとして不適切になってしまう。

describe &#39;somemethod&#39; do
  subject { describe_class.new(params).somemethod }
  context &#39;A&#39; do
   let(:params) { &#39;a&#39; }
   it { is_expected.to eq (&#39;A&#39;) }
  end

  context &#39;B&#39; do
   let(:params) { &#39;b&#39; }
   it { is_expected.to eq (&#39;B&#39;) }
  end

  # 再現テストのコンテキストがハイコンテキスト
  context &#39;B and hogehogehoe&#39; do
   let(:params) { &#39;a&#39; }
   before do
     # ハイコンテキストな記述 
   end

   it { is_expected.to eq (&#39;A&#39;) }
  end
end

↑この程度なら全然いいんだけど野生のコードはこんなのじゃすまない。

このままマスターに入れてマージすると、仕様を説明することを阻害するよなぁ的に。

しかし、マージしておかないと同じバグを繰り返すかもしれないので、対策としてそのハイコンテキストなテストを別ファイルに切り出したりしてる。

コンテキストやフィクチャでテストのファイル分ける

1つクラスに1つのテストファイルがデフォルトですが、 テストファイルがって大きくなってきたら、コンテキストやフィクスチャ、メソッド単位でテストファイルを分割しても問題ないわけです。

なので、コンテキストが揃わないケースでは、別ファイルにコンテキストを分けてしまう。

そうすれば、仕様のキャッチアップにはよりプリミティブな浅いコンテキストのテストケースを読めるようにしておく。

そして再現テストは別ファイルで自動テストされるようにしておく。

というわけです。

なんかうまくいかない時に選ぶ他の手段

その他にもこのケースには下記の対応方法があるけど、場合によってはこれらも選んじゃう。

  • 再現テストをマージしない
    • 再現テストに価値がないと判断したときはTDDの道具としてだけ利用させてもらい、自動テストコードとしての役目は与えない。
  • 新しくできたハイコンテキストなテストに粒度を揃えてテストを書き足す
    • ぶっちゃけ時間かかるし、やらないこと多い。
  • 別ファイルに切りださずにハイコンテキストなテストも既存のテストの間に入れる
    • ファイル切り出すコスト高すぎる時とかありますよね。。
    • 先にテストのリファクタが必要
  • ハイコンテキストなテストを一度マージして記録に残しつつ、リファクタリングをしてハイコンテキストなテストを書かなくても良い仕様にした後にリバーとする
    • 毎回これができれば最高。
    • でもできない時がある気がする。時間とかコストの問題じゃなくて、スキルの問題かもしれない。

まとめ

基本的にバグに対して再現テストを書いて立ち向かって見てるけど、、、、 書きあがったテストコードがぐちゃぐちゃしちゃうのが悩み。

ぐちゃぐちゃでもいいから、別ファイルにテストコードを分けてコミットして再現テスト -> 修正すると良さそう。

そのやり方も万能じゃない。

そもそも再現テスト書いて、不具合に立ち向かうのをサボりたくなるときもある。

ブログを独自のCMSに移行しました

ブログ移管した

ブログを jekyll + github pages での運用から、独自のCMS(heroku + rails)に移行しました。

移管した理由

オンラインからサクッと編集したい

記事の雛形は make post みたいなコマンドを書いて、サクッと記事を書き始められるようにしてはいたのだけれども、、、 ちょっとした修正を出先や移動時間にするのにgithubに接続してブラウザから修正することにイライラしており、サクッと編集できるものが欲しかった。

jekyll疲れ

jekyllのプラグインとか拡張とかに限界を感じていた。

GitHub離れ

買収が発表される前から検討していたので、半分冗談ですが、移管完成がこのタイミングになったのはこれもある。 blogはコミットを外に公開したくなかったので、privateリポジトリで運用していましたが、 microsoft買収により自分が課金する必要もないかなと思いました。

このお金はherokuに払っていくぞ!頑張れheroku!

(あといくつかのprivateリポをgitlabかbitbucketに移管すれば、コスト削減も同時に達成できます。ありがとうmicrosoft。)

移管先の検討

wordpress

  • 拡張性は高いものの、拡張しすぎると辛そうなので手を出すのをやめました。
  • また移管したい気持ちになるので、その時は楽なんですけどね。

ブログサービス系 (medium/note/qiita/はてな/livedoor/line)

この辺りのツールはスマホからも修正がかなり簡単で圧倒的に使いやすいのです。 が、当たり前ですが融通が効かない点も多いので、断念しました。

自作

  • 最近メディア関連のお仕事が多く、blogに近いものをサクッと作れるノウハウが溜まってました。
  • あわよくば複数のメディアを同じblogツールを使って運用できるかもという下心が湧いてきちゃいました。
  • esaやkibelaやwikiツールも作りたくて同じような仕組みになりそうだから、とりあえず個人ブログだけ作ってみた。
  • 後述するURLそのまま移管を思いついたらサクッとできた

rails + herokuで自作しました

railsは自分のライスワークでありながら、ライクワークなので、 ブログを書きたくない時も、railsを書いてインプットができるのは良さそうと思いました。 あと、railsはブログみたいなツール作るのに向いてるんですよね。

以下、有益になるかもしれないことです。

markdownで記述は html-pipeline 周りでサクッと対応

html-pipeline というgemを使うとmarkdownをhtmlに変換するのは簡単です。 独自に拡張したい時もfilterをサクッと書くことができて最高です。

https://github.com/jch/html-pipeline

パーマリンクをそのまま移管

railsでブログ記事というとURLが /articles/1 みたいになりそうですが、 パーマリンクを過去の記事のまま移管する方法に rails engineを使用しました。 記事公開するためだけの rails engine を作り完全にroutesを分離し、それによりパーマリンクのためだけの一つのroutesを実現しました。

main appの config/routes.rb に下記を記述します。

  constraints(-&gt; &#39;koheisg.dreamin.cc&#39;.eql?(req.host)) do
    mount SomeEngine::Engine =&gt; &quot;/&quot;
  end

そして、SomeEngineのroutes、つまり some_engine/config/routes.rb に

get &#39;/:permalink&#39;, to: &#39;articles#show&#39;, permalink: /[^\s]+/

と記述しました。

今後について

  • 頑張ってブログを更新する
  • ブログの機能の拡張をする (編集履歴の管理、複数ブログ、複数ユーザー、netlifyなどへのexport対応など)
  • テスト的にブログを使ってくれる人を募集する

という感じで考えてます。

koheisgがどうやってプログラミングを身につけたか? - CGI編 -

前回 に続いてどうやってプログラミング覚えたか?シリーズです。 こうしてHTML/CSSをなんとなく覚えた私ですが、次は動的なサイトを作りたくなっていきます。

geocitiesからxreaの移行

geocitiesではhtml/css/javascriptは満足に動きますが、サイトを訪れた人が掲示板などサーバー上で動作するプログラムを置くことはできませんでした。

当時、ホームページを個人で運営している人は二つのいずれかの方法で、掲示板を運営していました。

  • レンタル掲示板と呼ばれていた類のサービスを使う
  • CGIが動くサーバーで、CGIスクリプトを動かす

前者は会員登録をすれば誰でも簡単に自分のサイト専用の掲示板を持てます。 後者はCGIの知識が多少必要とされますが、CGIスクリプトは配布されているものを使用すれば、動かすだけであれば、プログラミング自体の知識は必要ではありませんでした。

今でいうと、blogを始めるときにライブドアブログやアメブロを使うのか?wordpressやmovabletypeを使うのか?みたいな違いです。 wordpressを使えば様々なデザインや動きもカスタマイズできますが、ライブドアブログやアメブロではそこまでできません。

自分はカスタマイズも想定して、CGIが動くxreaと言うレンタルサーバーに自分のサイトを移管しました。

無料スクリプトをアップする

xreaにサイトを移管してから、配布されてるCGIスクリプトをサーバーで動かしました。 配布されているCGIスクリプトは、それぞれ微妙に設定の仕方が異なっており、動いたり動かなかったり悪戦苦闘をしました。

CGIスクリプトの提供者側で用意してくれている設定に慣れてくると、自分でも動作をカスタマイズしたくなってきました。 wordpressでいうとプラグインの改造くらいの難易度だと思えば良いと思います。

改造がしやすいCGIスクリプト

色々なCGIスクリプトを改造するようになってきたところで、改造することを前提として配布されているCGIスクリプトを見つけました。 HTML部分とperlで書かれたロジック部分が完全に分離しているスクリプトです。

これを使うと当時の自分のようにHTMLしか理解していない人でも掲示板の見た目をカスタムできます。

ブラウザから日記を投稿できるサイトにした

僕はテーブルレイアウトを卒業し、 <div class='diary'>ここに日記の文章を書く</div> みたいな感じで自分のホームページを更新していました。

この頃、はてなダイアリーが流行り初めていて、はてなダイアリーで日記を更新する人たちが増えてきました。その他にも日記専用のサービスみたいなものが乱立していました。

自分の掲示板を改造する力を利用して、自分だけの日記サイトを動的に作ることができるのでは? と思い始めました。

そして公開されているperlスクリプトを改変して、自分でゼロからデザインした日記サイトを作ることに成功しました。 とても長くの時間かかってやりましたが、更新が楽になって最高に嬉しかったのを覚えています。

この頃の自分のスキルレベル

perlの文法はほとんど理解していなかったと記憶しています。 変数の代入やifやforは理解していないと改造できなかったのですが、基本的に感覚で「ここを動かしたらどうなる?」ってのを繰り返していました。 (このレベルから、現在プロのプログラマとして、プログラムを書く力に変換していくにはかなりの時間がかかったように思います。この頃perlの入門書を一つぐらい読んでいれば変わったかもしれません。)

プログラムを書くことよりも動かすことに興味があったので、ローカルでperlを動かしたり、Windowsを自家サーバとして公開しようとしました(公開しなくて良かった)ので、この頃にサーバーとはなんたるかの超初歩は理解してた気もします。

koheisgがどうやってプログラミングを身につけたか? - HTML/CSS編 -

koheisgがどうやってプログラミングを身につけたか? - HTML/CSS編 -

どのようにしてHTML/CSSを身につけたか

きっかけはバンドを組んでないのにホームーページを作ろうとしたこと

中学校二年生の頃、バンドを組んでないのにバンドのホームページを作りたいと思っていました。 ある日、ある友達がホームページを持っていることを知り、彼にfront homepage express入門本を借り、早速サイトの制作に取り掛かりました。

その本を読み終え、geocitiesに簡単なテキストサイトを公開したように思います。

front homepage expressだけではいい感じのサイトにならず、どうしてもかっこ悪いデザインになってしまう。そこで本の巻末にあったメモ帳でhtmlファイルを編集する方法でサイトの更新を行うようになりました。

この時友達に質問したことを今でも覚えています。

sg「画像の横に文字書くのにはどうすんの?」

友達「罫線のない表を組めばいい」

爆誕tableレイアウトコーダー

tableレイアウトを覚えるとどんなデザインでも実現できるようになりました。 僕は様々なレイアウトのページをhtmlで作っていました。 htmlだけを作るのが楽しくなって、絵を描くようにいくつもサイトを作っていました。 サイトのメニューをいい感じに作れるようにframeタグもうまくつかっていました。 この頃にはエディタもterapadというお気に入りのエディタがありました。

「違う。。何かが違う。。俺のサイトはyahooとは全然違うぞ!!」

そう思った僕はありとあらゆるサイトを 右クリック→ソースを表示 を繰り返し、cssを学んでいきます。 ググりまくる中で、プロはレイアウトをdivで組むしいということを知り、floatレイアウトを覚えました。

cssは僕にとって最初aタグのhoverを作るためだけだったものでしたが、htmlは構造を書き、cssで見た目の装飾するという基本に気づいたのはこの頃でした。

インターネット上に公開されてるhtmlのソースを見て、見よう見まねでhtmlを覚えました。 この時に論理だった話はあまり勉強しなかったように思います。とほほさんのサイトにはお世話になった気がしますが、htmlは直感で乗り越えた気がします。

この頃高校生くらいになっていたかと思いますが、簡単なWebページであれば趣味レベルで作ることができるようになっていました。

これからHTML/CSSを勉強する人に

  • 色々なパターンのデザインを作ってみること
  • 気になったらソースコードを読むこと

この二つが大事に思います。僕が中学生の時代よりはdeveloper toolsなども発達し、上記二つの作業のPDCAも回しやすくなってきたと思います。developer toolsの使い方はここでは触れませんので、検索するなどして見てください。

koheisgがどうやってプログラミングを身につけたか? - CGI編 -

ブログをjekyllに移管のためにやったこと・やらなかったこと

jekyllにブログを変えてみました。 markdownで記事を書けるのはやはりすごい楽です。 お気に入りのエディタであるvimで書けることも素晴らしいです。 やったこと、やってないことをまとめておきます。

やったこと

bloggerで運営していたブログを移管しました。 一部labelページ以外を除いて、同じURLに移行しました。

bloggerで長らく運営していたこのブログですが、 bloggerのhtmlがなかなか弄りにくいことが主な要因です。

blogger自体テーマがあまり充実していないのと、良いテーマがあっても、 それをカスタマイズするのにhtmlのようなxmlを弄るのに疲れてしまいました。

wordpressという手段もあったのですが、静的サイトジェネレータに興味があったので、 今回のような形になりました。

ちなみに静的サイトジェネレータをjavascriptで作ろうとしたのですが、 そこは挫折してしまいました。。

なんでhugoじゃないの?とかなんでoctopressじゃないの? って質問があると思うので、書いておきます。

hugoじゃない理由

rubyでpluginを作れることとgithub pagesでメジャーな手段になったことくらいでしょうか。 hugoは正直魅力的なので、どこかで試してみたいとは思っています。

octopressじゃない理由

htmlを弄りやすいようにしたいことが、今回の動機でもあったので、 octopressはテーマは充実していますが、htmlがそんなに得意ではない自分ではoctopressのテーマは弄りにくいなぁと思いました。 あと、jekyllの方がdocsも充実しているように見えたのと、コード自体の見通しもよかったです。

その他検討したもの

フロントの実装がメインになる静的サイトジェネレータですから、javascriptで全てを統一するという夢は僕もみました。 javascriptのエコシステムでほとんどのものがそろっていますので、gulpで適当にビルドしたりデプロイしたりは容易い御用なはずです。

そこでmatalsmithというjavascript静的サイトジェネレータを検討していたのですが、 独自のpluginのインターフェースに実装していくのが、骨が折れてしまいました。

しかも、pluginのほとんどはnpmのエコシステムにありふれたものをpluginとしてラッパさせたもので、 少しjavascriptを書けばいろいろなことができそうだったのですが、それを書く手間をはぶけるcomponent型のシステムを作れば。。。

と考えたところで土つぼにはまってしまい、本来のブログを書くという目的を見失っていたところ、 ふと正気に戻り、jekyllという選択をした経緯があったりします。。

各記事のURLが変わらないように。。

sitemap.xmlを取得して、URLを抽出。 その抽出したURLに対して、phpunit gazzleで200が帰ることをテストで書く。 そして、 /etc/hosts を新環境に向く事を確認して、再度同じテストを回す。

URLが変わってしまった記事に対してはテストが落ちるので、ちょこちょこそれらを微調整していく。 まぁ、そんな感じです。

やれていないこと or 見送ったこと

  • tag(label)の移管
  • google tag manager
  • slim or haml の導入

tagの移管も本当はしっかりしたいのだけど、まだできていない。 本当は移管自体はできているのだけど、ちゃんと機能させれていない。

google tag managerで広告枠とanalyticsを管理したかったけど、とりあえずいつでもできるので後回しに。

slimを導入したかったのだけど、ちゃんとコンパイルできず。。 jekyll puluginの使い方などわかっていないところがあるので、その辺りがわかるようになったら再度挑戦って感じかな。 htmlは書きにくいけど、DreamWeaverに頼れば割と簡単にいろいろできそうだし。。