yukimori_726のブックマーク - はてなブックマーク

ドキュメントの場所を知らせるために、落ちるテストを作る - $shibayu36->blog;

今回はドキュメントの場所をどうやって気づかせるかという話を書く。ドキュメントがあるときの問題以前開発のドキュメントをどこに置くか問題 - $shibayu36->blog;に書いたとおり、僕の意見としては基本は実装に一番近いところにコメントとしてドキュメント書くのが良いと思ういろんなパーツが絡みあうような大きな機能の場合、導入部分だけ別の場所に書く出来るだけrepository内に入れておくと探しやすく、更新しやすいと思うというものだった。基本的には一番近いコメントにすると、見つけやすさ・更新しやすさともにある程度担保することが出来る。しかし、メインの部分が明確に決まらない*1いろんなパーツが関係しあう機能の場合は、ドキュメントを書かないと全体の概要が分からないということもある。このような時、ドキュメントを書いても結局そのドキュメントに気づかれないし、そのため更新されないとい

yukimori_726 2014/04/14

リンク

nginxのproxy設定ファイルも自動テストしよう - $shibayu36->blog;

最近nginxでリバースプロキシの設定を書いているんだけど、設定のたびに本番に緊張しながら反映していた。さらにその副作用として、nginxのファイルはリファクタリングされないという問題があった。そこで反映する前にバグ等が見つかるようにnginx設定のテストを書きたいと考えた。今回はperlでテストを書いた。どういうテストをしたいかやり方によってnginxの設定ファイルの分割の方法は違うのだけど、例えば以下の様なnginxの設定があり、それが別のファイルのhttpコンテキストの中にincludeされているという分割で考える。この時、この設定ファイルに書かれた内容が正しく動いているかテストを書きたい。 upstream app1 { server app1.host; } upstream app2 { server app2.host; } server { listen 8080;

yukimori_726 2014/04/12

リンク

設定の仕様をドキュメントに書くのではなく、テストにしてしまう - $shibayu36->blog;

以前開発のドキュメントをどこに置くか問題 - $shibayu36->blog;という記事を書いた。まだよい方法はちゃんと考えられてないが、少しずつケースバイケースでいろいろな手法を試してみている。今回は設定項目の仕様のドキュメントという観点で考えたときに、テストを作ることで解決できないか、ということについて書く。設定項目の仕様例えば以下の様な設定があったとする*1。 [ { "blog_url" : "http://shibayu36.hatena blog.com/", "permission" : "public", "can_be_edited_by" : [ "shiba_yu36" ] }, { "blog_url" : "http://shibayu36-private.hatena blog.com/", "permission" : "private", "can_be_

yukimori_726 2014/04/10

development

リンク

コードコンプリートを再読した - $shibayu36->blog;

以前職業プログラマーなら必ず読むべき「Code Complete」 - $shibayu36->blog;や補足 - 職業プログラマーなら必ず読むべき「Code Complete」 - $shibayu36->blog;で紹介したコードコンプリートを再読した。 Code Complete 第2版上　完全なプログラミングを目指して作者:スティーブマコネル日経BPAmazonCode Complete 第2版下　完全なプログラミングを目指して作者:スティーブマコネル日経BPAmazon 一年前はどちらかというと、コードのスタイルの話とか、条件をどうやって綺麗に書くのかとか、コメントはどう書くのかということを学びたくて読んだけど、今回はクラス設計をどうしていくべきかとか、チームでのエンジニアリングをどうしたら良いかとかを中心に読んでいった。やっぱり学びたいと思っている内容が違うとそ

yukimori_726 2014/03/17

リンク

サーバで動いているプロセスを知るために使ったコマンド - $shibayu36->blog;

今日会社の開発サーバでhitode君と遊んでて、動いているプロセスを調べていたのでメモ。動いているプロセスを知りたい基本的。 ps ax ps auxとかすると、メモリ使用量とかいろいろ見れる。動いているプロセスの関係も含めて知りたい pstreeコマンドでできる。とりあえずどんな感じに実行されているかサマリーを知りたい時は以下のコマンド。 pstree いろいろ折りたたまれているので、それを展開したい時は-cをつける。 pstree -c コマンドの引数とかも表示したい時は-aつける pstree -ac pidを知りたい時は-pつける pstree -acp 表示してみると{}で囲まれているやつがあるけど、これは多分threadなんだろうと思う。linuxではthreadのidはpidのように管理されているみたい。メモリやCPUを消費しているプロセスを知る topとかでいろいろ