<?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 kami on Medium]]></title>
        <description><![CDATA[Stories by kami on Medium]]></description>
        <link>https://medium.com/@kami_zh?source=rss-f7eae074b21a------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*XPn1PxanwCXX9wk7iXc7Dg.jpeg</url>
            <title>Stories by kami on Medium</title>
            <link>https://medium.com/@kami_zh?source=rss-f7eae074b21a------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 06:28:03 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@kami_zh/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[Railsアプリにカレンダーを表示するGem『Carender』]]></title>
            <link>https://medium.com/@kami_zh/rails-gem-carender-3e6c51e6d9a2?source=rss-f7eae074b21a------2</link>
            <guid isPermaLink="false">https://medium.com/p/3e6c51e6d9a2</guid>
            <category><![CDATA[gem]]></category>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[calendar]]></category>
            <dc:creator><![CDATA[kami]]></dc:creator>
            <pubDate>Fri, 19 Jan 2018 16:38:45 GMT</pubDate>
            <atom:updated>2018-01-19T16:38:45.309Z</atom:updated>
            <content:encoded><![CDATA[<p><a href="https://github.com/kami-zh/carender">Carender</a>という、Railsアプリケーションにカレンダーを表示するためのGemをつくりました。</p><p><a href="https://github.com/kami-zh/carender">kami-zh/carender</a></p><p>最近日報共有アプリケーションの<a href="https://github.com/kami-zh/repost/tree/develop">Repost</a>を0から書き直しているのですが、カレンダー上にその日投稿したユーザのアイコンが並ぶと使いやすそうだと考え、実装することにしました。</p><p>そこで関連するライブラリを検討したのですが、長くメンテされていなかったりjQueryに依存していたりと、採用にいたるものは見つけられませんでした。</p><p>ほしいものにいちばん近かったライブラリとして<a href="https://github.com/excid3/simple_calendar">Simple Calendar</a>というGemがあるのですが、メソッドのインタフェースの問題上、目的の機能を実現しようとするとコードがとても煩雑になりそうでした。またテストも不十分だと感じました。</p><p>シンプルなユースケースのためのライブラリならそこまでつくるのは難しくないだろうと考え、自分で書くことに決めました。</p><h3>つかいかた</h3><p><a href="https://github.com/kami-zh/carender">README</a>にもありますが、次のように carender メソッドにブロックを渡します。これによりGem側で params[:year] と params[:month] の値を読み、その月のカレンダーが表示されます。</p><pre>&lt;%= carender do |date| %&gt;<br>  &lt;%= date.day %&gt;<br>&lt;% end %&gt;</pre><p>カレンダーの各セルで、渡されたブロックの内容がレンダリングされます。上のコードで作成されるカレンダーのHTMLは次のようになります。</p><pre>&lt;table&gt;<br>  &lt;tr&gt;&lt;th&gt;Sun&lt;/th&gt;&lt;th&gt;Mon&lt;/th&gt;&lt;th&gt;Tue&lt;/th&gt;&lt;th&gt;Wed&lt;/th&gt;&lt;th&gt;Thu&lt;/th&gt;&lt;th&gt;Fri&lt;/th&gt;&lt;th&gt;Sat&lt;/th&gt;&lt;/tr&gt;<br>  &lt;tr&gt;&lt;td&gt;&lt;/td&gt;&lt;td&gt;1&lt;/td&gt;&lt;td&gt;2&lt;/td&gt;&lt;td&gt;3&lt;/td&gt;&lt;td&gt;4&lt;/td&gt;&lt;td&gt;5&lt;/td&gt;&lt;td&gt;6&lt;/td&gt;&lt;/tr&gt;<br>  &lt;tr&gt;&lt;td&gt;7&lt;/td&gt;&lt;td&gt;8&lt;/td&gt;&lt;td&gt;9&lt;/td&gt;&lt;td&gt;10&lt;/td&gt;&lt;td&gt;11&lt;/td&gt;&lt;td&gt;12&lt;/td&gt;&lt;td&gt;13&lt;/td&gt;&lt;/tr&gt;<br>  …<br>&lt;/table&gt;</pre><p>また、任意のコレクション（ActiveRecord::Baseを継承したクラスなど）とその各要素の日付を表す属性（ created_at といったカラムなど）を渡すことで、日ごとにグループ化したコレクションを第二引数として受け取ることができます。</p><pre>&lt;%= carender collection: <a href="http://twitter.com/posts">@posts</a>, column: :posted_on do |date, posts| %&gt;<br>  &lt;% posts.each do |post| %&gt;<br>    &lt;%= link_to post.title, post %&gt;<br>  &lt;% end %&gt;<br>&lt;% end %&gt;</pre><h3>設計指針</h3><p>このGemを書くにあたって、次のことはやらないと決め、実装しました。指針を定めた理由として、Gemをメンテするのは自分なので、自分が責任を持ってメンテできる、またしたいと思える機能だけに絞ろうと考えたためです。</p><ul><li>表示するカレンダーの年月を carender メソッドに渡せるようにしたら汎用性が上がるかもしれないが、必要ないと思うので実装しない</li><li>開始曜日として日曜でなく月曜など他の曜日を指定できるようにすれば汎用性が上がるかもしれないが（以下略）</li><li>曜日のラベルをI18n対応できれば</li><li>休日・祝日の色を変更できれば</li><li>先月・翌月へのリンクを出力するヘルパがあれば</li></ul><p>セルのスタイルについては、CSSのセレクタやJavaScriptなどGemの外側で対応できそうです。ヘルパについては、パスの指定がアプリケーションによってさまざまなので、自分で実装した方が汎用性があってよさそうです。</p><p>これ以上のカスタマイズ性をもとめるのであれば、前述した<a href="https://github.com/excid3/simple_calendar">Simple Calendar</a>など他のライブラリを検討すればよいと考えています。</p><p>こういった理由で、Gem自体を極力シンプルに保つように実装しました。とはいっても長くドッグフーディングした訳ではありませんので、この中のいくつかはそのうち変わることと思います。</p><p>ぜひ、このGemをお使いいただいて、改善点やPRなどをいただければと思っております。よろしくお願いいたします。</p><h3>その他</h3><ul><li>出力されるHTMLをテストする際、<a href="https://github.com/sparklemotion/nokogiri">Nokogiri</a>はつかいたくなかったので<a href="https://gitlab.com/yorickpeterse/oga">Oga</a>をつかってみました。インストールが楽なのはもちろんですが、使い勝手もよかったです</li><li><a href="https://github.com/kami-zh/carender">Carender</a>の依存ライブラリのバージョン指定はそのうち対応します...</li></ul><p><a href="https://github.com/kami-zh/carender">kami-zh/carender</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3e6c51e6d9a2" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[30歳になった]]></title>
            <link>https://medium.com/@kami_zh/30-year-old-a320e46ae557?source=rss-f7eae074b21a------2</link>
            <guid isPermaLink="false">https://medium.com/p/a320e46ae557</guid>
            <category><![CDATA[advent-calendar]]></category>
            <dc:creator><![CDATA[kami]]></dc:creator>
            <pubDate>Fri, 22 Dec 2017 04:31:38 GMT</pubDate>
            <atom:updated>2017-12-22T04:33:45.378Z</atom:updated>
            <content:encoded><![CDATA[<p>この記事は<a href="https://adventar.org/calendars/2151">誕生日 Advent Calendar 2017</a>の20日目の記事です。誕生日を迎えたので、1年のふりかえりと今後の目標を雑に書いていきます。</p><h4>ふりかえり</h4><p>過去3年間はフリーランスのRailsエンジニアとしていくつかのスタートアップに携わっていましたが、今年の2月から新しい職場になりました。引き続きRailsアプリを書いていますが、とりわけテストを書く力がつき、レビューをとおして漏れのないテストケースを考えられるようになりました。</p><p>また、いくつかある社内アプリのインフラ基盤をTerraformとAnsibleで書きました。Serverspecでテストを書いたり、Terraformの状態の管理についての知見を得ることができました。このインフラ基盤構築は自分で提案・実装したのですが、こういった挑戦が許される環境なのでとてもやりがいがあります。</p><p>今のプロジェクトではGo言語でLinuxプログラミングをやっています。低レイヤーにさわるのは高専時代以来でしたが、興味を持って取り組むことができています。最近はC言語でシステムコールを呼んでコマンドをつくる勉強をしたりもしています。Go言語ではgo-capturerというテスト用のライブラリも書きました。</p><p><a href="https://github.com/kami-zh/go-capturer">kami-zh/go-capturer</a></p><p>OSS活動としてはRepostというOSSを作り、またこれをネタに<a href="https://techplay.jp/event/631406">Rails Developers Meetup#5</a>でキーノートを行いました。対外的な発表は初めてだったのですが、30分という長丁場でした。反省点ばかりですが、この経験のおかげでLTなど短い時間の発表に対する抵抗がなくなったのでよかったです。</p><p>これら以外にもビジネス開発に携わりました。広報を軸としたアクションを提案し会社のブランド向上に寄与したり、<a href="https://github.com/everyleaf/el-training">教育カリキュラム</a>の公開にも携わったりしました。</p><p>社会人になって、はじめてまともに社会貢献できた1年だった気がします。</p><h4>目標</h4><p>直近数年では、トラフィックをさばけるエンジニアになりたいと考えています。ある程度のトラフィックのあるサービスを、フロントからバックエンド、インフラなど、レイヤーを問わず任せられるだけの技術力をつけたいです。そのための経験を得る1年にします。</p><p>また、対外的な発表の機会をもっと得て、エンジニアとしてのブランディングも行いたいです。フルスタックなエンジニアでありつつも、自分の中でひとつ軸となる強みを見つけて育てたいです。総じてエンジニアとして深みにたどるための1年にするようやっていきます。</p><p>あとスプラトゥーン2でカンストしたいです（現在S+8が最高）。</p><h4>おわりに</h4><p>今年はよい職場にめぐりあえ、エンジニアとしてもプライベートとしても最高に充実した1年でした。来年は適度に休みつつ、もっと高められる1年にできたらと思います。</p><p>おいしいものを食べに行きましょう！</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a320e46ae557" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Capture stdout and/or stderr in Go]]></title>
            <link>https://medium.com/@kami_zh/capture-stdout-and-or-stderr-in-go-5b1d1ad06d06?source=rss-f7eae074b21a------2</link>
            <guid isPermaLink="false">https://medium.com/p/5b1d1ad06d06</guid>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[golang]]></category>
            <dc:creator><![CDATA[kami]]></dc:creator>
            <pubDate>Mon, 11 Dec 2017 10:45:27 GMT</pubDate>
            <atom:updated>2017-12-11T10:45:27.802Z</atom:updated>
            <content:encoded><![CDATA[<p><a href="https://github.com/kami-zh/go-capturer">go-capturer</a> captures os.Stdout and/or os.Stderr in Go. This package is useful for writing tests which print some outputs using fmt package.</p><p><a href="https://github.com/kami-zh/go-capturer">kami-zh/go-capturer</a></p><h4>Usage</h4><p>This package provides CaptureStdout(), CaptureStderr() and CaptureOutput() functions to capture outputs.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/531a971131a1a3f3c1491510b054ec1f/href">https://medium.com/media/531a971131a1a3f3c1491510b054ec1f/href</a></iframe><h4>Installation</h4><pre>$ go get github.com/kami-zh/go-capturer</pre><h4>Contributing</h4><p>Bug reports and pull requests are welcome on GitHub at <a href="https://github.com/kami-zh/go-capturer">https://github.com/kami-zh/go-capturer</a>.</p><h4>License</h4><p>The package is available as open source under the terms of the MIT License.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5b1d1ad06d06" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[日報共有アプリケーションをOSSとして開発している話]]></title>
            <link>https://medium.com/@kami_zh/introducing-repost-24e1a84efc55?source=rss-f7eae074b21a------2</link>
            <guid isPermaLink="false">https://medium.com/p/24e1a84efc55</guid>
            <category><![CDATA[ruby-on-rails]]></category>
            <category><![CDATA[open-source]]></category>
            <category><![CDATA[redux]]></category>
            <dc:creator><![CDATA[kami]]></dc:creator>
            <pubDate>Thu, 06 Jul 2017 01:27:49 GMT</pubDate>
            <atom:updated>2017-07-06T01:32:43.382Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KC7Clw_F8fpoFKMt9r0adw.png" /><figcaption>日報一覧画面</figcaption></figure><p>最近、プライベートな時間をつかって<a href="https://github.com/kami-zh/repost">Repost</a>というオープンソースの日報共有アプリケーションを開発しています。</p><p>投稿した日報に対して、コメントや絵文字でリアクションすることでチームでのコミュニケーションを活性化させることを目的としています。日報版<a href="https://slack.com/">Slack</a>のようなイメージです。</p><p>まだ開発着手から1ヶ月ということもあり、バージョン0.0.1でまともに稼働できる段階ではないですが、開発のモチベーションを高めるためにも記事を書いてみました。</p><h4>技術スタック</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*q8yZ53L7_a85MCv4FbmfAg.png" /><figcaption>チャンネル作成画面</figcaption></figure><p><a href="https://github.com/kami-zh/repost">Repost</a>はフロントエンドにReduxを採用し、SPAとして構築しています。APIサーバとしてのバックエンドはRuby on Railsで開発しています。また、エディタ部分は<a href="https://draftjs.org/">Draft.js</a>を用いてMarkdownエディタを実装しているところです。</p><p>Draft.jsについては、過去にとあるプロダクトに採用した経験があったのですが、当時は拡張性はあるもののつらみの多いライブラリ、という印象でした。ただ最近は<a href="https://www.draft-js-plugins.com/">DraftJS Plugins</a>でメンションや絵文字といった機能を導入できるプラグインなども登場しており、これらを実装予定だったため導入してみました。<a href="https://github.com/ianstormtaylor/slate">Slate</a>なども候補にあったのですが、どれがよいのでしょうか……。</p><p>JavaScriptのビルドについては、今回SPAのためSprocketsを完全に捨ててWebpackerで行っています。<a href="https://github.com/rails/webpacker/issues/444#issuecomment-311729732">本番環境でのビルドでハマった</a>りもしましたが、すんなりと移行できた気がします。一度開発フローが整いさえすれば、<a href="https://webpack.js.org/configuration/dev-server/">webpack-dev-server</a>の恩恵もあり、フロントエンドの開発効率はとても上がった実感がありました。ただ一定のWebpacker力が要求されるので、その辺りの兼ね合いで選定すればよい気がします。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JMSvLtgPGKfKIQbt-2UJqg.png" /><figcaption>Slack連携設定画面</figcaption></figure><p>テストは今回Ruby on Rails標準のスタックであるMinitest+Capybaraで実装しています。テストデータの生成も、Factory GirlやDatabase Cleanerを使わず標準の<a href="http://guides.rubyonrails.org/testing.html#the-low-down-on-fixtures">Fixtures</a>を用いています。RSpecは（私の書き方の問題でしょうが）実装する上で悩むことがままあったのですが、Minitestは書いていてとても気持ちいいです。またRails5.1から<a href="http://guides.rubyonrails.org/testing.html#system-testing">System Testing</a>が導入され、E2Eテストを書く環境が標準で入るようになりました。JavaScriptに対するテストを書く際の特有の面倒さはありますが、Webpackerとの相性もよく、今のところ気兼ねなくテストを書けています。E2EテストがCI上でだけ稀にコケる、といったケースもありますが、<a href="https://github.com/y-yagi/minitest-retry">Minitest::Retry</a>というライブラリのおかげで安定するようになりました。</p><p>本当はReactコンポーネントのテストなども書くべきだと思いますが、開発初期段階のためUIが大きく変わる可能性もあり、開発効率を優先して現状はRails側のユニットテスト+E2Eテストのみを実装しています（という言い訳を……）。</p><p>Reduxについては、Reducerまわりの実装にImmutable.jsを導入したかったのですが、アプリケーションの規模も小さくうまみが少なそうだったので一旦保留にしました。今回個人的にやってよかったプラクティスはFeature Componentで、エンドポイントとしてのFeature ComponentをRouterから呼び出し、そこからContainer/Presentational Componentを呼び出す、という構成にすることで問題をシンプルに扱えたような気がします。この辺りの知識については以下の記事がとても役立ちました。</p><ul><li><a href="http://qiita.com/kuy/items/869aeb7b403ea7a8fd8a">Reduxでコンポーネントを再利用する</a></li><li><a href="https://medium.com/@dan_abramov/smart-and-dumb-components-7ca2f9a7c7d0">Presentational and Container Components</a></li></ul><p>JavaScriptの構造的な設計については、同じスタックである<a href="https://github.com/tootsuite/mastodon/tree/master/app/javascript">Mastodonのソースコード</a>がとても参考になりました。</p><h4>なぜつくった</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vsiC7Z_TXmDtqGS4wZsMOQ.gif" /><figcaption>日報一覧画面（無限スクロール）</figcaption></figure><p>フリーランスの頃、オープンなコミュニティの中で日報を共有しつつコミュニケーションをとりながら仕事できたら楽しそうだな、と思ったのがきっかけです。今は会社員としてエンジニアをやっていますが、社内で開発コンテストがあり、6月の業務時間の一部を<a href="https://github.com/kami-zh/repost">Repost</a>の開発にあててよいことになったため、せっかくなのでと着手しました（といっても開発の95%以上はプライベートな時間で行いました）。</p><p>ふりかえってみると、ReduxでSPAをつくってみたかったり、バックエンドをAPIサーバとしてのみで構築してみたかったり、Sprocketsを捨ててWebpackerのみで運用するとどうなるか知りたかったりと、技術的な欲求の方が強かった気がします。</p><p>あとはRedux+Ruby on Railsの参考実装としてのOSSがあまりなかったので、知見を広めることも開発のモチベーションになりました。</p><p>総じて技術的にも学びが多く、アプリケーションに対するご意見をいただく機会もあり、またドッグフーディングしていて便利に感じることも多いので、今後も開発を続けていきたいと考えています。PRやご意見だけでも大歓迎ですので、お気軽にコンタクトいただければと思います。</p><h4>便利なライブラリ一覧</h4><p>最後に、<a href="https://github.com/kami-zh/repost">Repost</a>を開発する上で有用だったライブラリを紹介します。Gemは<a href="https://github.com/kami-zh/repost/blob/master/Gemfile">リポジトリのGemfile</a>にあるとおり代表的なものしか導入していないので、フロントエンド開発で役立ったNode.jsライブラリをまとめてみます。</p><ul><li><a href="https://github.com/svrcekmichal/redux-axios-middleware">redux-axios-middleware</a>: HTTPクライアント<a href="https://github.com/mzabriskie/axios">axios</a>のミドルウェア</li><li><a href="https://github.com/mjrussell/redux-auth-wrapper">redux-auth-wrapper</a>: 認証・認可用コンポーネント</li><li><a href="https://github.com/erikras/redux-form">redux-form</a>: フォーム用の状態を管理</li><li><a href="https://github.com/elgerlambert/redux-localstorage">redux-localstorage</a>: ストア内の特定の状態をLocalStorageに保存</li><li><a href="https://github.com/okonet/react-dropzone">react-dropzone</a>: ドラッグ&amp;ドロップ用コンポーネント</li><li><a href="https://github.com/danawoodman/react-fontawesome">react-fontawesome</a>: フォントアイコン</li><li><a href="https://github.com/CassetteRocks/react-infinite-scroller">react-infinite-scroller</a>: 無限スクロール用コンポーネント</li><li><a href="https://github.com/reactstrap/reactstrap">reactstrap</a>: Bootstrap v4用コンポーネント</li><li><a href="https://github.com/ShinyChang/react-text-truncate">react-text-truncate</a>: 文字の丸め処理（日本語も対応）</li><li><a href="https://github.com/mapbox/remark-react">remark-react</a>: MarkdownをReactコンポーネントに変換</li><li><a href="https://github.com/JedWatson/classnames">classnames</a>: コンポーネントへのクラス名付与</li><li><a href="https://github.com/ianstormtaylor/to-snake-case">to-snake-case</a>: 文字列をsnake_caseに変換</li></ul><p><a href="https://github.com/kami-zh/repost">kami-zh/repost</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=24e1a84efc55" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>