<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Masayuki Izumi on Medium]]></title>
        <description><![CDATA[Stories by Masayuki Izumi on Medium]]></description>
        <link>https://medium.com/@izumin?source=rss-666f0299f670------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*GA2xIJ32qeon--JD.jpeg</url>
            <title>Stories by Masayuki Izumi on Medium</title>
            <link>https://medium.com/@izumin?source=rss-666f0299f670------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 07:28:50 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@izumin/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[os.Signal に応じていい感じになる context]]></title>
            <link>https://medium.com/izumin/os-signal-%E3%81%AB%E5%BF%9C%E3%81%98%E3%81%A6%E3%81%84%E3%81%84%E6%84%9F%E3%81%98%E3%81%AB%E3%81%AA%E3%82%8B-context-a704780ec664?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/a704780ec664</guid>
            <category><![CDATA[go]]></category>
            <category><![CDATA[golang]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Mon, 16 Dec 2019 01:38:04 GMT</pubDate>
            <atom:updated>2019-12-16T01:44:36.068Z</atom:updated>
            <content:encoded><![CDATA[<p><a href="https://qiita.com/advent-calendar/2019/go6">Go 6 Advent Calendar</a> 15日目が空いてたのでいただきました🙏</p><h3>Context with signals</h3><p>こういうコード。</p><pre>ctx, cancel := context.WithCancel(context.Background())<br>defer cancel()</pre><pre>sigCh := make(chan os.Signal)<br>defer close(sigCh)<br>signal.Notify(sigCh)</pre><pre>go func() {<br> for range sigCh {<br>  cancel()<br> }<br>}()</pre><pre>doSomething(ctx)</pre><p>Go でツールを作るたびに頻繁に書いてるので、それだけやるパッケージをつくった。</p><p><a href="https://github.com/srvc/appctx">srvc/appctx</a></p><p>こうなる。</p><pre>ctx := appctx.Global()<br>doSomething(ctx)</pre><p>実はもうちょい高級なことをやっていて、次のような振る舞いをする。</p><ul><li>1回目の Signal を受けたら context を cancel する</li><li>2回目の Signal を受けたら無視する</li><li>3回目の Signal を受けたら、 os.Exit(1) してしまう</li></ul><h3>元ネタ</h3><h4>実装の元ネタ</h4><p>元ネタは moby/buildkit に含まれていた appcontext という utility 。</p><p><a href="https://github.com/moby/buildkit/blob/v0.6.2/util/appcontext/appcontext.go">moby/buildkit</a></p><p>srvc/appctx.Global() と buildkit/util/appcontext.Context() はデフォルトでは同じ挙動をする。 srvc/appctx のほうは listen する signal の種類や KILL までの回数など、一部のパラメタを変更できるようになっている。</p><h4>振る舞いの元ネタ</h4><p>最初 buildkit 版を見たとき「os.Exit はいくらなんでも乱暴では？」という感想を抱いた。が、よく考えるとたとえば Ruby on Rails の rails server などは Ctrl-C を3回押すと KILL されるようになっている。Dgraph でも同じような挙動が実装されている。</p><p><a href="https://github.com/dgraph-io/dgraph/blob/v1.1.0/dgraph/cmd/alpha/run.go#L528-L553">dgraph-io/dgraph</a></p><p>Production Ready な分散 DB である Dgraph が採用してる仕様なら許されるのでは！？という思考に至ったので、同じような挙動をするライブラリとして切り出してみた。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a704780ec664" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/os-signal-%E3%81%AB%E5%BF%9C%E3%81%98%E3%81%A6%E3%81%84%E3%81%84%E6%84%9F%E3%81%98%E3%81%AB%E3%81%AA%E3%82%8B-context-a704780ec664">os.Signal に応じていい感じになる context</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[GitHub Actions で reviewdog を動かす]]></title>
            <link>https://medium.com/izumin/reviewdog-on-github-actions-c5d5ba705eb7?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/c5d5ba705eb7</guid>
            <category><![CDATA[continuous-integration]]></category>
            <category><![CDATA[github-actions]]></category>
            <category><![CDATA[golang]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Tue, 16 Apr 2019 11:33:47 GMT</pubDate>
            <atom:updated>2019-04-16T11:33:47.042Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fLcFZnBhI6ghgH5yp_SxUQ.png" /></figure><p>やってみた</p><h3>モチベーション</h3><p>reviewdog 導入における最大の障壁（めんどくささ）は、「GitHub にコメントを残すためのアクセストークンの生成・設定」である。このプロセスが省略できれば、reviewdog の導入は設定ファイルのコピペだけで完了することになるはず。</p><h3>設計</h3><p>「導入を如何に簡単化するか」を突き詰めたいので、ある程度制約をつけていく。自分はとりあえず Go プロジェクトに導入したいので、以下のような前提を置く。</p><ul><li>設定はすべて .reviewdog.yml に書いてあり、実行は reviewdog -reporter=github-pr-review を叩くだけ</li><li>必要な linter はすべて tools.go にリストアップされている</li><li>Modules で依存管理している</li></ul><p>できたものは <a href="https://github.com/izumin5210/actions-reviewdog/blob/master/golang/entrypoint.sh">izumin5210/actions-reviewdog の /golang</a> にある。以下のように参照してあげると利用できる。</p><pre>workflow &quot;lint&quot; {<br>  on = &quot;pull_request&quot;<br>  resolves = [&quot;lint and report&quot;]<br>}<br><br>action &quot;lint and report&quot; {<br>  uses = &quot;izumin5210/actions-reviewdog/golang@master&quot;<br>  secrets = [&quot;GITHUB_TOKEN&quot;]<br>}</pre><h4>Dockerfile</h4><p>必要なものを淡々とインストールしているだけ。</p><pre>FROM golang:alpine</pre><pre>LABEL &quot;com.github.actions.name&quot;=&quot;reveiwdog for Golang&quot;<br>LABEL &quot;com.github.actions.description&quot;=&quot;a reviewdog in a cage&quot;<br>LABEL &quot;com.github.actions.icon&quot;=&quot;message-circle&quot;<br>LABEL &quot;com.github.actions.color&quot;=&quot;orange&quot;</pre><pre>LABEL &quot;repository&quot;=&quot;http://github.com/izumin5210/actions-reviewdog&quot;<br>LABEL &quot;homepage&quot;=&quot;http://github.com/actions-reviewdog&quot;<br>LABEL &quot;maintainer&quot;=&quot;Masayuki Izumi &lt;m@izum.in&gt;&quot;</pre><pre>RUN apk add -U --no-cache bash build-base git jq</pre><pre>RUN go get github.com/reviewdog/reviewdog/cmd/reviewdog<br>RUN go get github.com/izumin5210/gex/cmd/gex<br>ENV GO111MODULE on</pre><pre>ADD entrypoint.sh /entrypoint.sh<br>ENTRYPOINT [&quot;/entrypoint.sh&quot;]</pre><h4>entrypoint.sh</h4><p>GITHUB_EVENT_PATH が示すファイルにイベントの payload が入っている。そこから reviewdog が満足するように jq で値を取り出し変数に格納している。</p><p>Go Modules 前提なので go mod download を叩き、 tools.go 前提なので <a href="https://github.com/izumin5210/gex">gex</a> で linter をビルドしている。</p><pre>#!/usr/bin/env bash</pre><pre>set -euo pipefail</pre><pre>echo &quot;--&gt; Setup env&quot;<br>export CI_PULL_REQUEST=$(cat $GITHUB_EVENT_PATH | jq -r .number)<br>export CI_COMMIT=$GITHUB_SHA<br>export CI_REPO_OWNER=$(cat $GITHUB_EVENT_PATH | jq -r .repository.owner.login)<br>export CI_REPO_NAME=$(cat $GITHUB_EVENT_PATH | jq -r .repository.name)<br>export CI_BRANCH=$(cat $GITHUB_EVENT_PATH | jq -r .pull_request.head.ref)<br>export REVIEWDOG_GITHUB_API_TOKEN=$GITHUB_TOKEN<br>export PATH=$(pwd)/bin:$PATH<br>env | grep CI_ | sort</pre><pre>echo &quot;--&gt; Download dependencies&quot;<br>go mod download</pre><pre>echo &quot;--&gt; Build tools&quot;<br>gex --build</pre><pre>echo &quot;--&gt; Run reviewdog&quot;<br>reviewdog -reporter=github-pr-review</pre><h3>感想</h3><h4>pros</h4><ul><li>.github/main.workflow に4行 ~ 9 行程度書くだけなので導入が超簡単</li><li>reviewdog 最大の面倒くささである「アクセストークンの生成・設定」を考えなくてよくなる</li></ul><h4>cons</h4><ul><li>依存のキャッシュができないので、大規模プロジェクトだと厳しい<br>（依存をすべて入れる必要がない rubocop 等なら問題なさそう）</li><li>Actions 自体の debuggability が高くないので、正しく動かないときの原因調査がしんどい</li><li>Go や Ruby のランタイムのバージョンを指定できない</li></ul><p>以上は izumin5210/actions-reviewdog のような「共通化した Action」を作る前提に立っている。共通化しない == 「各リポジトリに Action の Dockerfile や entrypoint.sh を配置する」場合、ランタイムのバージョンを始めとした柔軟性は得ることができる一方で、たかが Lint を動かすために Dockerfile を書かないといけないのか？ という気持ちにさせられる。</p><h3>現時点（20190416）の結論</h3><ul><li>導入の簡単さは申し分ない</li><li>キャッシュが効かないのはかなり厳しい</li></ul><p>ということで、Go リポジトリに入れるのはまだ難しいかなという結論です。逆に言うと、キャッシュを有効化できるようになるなら導入を検討してもいいかもしれない。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c5d5ba705eb7" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/reviewdog-on-github-actions-c5d5ba705eb7">GitHub Actions で reviewdog を動かす</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[“Running Lean — 実践リーンスタートアップ” を読んだ]]></title>
            <link>https://medium.com/izumin/running-lean-%E5%AE%9F%E8%B7%B5%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%A2%E3%83%83%E3%83%97-%E3%82%92%E8%AA%AD%E3%82%93%E3%81%A0-596d9bf815fd?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/596d9bf815fd</guid>
            <category><![CDATA[reading]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Wed, 27 Mar 2019 12:46:26 GMT</pubDate>
            <atom:updated>2019-03-27T12:46:26.415Z</atom:updated>
            <content:encoded><![CDATA[<h3>“Running Lean — 実践リーンスタートアップ” を読んだ</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*7tAFe8C71XvnQU6L" /><figcaption>Photo by <a href="https://unsplash.com/@epicantus?utm_source=medium&amp;utm_medium=referral">Daria Nepriakhina</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>ひとに本を勧める機会がたまにあるが、そのとき困らないように読書ログを残すことにした。フォーマットは以下のようにする。</p><ul><li>WHY — なぜ読むか</li><li>WHAT — なにを読むか</li><li>ざっくり感想</li><li>誰にオススメ？</li><li>次に何読む？</li></ul><p>とりあえず1冊目。自分は技術は自発的にインプットするけど、プロダクト開発系のインプットは少ないので、そこの補強も兼ねて Running Lean を読んだ。</p><h3>WHY</h3><ul><li>スタートアップで働いている割に、こういうスタートアップ・プロダクト開発に関する本をあまり読んだことがなかい</li><li>いままでは新規開発・基盤開発寄りだったが、プロダクトを成長させることにもしっかりコミットしたい</li><li>インターン・内定者を見ることが増えてきたので、人に教えることができるように、感覚で理解している分野を体系的に学びたい</li></ul><h3>WHAT</h3><p>スタートアップでプロダクトを作るための方法論などを述べている本といえば『<a href="https://amzn.to/2J5xTiN"><strong>リーンスタートアップ</strong></a>』（以下、青いやつ）が最初に浮かぶ。一方で、青いやつはそこそこ厚く、文章も読みづらいという評判をどこかで聞いた。</p><p>自分のメンターが「<strong>Running Lean</strong> は実践書でわかりやすい」と言っていたので、スタートアップにおけるプロダクト開発の入門書としてとりあえず読んでみることにした。</p><p><a href="https://amzn.to/2J7ddHa">Running Lean ―実践リーンスタートアップ (THE LEAN SERIES)</a></p><p>自分は Kindle Paperwhite 上で読みたかったので、O’Reilly の Ebook store で購入した。</p><p><a href="https://www.oreilly.co.jp/books/9784873115917/">Running Lean</a></p><h3>感想</h3><p><a href="https://amzn.to/2u1s4bL">“THE LEAN SERIES” と銘打たれたものは6冊ある</a>が、その中でも「リーンスタートアップのはじめかた」と言える本（他のやつ読んでないから知らんけど）。青いやつのエッセンスを抽出し、例を出しつつより実践的な内容でまとめあげたものになっている（青いやつまだ読んでないから知らんけど）。会社の新卒研修でやった内容はここから来ているのかーという気付きもあり楽しい。</p><p>「構築→計測→学習→…」のサイクルや「MVP(Minimum Viable Product)」「UVP(Unique Value Proposition)」といった、リーンスタートアップにおいて基本かつ重要なキーワードを広くなめることができる。より深掘りしたいトピックについては青いやつや THE LEAN SERIES の後続の該当しそうな本を読めば良さそう。著者自身のプロダクト開発を例にしながら話がすすんでいくため理解しやすい。</p><p>いま世に出ているスタートアップ・プロダクト開発の本には多かれ少なかれリーンスタートアップに触れている。そういう本を知識ゼロで読む前に、とりあえず Running Lean 読んどけばなんとなく雰囲気が掴めるので便利。280ページとカジュアルに読める分量なので、スタートアップで働く前の1冊目として非常に優秀な本だと感じた。もっと早くに読んどくんだった。</p><p>（とりとめがなくなってしまった。）</p><h3>誰にオススメ？</h3><ul><li>スタートアップで働きはじめる前のひと</li><li>「自分以外の人にも使ってほしい」ものをつくることがあるエンジニア</li></ul><p>身近なところでは、インターンを経てスタートアップの内定を得た学生が読んでおくと、働き始めがよりスムーズになりそう。ただ、プロダクト開発経験が無の状態で読むとピンとこないかもしれない。</p><p>あとはフレームワーク・基盤開発、社内向けサービスの開発などに携わる人も読むと良いかも。「既存のものと比較したときのUVPはなにか」「MVPを作って使い勝手を確かめる」「何人かのアーリーアダプタにインタビューして価値を確かめる」など、活かせる考え方はたくさんありそう。限りあるリソースを無駄にできないプロダクト開発というところには違いないし。</p><h3>次になに読む？</h3><p>「プロダクト開発の即戦力」力を高める意味では次の2つが有力（自分は “ハマるしかけ” に進んだ）。</p><ul><li><a href="https://amzn.to/2TwmlK1">Hooked — ハマるしかけ</a></li><li><a href="https://amzn.to/2Ja2n37">Lean Analytics</a></li></ul><p>また、実践書で雰囲気を掴んだので<a href="https://amzn.to/2J5xTiN">青いやつ</a>も目を通してみたい。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=596d9bf815fd" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/running-lean-%E5%AE%9F%E8%B7%B5%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B9%E3%82%BF%E3%83%BC%E3%83%88%E3%82%A2%E3%83%83%E3%83%97-%E3%82%92%E8%AA%AD%E3%82%93%E3%81%A0-596d9bf815fd">“Running Lean — 実践リーンスタートアップ” を読んだ</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[#gocon で Plugin の話をした + 補遺]]></title>
            <link>https://medium.com/izumin/talk-about-plugin-in-gocon2018autumn-fb5e6bc5fc93?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/fb5e6bc5fc93</guid>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[plugins]]></category>
            <category><![CDATA[go]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Tue, 25 Dec 2018 13:06:25 GMT</pubDate>
            <atom:updated>2018-12-25T13:06:25.628Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*R5JFBhJ6swOHBeMJ" /><figcaption>Photo by <a href="https://unsplash.com/@brina_blum?utm_source=medium&amp;utm_medium=referral">Brina Blum</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>11/25 に開催された <a href="https://gocon.jp/">Go Conference 2018 Autumn</a> で20分喋った．</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2Fca953b38412b4e4a9fd083aa04d25617&amp;url=https%3A%2F%2Fspeakerdeck.com%2Fizumin5210%2Fconsider-pluggable-cli-tool-implementation-number-gocon&amp;image=https%3A%2F%2Fspeakerd.s3.amazonaws.com%2Fpresentations%2Fca953b38412b4e4a9fd083aa04d25617%2Fslide_0.jpg%3F477906&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/bba333f81b54f2fa307aede9a94e233e/href">https://medium.com/media/bba333f81b54f2fa307aede9a94e233e/href</a></iframe><p>GoCon 2018 Spring で話した <a href="https://github.com/izumin5210/grapi"><strong>grapi</strong></a><strong> </strong>という CLI にプラグイン機構を実装するとき，なにを考えて設計・実装したのかをまとめた発表．</p><p>「プラグイン開発者」「CLI のユーザ」どちらにとっても高い Experience を提供するためにはどんな要素が重要なのか・どのように実現すればいいのか，有名な CLI たちがどのようなアプローチを取っているかを調査した．</p><p>「使いやすい CLI」は当然 Go 以外にも存在するので，実装言語には縛られずに実例を出した．紹介したのは次の6つのツール．</p><ul><li>Ruby on Rails のジェネレータ（`rails g model` みたいなやつ）</li><li><a href="https://github.com/facebook/create-react-app">create-react-app</a></li><li>protoc</li><li>Terraform</li><li>kubectl</li><li><a href="https://github.com/volatiletech/sqlboiler">SQLBoiler</a></li></ul><p>grapi は最終的に SQLBoiler の方式を参考にしている．理由としては次の通り:</p><ul><li>grapi は「Go で Web API サーバを実装する際に利用するツール」なので，「プラグインは Go 製である」という前提をおきやすい</li><li>ツール自体のバージョンを固定をしたいので，なんらかの既存プラットフォームに載せたい</li></ul><p>Go でツール（`go get` でビルドされたバイナリを使うようなやつ）の管理はいまだデファクトが確立されていない．だが，ベストプラクティスと呼ばれるものは存在している．自分はそのベストプラクティスに倣うだけの薄いツールである gex というものを作ったことがあったので，grapi の内部では gex を利用する形にしている．</p><p><a href="https://github.com/izumin5210/gex">izumin5210/gex</a></p><p>gex については Qiita に書いたり golang.tokyo で LT したりしているので，そちらを見てもらいたい．</p><p><a href="https://qiita.com/izumin5210/items/59a29371809e36d64e04">gex で Go プロジェクトの開発用ツールの依存を管理する - Qiita</a></p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2Fd3fa35e956774ecc929d566145abd3e4&amp;url=https%3A%2F%2Fspeakerdeck.com%2Fizumin5210%2Fhow-to-manage-tool-dependencies-in-go&amp;image=https%3A%2F%2Fspeakerd.s3.amazonaws.com%2Fpresentations%2Fd3fa35e956774ecc929d566145abd3e4%2Fslide_0.jpg%3F482400&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/9f764fb1eae3b3567532de0cd7abeefe/href">https://medium.com/media/9f764fb1eae3b3567532de0cd7abeefe/href</a></iframe><h3>plugin.Plugin は？</h3><p>完全に話に組み込むのを忘れていた．</p><p>Go 1.10 のとき， macOS だと net/http で syscall が呼ばれた瞬間に panic するという地獄のような問題があってトラウマが…．</p><p><a href="https://github.com/golang/go/issues/23133">plugin: net/http.Get fatals with &quot;runtime: unexpected return pc for runtime.goexit called&quot; · Issue #23133 · golang/go</a></p><p>close されてるのでもう治ってるかもしれないけど採用事例も知らないし，gex を用いたフローとも合わないので検証すらしなかった．</p><p>また，plugin.Plugin はツール以上に管理のベストプラクティスが確立していないため，圧倒的にユーザ体験が悪くなる・改善しようにもコストがかかりすぎるというのも大きい．</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fb5e6bc5fc93" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/talk-about-plugin-in-gocon2018autumn-fb5e6bc5fc93">#gocon で Plugin の話をした + 補遺</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[golang.org/x/tools/analysis を理解する #golang #golangtokyo]]></title>
            <link>https://medium.com/izumin/understand-understand-golang-org-x-tools-analysis-b7a3aba7ae4?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/b7a3aba7ae4</guid>
            <category><![CDATA[go]]></category>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[golang]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Mon, 10 Dec 2018 11:10:15 GMT</pubDate>
            <atom:updated>2018-12-10T11:10:15.385Z</atom:updated>
            <content:encoded><![CDATA[<p>話題沸騰中の golang.org/x/tools/analysis について， golang.tokyo 静的解析 Day で調査した．</p><p><a href="https://golangtokyo.connpass.com/event/111311/">golang.tokyo 静的解析Day (2018/12/08 12:30〜)</a></p><p>analysis パッケージの詳細はきっと tenntenn さんが書いてくれるので，ここでは「軽く調査したログ」「使ってみたファーストインプレッション」だけを書く．</p><h3>エントリポイント</h3><p>とりあえず <a href="https://godoc.org/golang.org/x/tools/go/analysis#pkg-subdirectories">sub-directories</a> を眺めると，<a href="https://godoc.org/golang.org/x/tools/go/analysis/cmd/vet">cmd/vet</a> という明らかに main を持ちそうなパッケージがあった．おもむろに<a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/cmd/vet/vet.go#L44-L80">それを読む</a>と，multichecker.Main を呼ぶだけの実装になっている．</p><pre>func main() {<br> // This suite of analyzers is applied to all code<br> // in GOROOT by GOROOT/src/cmd/vet/all. When adding<br> // a new analyzer, update the whitelist used by vet/all,<br> // or change its vet command to disable the new analyzer.<br> multichecker.Main(<br>  // the traditional vet suite:<br>  asmdecl.Analyzer,<br>  assign.Analyzer,<br>  atomic.Analyzer,<br>  bools.Analyzer,<br>  buildtag.Analyzer,<br>  cgocall.Analyzer,<br>  composite.Analyzer,<br>  copylock.Analyzer,<br>  httpresponse.Analyzer,<br>  loopclosure.Analyzer,<br>  lostcancel.Analyzer,<br>  nilfunc.Analyzer,<br>  printf.Analyzer,<br>  shift.Analyzer,<br>  stdmethods.Analyzer,<br>  structtag.Analyzer,<br>  tests.Analyzer,<br>  unmarshal.Analyzer,<br>  unreachable.Analyzer,<br>  unsafeptr.Analyzer,<br>  unusedresult.Analyzer,</pre><pre>// for debugging:<br>  // findcall.Analyzer,<br>  // pkgfact.Analyzer,</pre><pre>// uses SSA:<br>  nilness.Analyzer,<br> )<br>}</pre><p>この時点で，「Analyzer の実装を渡せばいい感じに AST &amp; 型情報が渡ってくるんだろうなー」という推測ができる．</p><h4>multichecker</h4><p><a href="https://godoc.org/golang.org/x/tools/go/analysis/multichecker">Package multichecker</a></p><p>ジェネラルなフラグのパースや analyzer のバリデーションなどをやったあと，渡された analyzer を Run しているっぽい．動かしているのは unitchecker と checker の2つ．処理の本体はこの2パッケージに集約されてそう．</p><h4>singlechecker</h4><p><a href="https://godoc.org/golang.org/x/tools/go/analysis/singlechecker">Package singlechecker</a></p><p>これは vet からは呼ばれていない．実装はほぼ multichecker と同じだが， Analyzer がひとつしか渡せない点が異なる．</p><h4>unitchecker</h4><p><a href="https://godoc.org/golang.org/x/tools/go/analysis/unitchecker">Package unitchecker</a></p><p><a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/multichecker/multichecker.go#L54-L57">呼び出され方</a>を見る感じ，config ファイルを指定するとこっちが利用されるっぽい．</p><pre>if len(args) == 1 &amp;&amp; strings.HasSuffix(args[0], &quot;.cfg&quot;) {<br>  unitchecker.Run(args[0], analyzers)<br>  panic(&quot;unreachable&quot;)<br> }</pre><p>設定できる内容は <a href="https://godoc.org/golang.org/x/tools/go/analysis/unitchecker#Config">unitchecker.Config</a> を見ればわかる．</p><blockquote>It is invoked by a build system such as “go vet”:</blockquote><p>とのことなので，singlechecker / multichecker で ilnter を作っておくと go vet （go test や go build で呼ばれる）で俺だけの最強 Lint tools を呼び出せるようになる？（このへんは一ミリも調べてないのでかなり適当いってる）</p><h4>internal/checker</h4><p><a href="https://godoc.org/golang.org/x/tools/go/analysis/internal/checker">Package checker</a></p><p>こっちは internal package．<a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/internal/checker/checker.go#L138-L145">コマンドライン引数がそのまま </a><a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/internal/checker/checker.go#L138-L145">packages.Load に渡っている</a>． awesomelint ./… みたいな感じで実行をさせるときに呼ばれそう．</p><h4>Analyzer.Requires と passes/inspector</h4><p>Analyzer は単にコードを解析してレポートを作成する以外にも，後続の analyzer が使えるような形で解析結果を引き渡す仕組みがある．</p><p>…と，文章で説明できるだけの日本語能力がないので，実際にコードを見るのが良さそう．</p><h3>内部実装</h3><p>処理の本体は基本的に unitchecker もしくは internal/checker に記述されている．</p><p>基本的には Go 1.11 で入った <a href="https://godoc.org/golang.org/x/tools/go/packages">golang.org/x/tools/go/packages</a> を使って「いつも静的解析ツールをつくるときにやってること」を全部やってくれている． 具体的に何やってるか知りたいときは，<a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/internal/checker/checker.go#L187-L247">internal/checker の </a><a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/internal/checker/checker.go#L187-L247">analyze という private 関数</a>から読み進めれば良い．</p><p>詳細なコードまでは紹介しないけど，よくある「package.Loader や loader.Config の初期化」や「処理対象ファイルごとに goroutine 起動」みたいなのは全部かってにいい感じにやってくれる．</p><h3>テスト</h3><p><a href="http://golang.org/x/tools/go/analysis/analysistest">golang.org/x/tools/go/analysis/analysistest</a> という， analysis.Analyzer を簡単にテストできるパッケージも用意されている．</p><p><a href="https://godoc.org/golang.org/x/tools/go/analysis/analysistest">Package analysistest</a></p><p>使い方は実際のコードを見るのが一番早い．たとえば assign（unused assignment を探すやつ）のテストだと，testdata/src/a にテスト対象ファイルを置いておいて，それを analysistest.Run に食わせるだけ．</p><ul><li><a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/passes/assign/testdata/src/a/a.go">テスト用のコード</a></li><li><a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/passes/assign/assign_test.go#L14-L17">テストコード</a></li></ul><p>testdata においたコード中の，analysis に引っかかってほしい行に // want &quot;...&quot; って書いておくだけでいい感じにテストができる．</p><pre>s.x = s.x // want &quot;self-assignment of s.x to s.x&quot;</pre><p>便利．</p><p>ちなみに，なぜか <a href="https://github.com/golang/tools/blob/4c874b978acba4ecd4a257d3bb8829dd5de17be8/go/analysis/analysistest/analysistest.go#L133-L138">Go Modules に対応していない</a>．</p><h3>適用例</h3><p>wraperr（Wrap(err) 忘れを検知するやつ）の実装をgolang.org/x/tools/go/packages から analysis.Analyzer を使ったものに書き換えてみた．</p><p><a href="https://github.com/srvc/wraperr/pull/6">Impl with golang.org/x/tools/go/analysis by izumin5210 · Pull Request #6 · srvc/wraperr</a></p><p>testdata 以下に pkg/errors をおいてしまったので見かけの変更は追加が多くなっているが，それを除くとかなりコード量が減っているのがわかる．</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/267/1*KW0HPRHyDICEpWxncfMNUQ.png" /><figcaption>packages -&gt; analysis 移行時の diff．testdata が爆増してるのは pkg/errors がまるまる入っているから</figcaption></figure><p>実装もそうなんだけど，テストコードがかなり少なくなっている．ていうかほぼ消えた．残ったのはこれだけ．ちなみにテストカバレッジはむしろちょっと向上した．</p><pre>func TestAnalyzer(t *testing.T) {<br> testdata := analysistest.TestData()</pre><pre>cases := []string{<br>  &quot;simple&quot;,<br>  &quot;named_return&quot;,<br>  &quot;multi_return&quot;,<br>  &quot;multi_named_return&quot;,<br>  &quot;select_stmt&quot;,<br>  &quot;otherpkg_select_stmt&quot;,<br> }</pre><pre>for _, tc := range cases {<br>  t.Run(tc, func(t *testing.T) {<br>   analysistest.Run(t, testdata, wraperr.Analyzer, tc)<br>  })<br> }<br>}</pre><p><a href="https://github.com/srvc/wraperr/blob/v0.2.0/detector_test.go#L14-L198">今までのテストは完全に地獄だった</a>んだけど，その闇がすべて analysistest に吸収された結果と言える．</p><h3>所感</h3><p>linter など，静的解析を利用するツールを実装するときに書いていたボイラプレート的なコードや並列処理周りをすべて隠蔽してくれるのはやはり嬉しい．本質的なロジックの実装に集中できるようになる．</p><p>自分のお気に入りの Analyzer (linter) たちを multichecker で固めたものを用意しておけば，字句解析・型解析の結果を使いまわしつつ複数の linter を動かせるようになるので，gometalinter などのツールに比べパフォーマンスもかなり良くなるはず．</p><p>でもなにより嬉しいのはやはり analysistest パッケージの存在．testdata にターゲットの .go ファイルをおいて，analyzer の診断結果をコメントに書くだけ というのはとても楽でよい．wraperr のときは<a href="https://github.com/srvc/wraperr/blob/v0.2.0/detector_test.go#L14-L198">地獄のような table driven testing をした</a>けど，こういうしょーもないところで気を使わなくてよくなるのはほんとに助かる．</p><p>また，Analyzer の実装に迷ったときは go vet に標準で含まれる Analyzer を見に行けばサンプルがたくさんあるというのも好印象．ただただ勉強になる．</p><p><a href="https://godoc.org/golang.org/x/tools/go/analysis/passes">passes - GoDoc</a></p><p>色々書いたけど，ようするに最高ってことです．みんなもどんどん静的解析していきましょう．</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b7a3aba7ae4" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/understand-understand-golang-org-x-tools-analysis-b7a3aba7ae4">golang.org/x/tools/analysis を理解する #golang #golangtokyo</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[#gocon とおったけどおちた]]></title>
            <link>https://medium.com/izumin/accepted-and-rejected-in-gocon2018autumn-3250ab4a94bc?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/3250ab4a94bc</guid>
            <category><![CDATA[golang]]></category>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[go]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Thu, 15 Nov 2018 12:27:52 GMT</pubDate>
            <atom:updated>2018-11-15T12:27:52.595Z</atom:updated>
            <content:encoded><![CDATA[<p>Go Conference 2018 Autumn に通ったり落ちたりしたので，紹介します．</p><h3>おちたやつ</h3><p>見事に落ちたやつです．我ながら結構貴重な話ができるんじゃないかと思っていたのでちょっと悔しい．どこかで供養したい．</p><blockquote>## Title</blockquote><blockquote><strong>「Goを入れてみた」から「Go 本番導入企業」になるまで</strong></blockquote><blockquote>## Summary</blockquote><blockquote>自分が所属する会社では，2年前の新規事業立ち上げ時に初めて Go が導入されました．当初，マイクロサービス的に2つのサーバがデプロイされましたが，その後しばらくは新たなサーバが立つことはありませんでした．しかし，2018年に入ってから新規のマイクロサービスでは Go が採用される回数が増えていきました．現在は，複数のチームで独立して Go を用いた Web API サーバが開発・本番投入されています． この「Go を入れてみた」状態から新規開発でためらいなく Go を採用できる「Go 本番導入企業」となるには解決すべき問題が多々あります． そんななかで，自社が広く知見を持っていた Ruby on Rails にかわり Go が採用されるようになるまでに，何を考え・何を作り・どのような活動をしてきたかを紹介します</blockquote><blockquote>## Detailed description</blockquote><blockquote>もともとは Ruby on Rails をメインに利用する会社だったのが，新規事業立ち上げを機にマイクロサービスアーキテクチャに本格移行し，そのタイミングで Go が初めて導入されました．しかし，自社の知見・エコシステムの強さなど Ruby on Rails と比べると厳しいと言えるでしょう．さらに，Ruby on Rails は開発の初速度にかなり重きをおいたフレームワークのため，そういった意味でも Go による開発の，特に初期はどうしてもスピードが落ちてしまいます． 実際に自社でもしばらくは Go 製のサーバが増えることはありませんでした．しかしここ1年以内の間にその数は急激に増加し，最初に Go を入れたチーム以外のチームでも独立して Go による Web API サーバ開発が行われるようになりました． 「Go を入れてみた」状態から新規開発でためらいなく Go を採用できる「Go 本番導入企業」となるには解決すべき問題が多々あります．たとえば技術選定（どのフレームワークを利用するか，etc.）や運用上必要なモノ（アプリケーションメトリクス，エラーハンドリング，etc.）などが挙げられるでしょう． そんななかで，自社が広く知見を持っていた Ruby on Rails にかわり Go が採用されるようになるまでに，何を考え・何を作り・どのような活動をしてきたかを紹介します．</blockquote><h3>とおったやつ</h3><p>こっちは多少設計やインタフェースの議論が入るが，基本的には技術技術したかんじの話題．いろんなプラットフォームのツール（とくにモダンなやつ）に言及しながら話を展開できるのは自分の強みだと思ってる．</p><blockquote>## Title</blockquote><blockquote><strong>Consider pluggable CLI tool implementation</strong></blockquote><blockquote>## Summary</blockquote><blockquote>自分は gRPC サーバの scaffolding tool / template generator である grapi というツールを開発しています．最近，この grapi の generator 部分を pluggable にしたいという要求が発生し，その設計・実装をしました． 世の中には多種多様な手法で実装された pluggable な CLI が存在します． 本発表では，実装手法の検討時に行った既存ツールの調査と実際に採用した手法の紹介，実装時に意識したことなどについて紹介します．</blockquote><p>Detailed description については当日のお楽しみということで．Room A で 15:00–15:20 になります．</p><p><a href="https://gocon.jp/#A4">Go Conference 2018 Autumn</a></p><p>概要に名前が出ている grapi は v0.3.0 になった．ありがたいことに，いまでは自分のチーム以外でも採用されている．社内の新規の Go 製 API サーバは全部 grapi が使われているんじゃないかな？</p><p><a href="https://github.com/izumin5210/grapi">izumin5210/grapi</a></p><p>grapi については前回の GoCon でガッツリ話したので，今回はあくまでサブトピック．興味ある人は前回のスライドを見てもらえると嬉しいです．</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2Fc9ad7684f5f840df8e0c5ea0070b7cd5&amp;url=https%3A%2F%2Fspeakerdeck.com%2Fizumin5210%2Fgrapi-bulding-json-api-server-with-grpc-gateway-for-microservices&amp;image=https%3A%2F%2Fspeakerd.s3.amazonaws.com%2Fpresentations%2Fc9ad7684f5f840df8e0c5ea0070b7cd5%2Fslide_0.jpg%3F438448&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/ed248058e63e9d93eb28c506a8bfdd27/href">https://medium.com/media/ed248058e63e9d93eb28c506a8bfdd27/href</a></iframe><h3>Rejectcon</h3><p>Rejectcon を開催できることになった．Proposal が reject された人，出し忘れた人，ただただ Go のこと話したい人…たくさんいると思うので，みんなが楽しく Go の話をできる場になればいいと思ってます．</p><p><a href="https://wantedly.connpass.com/event/109855/">GoCon反省会（非公式RejectCon） (2018/12/06 19:00〜)</a></p><h3>スポンサー</h3><p>スポンサーも通った．スカラシップを提供できることになった．学生の参加費（交通・宿泊費）に加えて，現場のエンジニアと話を聞けるというもの．</p><p><a href="https://www.wantedly.com/projects/254596">東京は遠い！スカラシップ枠でGo Conferenceに行きたい学生へ by Wantedly, Inc.</a></p><p>高専生時代は遠方の貧乏学生エンジニアをやっていて東京のイベントには基本参加できず，DroidKaigi だけは気合い入れて夜行バスで参戦していたーみたいな時代を考えると，こういったプログラムを提供できるのはとても感慨深い．</p><p>応募する側からするとどんな感じになるのか不安になるかもだけど，最近まで学生エンジニアをやっていた自分が担当しているので，安心して応募してほしいです．参加できれば絶対後悔しない，いい体験になります！</p><p>ということで，GoCon 会場で僕と握手 🤝</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3250ab4a94bc" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/accepted-and-rejected-in-gocon2018autumn-3250ab4a94bc">#gocon とおったけどおちた</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Wrap(err) in production という話をした #golang #gounco]]></title>
            <link>https://medium.com/izumin/wrap-err-in-production-143f94592b9a?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/143f94592b9a</guid>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[golang]]></category>
            <category><![CDATA[go]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Fri, 09 Nov 2018 04:15:59 GMT</pubDate>
            <atom:updated>2018-11-09T04:15:59.719Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jFcaWfI6Fdy4zifeqFDBHA.png" /></figure><p>Go(Un)Conference ，通称「Goあんこ」という LT 大会（UnConference 形式ではない）で LT した．</p><p><a href="https://gounconference.connpass.com/event/99487/">Go(Un)Conference（Goあんこ）LT大会 4kg (2018/10/19 19:30〜)</a></p><p>スライドは以下:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fspeakerdeck.com%2Fplayer%2Fa9a8d3ae93604c55b2902bc4a3bed739&amp;url=https%3A%2F%2Fspeakerdeck.com%2Fizumin5210%2Fwrap-err-in-production&amp;image=https%3A%2F%2Fspeakerd.s3.amazonaws.com%2Fpresentations%2Fa9a8d3ae93604c55b2902bc4a3bed739%2Fslide_0.jpg%3F470688&amp;key=d04bfffea46d4aeda930ec88cc64b87c&amp;type=text%2Fhtml&amp;schema=speakerdeck" width="710" height="399" frameborder="0" scrolling="no"><a href="https://medium.com/media/07e823c5f947496821bf32dcf06f8df7/href">https://medium.com/media/07e823c5f947496821bf32dcf06f8df7/href</a></iframe><p>内容はシンプルで，みんな大好き Wrap(err) について:</p><ul><li>なぜやるのか</li><li>ふつうの github.com/pkg/errors.Wrap だと何が物足りないか</li><li>どうやっているか</li></ul><p>みたいな内容を話した．</p><p>“in production” というかなり強い名前をつけてしまったが，自分が入社以来 Go による Web API サーバの開発環境・基盤を整えていく中で考えたこと・作ったものについて，特に Wrap(err) に絞り話したことになる．</p><p>はじめて Go のプロジェクトにはいったとき， Wrap(err) の意味がわからず悩んだ経験があったので，そういう人向けのわかりやすい資料にすることをかなり意識して作った．</p><p>プレゼンでも紹介している通り，いまは <a href="https://github.com/srvc/fail">github.com/srvc/fail</a> を使って Wrap(err) をしている．</p><p><a href="https://github.com/srvc/fail">srvc/fail</a></p><p>また， Wrap(err) 忘れ対策に <a href="https://github.com/srvc/wraperr">github.com/srvc/wraperr</a> という linter を作った．これを reviewdog で動かすことで不毛なコードレビューを減らしている</p><ul><li><a href="https://github.com/srvc/wraperr">srvc/wraperr</a></li><li><a href="https://github.com/haya14busa/reviewdog">haya14busa/reviewdog</a></li></ul><p>細かい話はまた会社のエンジニアブログにでも書きます．たぶん．</p><h4>宣伝</h4><p>11/25 に <a href="https://gocon.jp/"><strong>Go Conference 2018 Autumn</strong></a> がありますが，所属している会社でスカラシップスポンサーをやることになりました．Go のエラーハンドリングの記事を読んじゃうような学生のみなさんには是非是非応募してほしいです！</p><p><a href="https://www.wantedly.com/projects/254596">東京は遠い！スカラシップ枠でGo Conferenceに行きたい学生へ by Wantedly, Inc.</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=143f94592b9a" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/wrap-err-in-production-143f94592b9a">Wrap(err) in production という話をした #golang #gounco</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[`go test` に色を付けるツールを作った #golang]]></title>
            <link>https://medium.com/izumin/painting-go-test-outputs-4fcabb7a47db?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/4fcabb7a47db</guid>
            <category><![CDATA[go]]></category>
            <category><![CDATA[golang]]></category>
            <category><![CDATA[programming]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Sun, 04 Nov 2018 13:59:46 GMT</pubDate>
            <atom:updated>2018-11-04T14:02:31.752Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sWdth5qgJp5lh9i2deCclg.png" /></figure><p>n 番煎じではあるが，つくった．</p><p>go get github.com/izumin5210/cgt でインストールして，テストの結果をgo test -v ./... | cgt みたいな感じでパイプで渡すと色がつく．</p><p><a href="https://github.com/izumin5210/cgt">izumin5210/cgt</a></p><h3>なぜつくったか</h3><p>当然ながら，既存のツールはいくつかある:</p><ul><li><a href="https://github.com/rakyll/gotest">https://github.com/rakyll/gotest</a></li><li><a href="https://github.com/kyoh86/richgo">https://github.com/kyoh86/richgo</a></li></ul><p>いずれも go test -v ./... の代わりに richgo test ./... などとして利用する，そもそもの呼び出すバイナリを差し替えるタイプのツール．</p><p>一方で，ちょっと大きめの Go プロジェクトでは make をタスクランナーとして使うことがあり，テストの実行も make test となっていることが多々ある．</p><p>そのため，テストの実行コマンドごと違うものにする既存ツールでは Makefile を変更する必要がでてくる．自分がテストの出力に色つけたいだけなのに，チーム全体に gotest や richgo を入れさせるのもなんか違う？と考えた．</p><h3>どう実現したか</h3><p>テストの実行方法に依存せず，入出力だけ意識できればいい．なので，パイプで受け取って色塗って出力するだけのツールを作るに至った．</p><p>実装はほぼ <a href="https://github.com/rakyll/gotest">gotest</a> そのままで，インプットだけ標準入力にしてある．<a href="https://github.com/kyoh86/richgo">richgo</a> の出力はきれいなんだけど，インタフェースを変えたくなかったので出力形式自体は変えていない．</p><p>（ go test の出力に対してなにかをする他ツールととの相性を考えて．あまり聞いたことはないけど…）</p><h4>余談: 色を塗る</h4><p>普段 CLI を作るとき，出力に色をつけるのに <a href="https://github.com/fatih/color">github.com/fatih/color</a> を使っていた．しかし， color は archive されてしまったため代替を探していた．</p><p><a href="https://github.com/ttacon/chalk">github.com/ttacon/chalk</a> と <a href="https://github.com/logrusorgru/aurora">github.com/logrusorgru/aurora</a> を試し，後者を採用した．どちらも使用感とかにそこまで差があるわけじゃなかったので，フィーリングによる選択．</p><p>（正直 color が手に馴染んでいたのもあり一番使いやすいと思ってるので，ちょっと残念…．fork しても良かったかもしれない．）</p><p>閑話休題．</p><h3>使用感とか</h3><p>go test の出力は見やすいとは言えないので，色がつくのはやっぱり便利．</p><p>一方で，思ったより使いやすくなくてびっくりした． | cgt って打つのが意外としんどい．qwerty 配列だと c も g も t も左手なのが良くないのかもしれない．zsh の global alias で GT を当ててみたけど，それでも打ちづらい．なにか良い global alias を思いつけば便利になりそうな予感はある．</p><p>まあどう頑張っても「 gotest ./... ってやったら色がつく」より使いやすいとはならないはず．難しい．</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4fcabb7a47db" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/painting-go-test-outputs-4fcabb7a47db">`go test` に色を付けるツールを作った #golang</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[#builderscon で「すべてが gem になる — サービス密結合からの段階的脱却」という話をします]]></title>
            <link>https://medium.com/izumin/builderscon-2018-abstract-5982a36e441?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/5982a36e441</guid>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Fri, 07 Sep 2018 23:42:19 GMT</pubDate>
            <atom:updated>2018-09-07T23:42:19.538Z</atom:updated>
            <content:encoded><![CDATA[<p>します．</p><p>いかにも Ruby っぽいタイトルですが．メインは Ruby ではないです．</p><p><a href="https://builderscon.io/tokyo/2018/session/14c60fad-20fb-4fa1-af7c-f788b5fb8588">すべてが gem になる - サービス密結合からの段階的脱却 - builderscon tokyo 2018</a></p><p>現実世界で Web 開発をしているといろんな問題にぶち当たりますが，今回はその中でも「複数アプリを1ユーザアカウントでログインできる」タイプのサービスを例に出しつつ，</p><ul><li>数年後に後悔しない設計</li><li>多少後悔しても，あとでなんとかなる設計・なんとかする手法</li></ul><p>について話します．</p><p>多少マイクロサービス的な文脈も含みます．「マイクロサービスってヤツが流行ってるらしいし，ウチもちょっとやってみっか〜」みたいな方には程よい現実を伝えられそうです．マイクロサービスのツラミを浴びたことがある人には全力でうなずいてもらえつつ，なにかしら持って帰ってもらえるような発表にしたいと思います．</p><p>11:00〜 トラックB でやるので，ぜひぜひ聞きに来てください :)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5982a36e441" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/builderscon-2018-abstract-5982a36e441">#builderscon で「すべてが gem になる — サービス密結合からの段階的脱却」という話をします</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Go の ORM / query builder 消耗日記]]></title>
            <link>https://medium.com/izumin/orm-and-query-builders-in-golang-1281c7c1e99f?source=rss-666f0299f670------2</link>
            <guid isPermaLink="false">https://medium.com/p/1281c7c1e99f</guid>
            <category><![CDATA[database]]></category>
            <category><![CDATA[golang]]></category>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[engineering]]></category>
            <dc:creator><![CDATA[Masayuki Izumi]]></dc:creator>
            <pubDate>Tue, 07 Aug 2018 11:25:14 GMT</pubDate>
            <atom:updated>2018-08-07T11:25:14.579Z</atom:updated>
            <content:encoded><![CDATA[<p>自分が Go の Web アプリを触り始めてからそろそろ1年になる．会社的にはずっと Ruby on Rails を使っていて，新しいプロダクトをリリースするにあたり一部マイクロサービスで Go を使い始めて1年経った？それくらいの頃．サーバは <a href="https://github.com/gin-gonic/gin">gin</a> で，ORM は <a href="https://github.com/jinzhu/gorm"><strong>GORM</strong></a> だった．</p><h3>GORM</h3><p><a href="https://github.com/jinzhu/gorm"><strong>GORM</strong></a> は 2018/08 現在で 9.7 k stars を集める超人気 ORM ．ちょっと Ruby の activerecord っぽい API を持つクエリビルダを持ち，なぞのちからで Associations （has_many から, polymorphism 的なのまで）や Callback にも対応する．</p><pre>db.Where(&amp;User{Name: &quot;izumin5210&quot;}).First(&amp;user)<br>// SELECT * FROM users WHERE name = &quot;izumin5210&quot; LIMIT 1;<br>// ちなみに，`Where` に struct 突っ込むとだいたい後悔する</pre><p>Ruby on Rails に慣れた人が多いというチーム事情もあり，近い使い心地の ORM を検討する中で採用されたんだと思う．しらんけど（当時を知らないので適当言ってる）．似たようなところでいうと <a href="https://github.com/go-xorm/xorm">xorm</a> など？ golang orm みたいなワードで検索すると人類が苦しんだあとがたくさん見つかっって便利．</p><p>Go に慣れてないのも相まってか，かなり苦しんだ．</p><ul><li>GORM のお気持ちを考えながらコードを書く必要がある．</li><li>GORM 自体の実装が，なんかめっちゃ難しい．なにか問題を踏んだときに，それがバグなのか仕様なのかすら調べられない程度には実装が複雑．</li></ul><p>ひとしきり消耗したあと，じつは<strong>sqlx</strong> みたいな超薄いクエリビルダだけでいいんじゃないかと思った．</p><h3>sqlx</h3><p><a href="https://github.com/jmoiron/sqlx"><strong>sqlx</strong></a> は薄い database/sql.DB のラッパ + ヘルパ関数群である．はじめて使ったのはたぶん ISUCON の練習だった．これ自体はほんとに責務が少ない．</p><ul><li>クエリの結果の struct / slice への bind</li><li>placeholder をいい感じに（$1 or ? とか， foo IN (?) と slice とか）</li></ul><p>よくあるパターン．</p><ul><li>ActiveRecord パターンに夢を見て消耗した人類が，でもやっぱり struct への bind くらいはしてほしいよなあって思ったときに使うやつ</li><li>「SQL を手で書いたほうがわかりやすいのでは？！」という真理に到達したときに使うやつ</li></ul><p>社内のある gin + GORM なマイクロサービスをフルリライトする機会があって，そのときに採用しようとした．SELECT とか全部自分でかけて超楽じゃん！って最初はノリノリで使っていた．しかし，ある程度書き進めていくと，INSERT や UPDATE で異常に消耗する事に気づく．</p><pre>// このあとどんどんカラムが増えていく…<br>db.ExecContext(ctx, &quot;INSERT INTO (user_id, title, body) VALUES (?, ?, ?)&quot;, userID, post.Title, post.Body)</pre><p>これ毎回ほんとに書くの？ってなった．「<a href="https://github.com/jmoiron/sqlx/issues/255">struct から </a><a href="https://github.com/jmoiron/sqlx/issues/255">INSERT できるようにしない？（意訳）</a>」という Issue ができているが，作者は <a href="https://github.com/jmoiron/modl">Modl</a> を使うと良いよって言ってた．あとは <a href="https://github.com/go-gorp/gorp">gorp</a> とかと併用するみたいな話もよく聞くが，2つ以上のパッケージの知識を要求されるのは悩ましい…．</p><p>正気に戻ったタイミングで，ずっと目をつけていた <strong>SQLBoiler</strong> を試すことにした．</p><h3>SQLBoiler</h3><p><a href="https://github.com/volatiletech/sqlboiler"><strong>SQLBoiler</strong></a> を構成するものは2つある．DB のテーブルのスキーマをもとにいい感じの struct 定義を生成する CLI と，その生成物を中心とした ORM + クエリビルダである．クエリビルダに関しては ActiveRecord-like を標榜するパッケージに多い builder pattern — メソッドチェインでクエリを組み立てる ものではなく，<a href="https://commandcenter.blogspot.com/2014/01/self-referential-functions-and-design.html">functional option pattern</a> で実現されており，Go に入って Go に従った感があって好感が持てる．</p><p>一方で，SQLBoiler が謳う ActiveRecord-like productivity の本質はおそらくコード生成によるものである．下記のコードは，生成される struct 定義の一部である（実際は下記に加えクエリビルダのエントリポイントになる関数群も生成される）．</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/37fef279bb650e00ce38f4b70e9ae6ef/href">https://medium.com/media/37fef279bb650e00ce38f4b70e9ae6ef/href</a></iframe><p>struct の定義は結構いろいろなことを考慮してくれている．</p><ul><li>Foreign Key Constraints を見て，Rails で言うところの has_many や belongs_to といった関連を生成してくれる</li><li>NOT NULL Constraints を見て，nullable なカラムはちゃんと null パッケージをつかってくれる</li></ul><p>など．</p><p>この，「<strong>実際のテーブル定義をもとに struct 及び関数定義が生成される</strong>」というのが非常に体験が良い．NOT NULL や Foreign Key をつけ忘れた瞬間にコード書く手間が激増することになるので，硬いテーブル定義を作らざるを得なくなるという，きょうせいギプス的な効果が得られて手に入る努力値も2倍になるしすばやさは下がらない（むしろ上がる）．</p><p>ライブラリとしての筋はとても良いので，もうちょっと使い込んでみようと思っている．ちなみに，いま（2018/8時点）で v3 がリリース目前なので，今使うなら RC 版をちゃんと指定するといいです．</p><h3>ORM に何を求めるか</h3><p>ここまでの消耗を振り返って，自分が ORM に求めるものはなんなのか考えてみた．だいたい以下のようなものが欲しいらしい．</p><ul><li>INSERT / UPDATE / DELETE クエリのビルド</li><li>placeholder まわりの helper（ ? と $ の使い分け，数をいい感じに，etc.）</li><li>クエリ結果 → struct / slice of struct へのマッピング</li><li>関連レコードの Preloading &amp; マッピング</li></ul><p>日常生活で困らない程度には書けるので，SELECT のクエリビルディングに関しては実はあまり興味がない．それで「 ORM / query builder いらないのでは？！」って一瞬勘違いしそうになった．けど，INSERT や UPDATE は長くてダルいしカラム増えたり変わったりしたときの対応が大変．そんなことに人生を浪費したくないので，パッケージ側でよしなにカバーしてもらいたい．</p><h3>ORM とコード生成</h3><p>Ruby の activerecord は，DB のテーブル定義を読んだ上でランタイムにクラス定義を拡張している．Android の ORM である <a href="https://github.com/maskarade/Android-Orma">Orma</a> や <a href="https://developer.android.com/topic/libraries/architecture/room">Room</a> はアノテーションでテーブル定義を宣言し，それをもとにクラス定義やクエリを呼ぶメソッドを生成する．Ruby はちょっと Go から遠すぎるから一旦おいておくとしても，Java で比較的快適な ORM がコード生成により実現されているのなら，Go でも ORM はコード生成によるアプローチを考えるのが正道かなとずっと考えていた．そういうのもあり SQLBoiler に目をつけていて，いまのところ大きく期待からは外れてなさそうだと思っている．</p><h3>おわりに</h3><p>自分がこれまでどのように消耗したかを振り返って，そこから「ほんとは何がほしいのか」「どういうアプローチがいいのか」を考えてみた．まだもうちょっとだけ消耗の日々は続きそうな気がする．</p><p>自分は DB に詳しいわけでもないふつうの Web アプリケーションエンジニアなので，なんかバイアスかかってるかもしれない．</p><p>本稿は <a href="https://medium.com/u/85fe747efada">timakin</a> さんの以下の記事に触発されて書かれました．</p><p><a href="https://medium.com/@timakin/%E6%9C%80%E8%BF%91-%E3%82%AF%E3%82%A8%E3%83%AA%E3%83%93%E3%83%AB%E3%83%80%E3%83%BC%E3%82%92%E4%BD%BF%E3%81%86%E3%81%AE%E3%81%8C%E3%81%A0%E3%82%8B%E3%81%84-fdb9b31ad3b0">最近、クエリビルダーを使うのがだるい</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1281c7c1e99f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/izumin/orm-and-query-builders-in-golang-1281c7c1e99f">Go の ORM / query builder 消耗日記</a> was originally published in <a href="https://medium.com/izumin">blog.izum.in</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>