概要 Ruby on Railsのコードリーディング作業を記録する。 準備 rails new RailsCodeReadingで新規プロジェクトを作成する。 Gemfileに以下を追加 gem 'pg' gem 'pry-rails' gem 'pry-doc' gem 'pry-byebug' gem ...
概要 Ruby on Railsのコードリーディング作業を記録する。 準備 rails new RailsCodeReadingで新規プロジェクトを作成する。 Gemfileに以下を追加 gem 'pg' gem 'pry-rails' gem 'pry-doc' gem 'pry-byebug' gem ...
最近API設計について学び直そうと思って数冊ピックアップして読書したので、読んだ本をリストアップしておく。 API設計の本リスト おすすめの読書順でリストアップする。 Web API: The Good Parts 一般的なAPIの設計における基本的な考え方を学ぶことができる API設計本におけるリーダブルコードのような教科書的立ち位置の本（だと感じている） Web APIの設計 Web A...
APIデザイン・パターンを読んだ。 APIの設計原則に始まり、豊富なAPIのデザイン・パターンを紹介している。 リソース指向 単一のリソースに対して、標準メソッド（ex, Create/Get/List/Delete/Update）をかけ合わせて処理を決める RPC指向 メソッドを指定して特定の手続きを呼び出して処理を決める API設計を良くするため観点 実行可能であること 表現力があ...
概要 契約テストとPactについて調べたことをまとめる。 契約テスト（Contract Testing）とは コンシューマ（サービスを呼び出す側）とプロバイダー（サービスを提供する側）の間の動作をテストするテスト手法のことである。 コンシューマーとプロバイダー間での合意を契約として記述し、その契約に基づいてテストを行う。 コンシューマーが契約を発行し、プロバイダーはその契約に従ってテストを行う形式...
概要 TypeScriptの基本について学び直す。 JavaScriptの復習 変数のスコープ（scope） グローバルスコープ windowオブジェクトのプロパティとして定義されるスコープ。 const a = "Hello"; console.log(window.a); // Hello ローカルスコープ 関数スコープ 関数内で定義された変数はその関数内でのみ有効。 f...
Jestのスナップショットテストを避けたほうが良いかもしれないデメリットについて雑メモ。 デメリット テストが脆くなってしまう スナップショットテストはUIの変更を簡単に検知することができる反面、テストの関心事ではないような変更（ex. class名のリネームだけで見た目は変わらない変更）であってもテストがFailしてしまう。 アサーションの期待が不明確 スナップショットテストではtoMatchS...
Web APIテスト技法を読んだ。 API設計のテストで5w1hを使って問いを考える話があったが、具体例が分かりやすく、示唆に富んでいた 現場のテスタビリティについて理解するフレームワークとして挙げられていた10個のPモデルが良かった。テスト戦略や計画を考える前提の整理に役立ちそう テスト計画の整備と文書化について書かれているテスト計画のフォーマット例も考えやすいシンプルなもので良かった。戦略と...
以前、GoReleaserを使ってのGoのアプリケーションを配布するというタイトルの記事でGoReleaserを使ったバイナリ配布の方法について書いたが、Dockerhubへのイメージプッシュもやってみたのでまとめておく。 ソースコードの全体像はbmf-san/gondolaを参照。 .goreleaser.yamlを設定 ockers: - image_templates: - ...