スナップショット テストの説明: 仕組み、役立つ場合と問題となる場合

  1. ホーム
  2. ブログ
  3. テストの自動化

テストの自動化

スナップショット テストの説明: スナップショット テストの仕組み、役立つ場合と問題となる場合

スナップショット テストでは、コードの出力が一度保存され、その後は出力が変更されるたびにテストが失敗します。スナップショットの作成方法、差分を読み取る方法、タイムスタンプを処理する方法、スナップショットがゴム印になるのを防ぐレビューの習慣について学びます。

読了目安9分
スナップショット テストの説明: どのように機能するのか、いつ役立つのか、どのような場合に問題があるのか

ポイント

  • スナップショット テストは、正常であることがわかっている出力を保存し、その後の実行ごとにその出力と比較し、変更があった場合に差分を表示します。
  • 書き込みが速く、JSON 応答、レポート、レンダリングされたマークアップなどの大規模で構造化された出力に最適です。
  • タイムスタンプのような動的な値はスナップショットを壊します。私たちの実行では、マスクされていないタイムスタンプが次の実行で失敗しました。
  • 危険なのはブラインドアップデートです。スナップショットは、誰かが差分を受け入れる前にそれを読んだ場合にのみ保護します。

40 フィールドの JSON 応答に対するアサーションを記述するのは面倒で、ほとんどの人は 5 つのフィールドをチェックして最善の結果を期待します。 スナップショット テストは別のアプローチをとります。コードを 1 回実行し、出力全体をファイルに保存し、それ以降は出力が異なるたびにテストを不合格にします。正確なアサーションと引き換えに広範囲の変更を検出することになりますが、これは慎重に使用すれば強力です。

pytest 9.2.0、syrupy 7.0.0 スナップショット プラグイン、および Python 3.13.6 を使用して、動作するデモを実行しました。以下の出力はすべて、それらの実行からコピーされたものです。 Jest および視覚的なスクリーンショットのスナップショットは比較のために説明されていますが、実行されていません。 pytest 自体が初めての場合は、pytest チュートリアルから始めてください。

スナップショットテストとは何ですか?

スナップショット テストには手書きの期待値はありません。初めて実行すると、ツールは実際の出力を期待値として記録し、テストの隣に保存します。その後実行するたびに、新しい出力と保存されたスナップショットが比較されます。

  • それらが一致する場合、テストは成功します。
  • それらが異なる場合、テストは失敗し、差分が出力されます。
  • 変更が意図されている場合は、1 つのコマンドでスナップショットを更新し、新しいファイルをコミットします。

したがって、スナップショット テストでは、出力が正しいとは言えません。出力は変更されていないと表示されます。正確さは、スナップショットが最初にレビューされるときに、人によって 1 回チェックされます。

スナップショットの種類

種類 保存されているもの 代表的なツール
データスナップショット シリアル化されたオブジェクト、JSON、テキスト syrupy、Jest、Vitest、検証
マークアップのスナップショット レンダリングされた HTML またはコンポーネント ツリー React を使用した Jest、Vue テスト ユーティリティ
ビジュアルスナップショット ページまたはコンポーネントのスクリーンショット画像 劇作家、パーシー、クロマチック

このガイドでは、データ スナップショットに焦点を当てます。これは、データ スナップショットが最も簡単に開始でき、確認も簡単であるためです。

デモのセットアップ

# invoice.py
def render_invoice(items, now=None):
    now = now or datetime.now(timezone.utc)
    total = sum(q * p for _, q, p in items)
    return {"generated_at": now.isoformat(),
            "lines": [{"sku": s, "qty": q, "price": p} for s, q, p in items],
            "total": round(total * 1.18, 2), "currency": "INR"}

def receipt_text(items):
    rows = [f"{s:<6}{q:>3} x {p:>7.2f}" for s, q, p in items]
    return "\n".join(rows + ["-" * 20, f"TOTAL {sum(q*p for _, q, p in items):>14.2f}"])
# test_invoice.py
ITEMS = [("PEN", 2, 20.0), ("INK", 1, 50.0)]

def test_receipt_text(snapshot):
    assert receipt_text(ITEMS) == snapshot

def test_invoice_fixed_clock(snapshot):
    assert render_invoice(ITEMS, now=datetime(2026, 11, 12, tzinfo=timezone.utc)) == snapshot

def test_invoice_masked_time(snapshot):
    assert render_invoice(ITEMS) == snapshot(matcher=path_type({"generated_at": (str,)}))

snapshot 引数は、syrupy によって提供される pytest フィクスチャです。 pytest フィクスチャ ガイド では、このようにフィクスチャがどのように挿入されるかについて説明しています。

最初の走行

$ pytest -q
3 failed

$ pytest -q --snapshot-update
3 snapshots generated.
3 passed

$ pytest -q
3 snapshots passed.
3 passed

スナップショットが保存されていないため、3 つのテストはすべて失敗しました。このデフォルトは意図的なものです。新しいスナップショットは、黙って作成するのではなく、意図的に作成する必要があります。更新フラグによってスナップショットが書き込まれ、次の通常の実行が成功しました。

スナップショット ファイルの内容

syrupy は読み取り可能なファイルを __snapshots__ フォルダーに保存しました。その一部:

# name: test_invoice_fixed_clock
  dict({
    'currency': 'INR',
    'generated_at': '2026-11-12T00:00:00+00:00',
    'lines': list([
      dict({
        'price': 20.0,
        'qty': 2,
        'sku': 'PEN',
      }),
      ...
    ]),
    'total': 106.2,
  })

このファイルは期待どおりの結果になっているので、コードのように確認してください。 106.2は正しいですか? 20 のペン 2 本と 50 のインク 1 つで 90、90 に 18% の税金がかかると 106.2 になりますので、そうです。この 1 回限りのチェックは、スナップショット テストが依存する瞬間です。テストでファイルをコミットします。

コード変更はどのようなものになるか

次に、レシート内の 1 つの単語 TOTAL を Total に変更し、テストを再度実行しました。

E       AssertionError: assert [+ received] == [- snapshot]
E         - TOTAL          90.00
E         + Total          90.00
1 snapshot failed. 2 snapshots passed.

diff は変更された正確な行を指しました。変更が意図されていた場合は、スナップショットを更新します。そうでない場合は、そのラベルに関するアサーションを一度も書くことなく回帰を捉えたことになります。これにより、スナップショットは、レシート、CSV エクスポート、API ペイロードなど、他のシステムが解析する出力に役立ちます。私たちの 回帰テスト チェックリスト は、そのようなチェックが他に当てはまる箇所をカバーしています。

タイムスタンプ、ID、その他の変動部分

render_invoice を実際のクロックでスナップショットするテストを追加しました。スナップショットの作成時には成功しましたが、次の実行時には失敗しました。

E         -   'generated_at': '2026-11-12T15:12:34.206809+00:00',
E         +   'generated_at': '2026-11-12T15:12:35.621553+00:00',
1 snapshot failed.

時間、ランダム ID、UUID、メモリ アドレス、順序なしセットなど、実行間で値が変化すると、スナップショットは役に立たなくなります。 2 つの修正を使用しましたが、両方とも確実に合格しました。

  • 入力を制御します: test_invoice_fixed_clock と同様に、固定クロックを渡します。これが最もクリーンなオプションです。
  • フィールドをマスクします: syrupy の path_type マッチャーは 'generated_at': str に保存され、型のみをチェックします。

また、順序が重要でないリストをソートし、ランダムなデータをシードします。 テスト データ生成ガイドでは、生成されたデータを再現可能にする方法を説明しています。

ヒント: コードを変更せずに再実行したときにスナップショットが失敗した場合は、不安定なテストとして扱います。移動する値を見つけて固定します。スナップショットを再生成するだけではありません。

スナップショットを安全に更新する

update コマンドは、最良の機能でもあり最悪の機能でもあります。意図した変更を安価に行うことができ、不注意な承認も安価に行うことができます。良い習慣:

  • 最初に差分を読み取ることなく、更新フラグを実行して「CI を緑色にする」ことは絶対に行わないでください。
  • スナップショットの変更をその原因となったコードと同じプル リクエストでコミットすると、レビュー担当者は両方を見ることができます。
  • スナップショットは小さくしてください。 2,000 行のスナップショットの差分はレビューされず、スキミングされます。
  • 古いスナップショットを削除します。 syrupy が報告し、テストを削除したときに 1 つを削除しました。
  • CI では、更新フラグを指定せずに実行すると、新しいスナップショットまたは変更されたスナップショットは書き込まれずに失敗します。

スナップショットテストが役立つ場合

  • 手書きのアサーションが長くなる大規模で構造化された出力: API 応答、レポート、構成ジェネレーター。
  • テストがほとんどないコードのリファクタリング。まず現在の動作のスナップショットを作成し、次にリファクタリングして何も変わっていないことを確認します。
  • シリアライザとフォーマッタ。変更が重要である可能性があります。
  • ユーザーまたはスクリプトが依存するエラー メッセージと CLI 出力。

他のチームと共有する API ペイロードの場合は、スナップショットとスキーマ チェックを組み合わせます。 API コントラクト テスト ガイドでは、コントラクト側について説明しています。

スナップショットテストが苦痛な場合

  • 設計により出力が頻繁に変更される場合。継続的な更新により、チームは読まなくても承認することができます。
  • ロジックが重要な場合。税金ルールには、スナップショット内の行ではなく、名前付きの期待値を使用した明示的なアサーションが必要です。
  • スナップショットが巨大な場合。誰もそれらをレビューしないため、正しい動作と同じくらい簡単にバグが閉じ込められます。
  • 固定環境で実行しない限り、フォントとレンダリングが異なるマシン間での視覚的なスナップショットの場合。

Jest、Vitest、およびビジュアルスナップショット

JavaScript では、Jest と Vitest は expect(value).toMatchSnapshot() を使用し、-u で更新します。 インライン スナップショットも提供します。保存された値はテスト ファイル自体に書き込まれ、レビュー中に小さなスナップショットが表示されたままになります。 Playwright チュートリアル で紹介されているように、Playwright はスクリーンショットを toHaveScreenshot() と比較します。ここではこれらを実行しませんでしたが、上記と同じ作成、比較、更新サイクルに従います。

スナップショットレビューのチェックリスト

  1. 新しいスナップショットには期待する値が含まれていますか?少なくとも 1 回は手作業でチェックされていますか?
  2. diff 内の変更されたすべての行は、意図したコード変更と一致していますか?
  3. マスクされていないタイムスタンプ、ID、ランダム値はありますか?
  4. スナップショットは 1 分で読めるほど小さいですか?
  5. 明示的なアサーションは重要なルールをより明確に表現しますか?

まとめ

スナップショット テストは、大規模な出力における予期せぬ変更を迅速に検出する方法です。私たちのデモでは両方の側面が示されました。1 つの単語の変更は正確な diff で捕捉され、マスクされていないタイムスタンプは次の実行時にテストを中断しました。スナップショットを小さく保ち、移動する値を固定またはマスクし、すべての更新を確認し、最も重要なルールには明示的なアサーションを使用します。

よくある質問

スナップショットテストとは何ですか?

正常に実行されたことがわかっているコードの出力を保存し、出力が変化するとその後の実行は失敗し、差分が表示されます。正しさを証明するのではなく、変化を検出します。

スナップショットを更新するにはどうすればよいですか?

ツールの更新コマンド (syrupy の場合は –snapshot-update を指定した pytest または jest -u など) を実行します。まず差分を読み取り、コードを変更して新しいスナップショットをコミットします。

スナップショット テストが実行のたびに失敗するのはなぜですか?

出力には、タイムスタンプ、ランダム ID、または順序付けされていないデータなどの変化する値が含まれます。固定クロックを渡したり、ランダム性をシードしたり、リストを並べ替えたり、マッチャーでそれらのフィールドをマスクしたりします。

スナップショット テストは良いのか悪いのか?

これらは大規模な構造化出力やリファクタリングには役立ちますが、巨大な場合やレビューなしで更新される場合には有害です。重要なビジネス ルールには明示的なアサーションを使用します。

スナップショット テストとビジュアル テストの違いは何ですか?

データ スナップショットには、テキストまたはシリアル化された値が保存されます。ビジュアル テストではスクリーンショットを保存し、ピクセルを比較します。これにより、レイアウトやスタイルの変更も検出されますが、環境により敏感になります。

学び続ける

Stack Quoraと連携する

テスト、WordPress、または SEO についてサポートが必要ですか?

私たちは、チームがより優れたソフトウェアを出荷し、サイトを成長させるのを支援します。あなたが取り組んでいることを教えてください。明確な次のステップを提案します。

読み続けてください

詳しいガイドはこちら テスト、AI、最新の開発

この記事は気に入りましたか?トピックを選択して、最新のチュートリアルに直接アクセスしてください。

人工知能

BM25 の説明: Python コードとハイブリッド検索を使用してキーワード検索で結果をランク付けする方法

BM25 は、私たちが実行した純粋な Python 実装を使って説明しました。数式、IDF、用語飽和、k1 および b パラメーター、生の単語数を超える理由、失敗する場所、および相互ランク融合によるハイブリッド検索がどのようにそれを修正するかについて説明しました。

記事を読む →
ソフトウェア開発

HTTP メソッドの説明: GET、POST、PUT、PATCH、DELETE、ライブサーバーでテスト済み

私たちが実行した小規模サーバーで説明した HTTP メソッド: GET、POST、PUT、PATCH、DELETE、HEAD および OPTIONS、安全かべき等か、PUT か PATCH、それぞれが返すステータス コード、405 エラー、および API 設計のためのチートシート。

記事を読む →
DevOps

Git Bisect の説明: コードを壊したコミットを手動または自動で見つける

Git bisect について、テスト済みのリポジトリを使って説明します。5 回のテスト実行中 41 件の中から 1 つの悪いコミットを見つけ、git bisect run で自動化し、終了コード 125 でテスト不可能なコミットをスキップし、カスタム用語を使用して安全にクリーンアップします。

記事を読む →
テスト自動化

pytest マーカーの説明: カスタム マーク、skip、skipif、xfail、および -m フィルター

pytest マーカーをテスト済みスイートで説明します。カスタム マークを登録し、-m でスモーク テストのみを実行し、and または not でフィルターを組み合わせ、skip、skipif、xfail を正しく使用し、–strict-markers でマーカーのタイプミスを停止します。

記事を読む →
ソフトウェアテスト

陽性テストと陰性テスト: 違い、24 の実際のテスト ケース、およびチェックリスト

実際のサインアップ フォームで説明される陽性テストと陰性テスト: pytest で実行される 6 つの陽性テスト ケースと 18 の陰性テスト ケース、陰性テストでキャッチされた欠落ガード、比較表、テクニック、チェックリスト。

記事を読む →
データベースとSQL

SQL ORDER BY 複数列: ASC、DESC、NULLS LAST、Case および Custom Order

テストされたクエリで説明された複数の列を含む SQL ORDER BY: ASC と DESC の混合、タイ ブレーカー、NULL FIRST と LAST、大文字と小文字を区別しない並べ替え、CASE を使用したカスタム順序、テキストとして保存された数値とインデックスの使用。

記事を読む →
データベースとSQL

SQL 累計: SUM OVER、グループごとの合計、移動合計、および RANGE トラップ

SUM() OVER を使用して SQL 現在の合計を計算する方法: グループごとの合計、毎日の累積合計、移動合計、合計のパーセント、RANGE 対 ROWS タイ トラップ、NULL、および古いサブクエリ メソッドに対する 360 倍の速度テスト。

記事を読む →
ソフトウェア開発

JavaScript 配列の並べ替え: 数値、オブジェクト、文字列、および 10 が 5 の前に来る理由

JavaScript で配列を正しくソートする方法: 比較関数を使用した数値、1 つ以上のフィールドによるオブジェクト、localeCompare を使用した文字列、日付、自然ソート、toSorted、安定性と速度、すべて Node 24 でテスト済み。

記事を読む →
人工知能

RAG チャンキング戦略の説明: 固定、オーバーラップ、センテンス、再帰および見出し、測定

tiktoken 0.14 を使用した 1 つのドキュメントでの RAG チャンク戦略の比較: 固定サイズ、オーバーラップ、センテンス パッキング、再帰的分割、見出しベースのチャンク、分割ファクト、孤立見出し、ストレージ コストの測定。

記事を読む →
ソフトウェア開発

API 冪等性の説明: 冪等性キーと安全な再試行、テスト済み

API 冪等性は、私たちが実行した Python サーバーとクライアントで説明されました。応答が失われたため、キーなしでは二重請求、キーありでは単一請求が発生し、さらにキーの再利用、同時再試行、ストレージ ルールが発生しました。

記事を読む →
DevOps

Git Stash の説明: 保存、適用、ポップ、および追跡されていないファイルのテスト済み

Git stash について、Git 2.56 で実行したコマンドを使用して説明しました。メッセージ付きのプッシュ、追跡されていないファイル、リストと表示、適用とポップ、インデックスの保持、競合、スタッシュ ブランチ、ドロップとクリアです。

記事を読む →
ソフトウェアテスト

ペアごとのテストの説明: オールペアによって 216 個のテストが 13 個に削減される方法 (テスト済み)

ペアワイズ テストについては、Python 3.13 で実行したジェネレーターで説明しました。13 のテストでカバーされる 216 の組み合わせのチェックアウト、検証済みのカバレッジ、より大きな例、およびペアワイズで見逃される可能性がある 3 方向のバグです。

記事を読む →
テスト自動化

テストダブルの説明: ダミー、スタブ、スパイ、モック、フェイク、テスト済みの Python コード

テスト ダブルについて、pytest 9.2 で実行される Python の例 (ダミー、スタブ、スパイ、モック、フェイク)、それぞれをいつ使用するか、状態と動作のチェック、およびプレーン モックが隠したバグを autospec がどのようにキャッチするかを説明します。

記事を読む →
データベースとSQL

SQL COALESCE の説明: デフォルト、NULLIF、IFNULL と ISNULL およびトラップ、テスト済み

SQL COALESCE では、SQLite 3.50 で実行したクエリ、つまり最初の非 null 値、空の文字列、数学における NULL、ゼロ除算の NULLIF、集計、LEFT JOIN ギャップ、IFNULL と ISNULL について説明しました。

記事を読む →
データベースとSQL

SQL 自己結合の説明: 従業員とマネージャー、ペアと行の比較、テスト済み

SQL 自己結合については、SQLite 3.50 で実行したクエリで説明しました。従業員とマネージャー、マネージャー以上の収入、一意のペア、日々の変化、2 ホップ チェーン、インデックス作成です。

記事を読む →
ソフトウェア開発

JavaScript スプレッド演算子の説明: スプレッドと残り、コピーと落とし穴、テスト済み

JavaScript スプレッド演算子については、ノード 24 で実行したコード (配列、オブジェクト、浅いコピー、残りのパラメーター、Math.max 制限、reduce のパフォーマンス トラップ) で説明しました。

記事を読む →
ソフトウェア開発

Python コレクション モジュールの説明: Counter、defaultdict、deque など、テスト済み

Python コレクションは、Python 3.13 で実行したコード (Counter、defaultdict、deque、namedtuple、OrderedDict、ChainMap) を使用して説明されています。さらに、list と deque のタイミングとチートシートも含まれています。

記事を読む →
人工知能

LLM コンテキスト ウィンドウの説明: トークン、制限、およびさらに適合させる方法、測定

LLM コンテキスト ウィンドウは、tiktoken を使用して測定したトークン数で説明されています。散文、コード、ヒンディー語の単語とトークン、入出力の予算、チャット履歴のトリミング、RAG のチャンク化とコストです。

記事を読む →
ソフトウェア開発

Webhook の説明: Webhook の仕組みと安全に受信する方法

Webhook について、Python で実行した受信側と送信側で説明しました。プッシュとポーリング、HMAC-SHA256 署名、改ざんおよび再実行されたリクエストの拒否、バックオフによる再試行、冪等性、およびテストのヒントです。

記事を読む →
DevOps

Git Cherry-Pick の説明: 必要なコミットを安全にコピーし、テスト済み

Git チェリーピックでは、Git 2.56 で実行したコマンド、つまりリリース ブランチへのホットフィックスのコピー、新しいハッシュとパッチ ID、-x、-n、コミット範囲、競合、–abort、–skip、およびその後のマージについて説明しました。

記事を読む →
テスト自動化

スナップショット テストの説明: 仕組み、役立つ場合と問題となる場合

スナップショットのテストについては、私たちが実行した pytest と syrupy のデモで説明しました。スナップショットの作成、コード変更後の diff の読み取り、タイムスタンプのマスク、安全な更新、スナップショットが役立つ場合と有害な場合について説明しました。

記事を読む →
ソフトウェアテスト

突然変異テストの説明: 100% のカバー率でもバグを見逃す理由

ミューテーション テストについては、私たちが構築して実行した小さなミューテーション ツールで説明しました。14 個のミュータント、79% のスコアを獲得した 100% のライン カバレッジのテスト スイート、100% に達した境界テスト、さらにツール、コスト、CI ヒントです。

記事を読む →
人工知能

プロンプト インジェクションの説明: AI アプリがどのように騙されるのか、そしてどのように防御するのか

ビルダー向けに説明されたプロンプト インジェクション: 直接攻撃と間接攻撃、キーワード フィルターが失敗する理由 (テストでは 4 つのうち 1 つがブロックされました)、最小権限、ツール許可リスト、出力チェックなどの多層防御。

記事を読む →
DevOps

DNS レコードの説明: A、AAAA、CNAME、MX、TXT、TTL と実際のルックアップ

DNS レコードは、実行したルックアップで説明されています。解決の仕組み、A と AAAA、CNAME ルール、MX と null MX、SPF と検証のための TXT、NS、TTL とキャッシュ、安全な DNS 変更です。

記事を読む →
DevOps

機能フラグの説明: 安全なリリース、段階的なロールアウト、およびフラグの衛生状態

私たちが実行したロールアウト シミュレーションで説明された機能フラグ: フラグの種類、安定したハッシュを使用したパーセンテージ ロールアウト、キル スイッチ、許可リスト、両方のパスのテスト、フラグの負債とベスト プラクティス。

記事を読む →
テスト自動化

Python Faker を使用したテストデータ生成: 現実的で再現性のある安全なデータ

Python Faker でデータ生成をテストし、実行して測定します。再現可能なデータ、ロケール、一意の値、ドメイン形状のレコード、Faker がミスするエッジ ケースのシード、本番データと速度のマスキング。

記事を読む →
ソフトウェアテスト

シフトレフト テストの説明: チームの作業を遅らせることなくバグを早期に発見する

シフトレフト テストについて説明しました。その意味、初期不良の方が安い理由、要件レビューから CI チェックまでの実践、テスターの役割の変化、シフトライト、メトリクス、展開計画について説明します。

記事を読む →
データベースとSQL

SQL 文字列関数の説明: TRIM、SUBSTR、REPLACE、CONCAT、およびデータ クリーンアップ

SQL 文字列関数を実行したクエリとともに説明しました。連結と NULL、TRIM、UPPER と LOWER、SUBSTR と INSTR、REPLACE、パディング、Unicode 長さ、乱雑なデータのクリーニング、方言の違いなどです。

記事を読む →
データベースとSQL

SQL トリガーの説明: BEFORE トリガーと AFTER トリガー、監査ログ、および落とし穴

SQL トリガーについて、実行したトリガーを使用して説明します: BEFORE と AFTER、OLD と NEW、監査ログ、検証、ストック更新、WHEN 条件、ロールバック、方言の違い、およびそれらを回避するタイミング。

記事を読む →
ソフトウェア開発

Python JSON モジュールの説明: ダンプ、ロード、カスタム タイプ、および一般的なエラー

Python JSON モジュールでは、ダンプとロード、ファイル、型変換、日付と小数点、カスタム エンコーダー、object_hook、float 精度、解析エラー、JSON 行など、実行したコードを使用して説明しました。

記事を読む →
ソフトウェア開発

ES モジュールと CommonJS: Node.js での JavaScript インポートの動作 (テスト済み)

ES モジュールと CommonJS について、Node.js で実行したコード (インポートおよびエクスポート構文、require、ライブ バインディング、キャッシュ、トップレベルの待機、動的インポート、ファイル拡張子、相互運用) を使用して説明しました。

記事を読む →
ソフトウェア開発

Python 正規表現の説明: パターン、グループ、先読みと落とし穴、テスト済み

Python 正規表現は、検索と一致、findall、グループと名前付きグループ、貪欲と遅延、サブ、先読み、フラグ、Unicode のサプライズ、壊滅的なバックトラッキングなど、実行したパターンで説明しました。

記事を読む →
人工知能

LLM 構造化出力の説明: AI モデルから信頼性の高い JSON を取得する

LLM 構造化出力は、Pydantic で実行した検証とともに説明されています。JSON モードとスキーマ、制約付きデコード、モデル出力が中断される方法、再試行ループ、セマンティック チェックです。

記事を読む →
DevOps

SSH キーの説明: 仕組み、ssh-keygen、Ed25519、および安全な習慣

SSH キーについて、私たちが生成したキーとともに説明しました: 公開キーと秘密キー、ssh-keygen、Ed25519 と RSA、指紋、パスフレーズ、ssh-agent、authorized_keys、構成ファイル、GitHub、およびキーの衛生状態。

記事を読む →
DevOps

HTTP キャッシュの説明: ライブ テストによるキャッシュ制御、ETag、および 304 レスポンス

HTTP キャッシュについて、私たちが実行した小規模サーバーで説明しました。キャッシュ制御ディレクティブ、最大有効期間、キャッシュなしとストアなし、ETag の再検証と 304 応答、CDN、キャッシュ無効化とヘッダーのテストです。

記事を読む →
テスト自動化

API コントラクトのテストの説明: 重大な変更を出荷前に把握する

API contract testing explained with a schema check we ran: what a contract is, consumer-driven contracts, Pact, OpenAPI, which changes break consume…

記事を読む →
ソフトウェアテスト

リスクベースのテストの説明: リスクをスコアリングし、マトリックスを構築し、重要なものをテストする

リスクベースのテストについて段階的に説明します。リスクの特定、可能性と影響のスコアリング、リスク マトリックスの構築、テストの深さへのリスクのマッピング、実際の例とよくある間違いです。

記事を読む →
データベースとSQL

SQL 制約の説明: NOT NULL、UNIQUE、CHECK、および FOREIGN KEY、テスト済み

SQL 制約について、実行したテストで説明しました。NOT NULL、UNIQUE、CHECK、DEFAULT、PRIMARY、FOREIGN KEY、NULL の抜け穴、SQLite の外部キー設定、名前付け制約とそれらのテストです。

記事を読む →
データベースとSQL

SQL 日付関数の説明: バグのない日付の追加、比較、グループ化

SQL の日付関数を、実行したクエリで説明しました。間隔の追加、月末のサプライズ、日付の違い、BETWEEN トラップ、日別のグループ化、タイム ゾーン、インデックス、方言の違いなどです。

記事を読む →
ソフトウェア開発

Python asyncio の説明: リアル タイミングでの async、await、gather、および TaskGroup

Python asyncio は、コルーチン、await、gather、TaskGroup、エラー処理、タイムアウト、同時実行の制限、パフォーマンスを損なうブロッキングコールの間違いなど、時間を測定したコードで説明しました。

記事を読む →
ソフトウェア開発

JavaScript におけるデバウンスとスロットル: それぞれの仕組み、いつ使用するか、テスト済み

JavaScript でのデバウンスとスロットルについて、Node.js で測定したタイミングを使用して説明します。それぞれの仕組み、単純な実装、先頭と末尾の呼び出し、実際の使用例とテストです。

記事を読む →
ソフトウェア開発

Python コンテキスト マネージャーの説明: with ステートメント、contextlib、および実際の使用法

Python コンテキスト マネージャーは、実行したコードを使用して説明しました。仕組み、__enter__ と __exit__、contextlib.contextmanager、suppress、ExitStack、データベース トランザクション、およびよくある間違いについて説明しました。

記事を読む →
人工知能

LLM 温度と Top-p の説明: AI モデルが次の単語を選択する方法

LLM 温度と top-p は、私たちが実行したシミュレーションで説明しました。確率がどのように再形成されるか、top-p が保持するもの、タスク別の推奨設定、決定論、AI 機能のテストです。

記事を読む →
DevOps

YAML の説明: 構文、ノルウェー問題、テストしたその他の罠

YAML は、基本構文、リストとマップ、ノルウェー問題、浮動小数点数に変換されるバージョン、8 進郵便番号、60 進数、アンカー、複数行テキスト、安全な読み込みなどのパーサー テストで説明されています。

記事を読む →
DevOps

Cron ジョブの説明: 構文、実際のスケジュール、およびそれらを壊す間違い

Cron ジョブは、検証したスケジュールとともに説明されています。5 つのフィールド、演算子、実際の例、月日または曜日のトラップ、環境の問題、ロギング、重複、タイム ゾーンです。

記事を読む →
人工知能

AI 幻覚の説明: 言語モデルが物事をでっち上げる理由とそれを軽減する方法

AI 幻覚について説明しました。幻覚とは何か、言語モデルが幻覚を生成する理由、一般的な種類、グラウンディングとプロンプトで幻覚を軽減する方法、そして私たちが実行した簡単なチェックです。

記事を読む →
DevOps

環境変数の説明: .env ファイル、シークレット、および設定が正しく行われている

実行した Python の例を使用して環境変数について説明します。環境変数の読み取りと設定、すべての値が文字列である理由、.env ファイル、プロセスの継承、シークレット、検証について説明します。

記事を読む →
ソフトウェア開発

API レート制限の説明: アルゴリズム、ヘッダー、および 429 エラーの処理

API レート制限については、実行したシミュレーションで説明します。トークン バケット、固定ウィンドウ、スライディング ウィンドウ、429 応答、レート制限ヘッダー、バックオフによる再試行、およびテスト制限です。

記事を読む →
テスト自動化

Python でのモッキング:unittest.mock、patch、およびテストを嘘にする間違い

Python でのunittest.mockによるモック、テスト済み: モックとreturn_value、side_effect、名前が使用されている場所のパッチ、仕様と自動仕様、日付のモック、およびよくある間違い。

記事を読む →
ソフトウェアテスト

コードカバレッジの説明: 回線カバレッジとブランチカバレッジ、および 100% の実際の意味

実際のcoverage.pyの実行でコードカバレッジを説明: 行、分岐、条件のカバレッジ、レポートの読み取り、100%のカバレッジでもバグを見逃す可能性がある理由、および賢明なターゲット。

記事を読む →
データベースとSQL

SQL における DELETE、TRUNCATE、DROP: 違い、ロールバック、およびそれぞれをいつ使用するか

DELETE、TRUNCATE、DROP について、テスト済み SQL を使用して説明します。それぞれの削除内容、ロールバック、トリガー、ID リセット、速度、PostgreSQL、MySQL、SQL Server、SQLite の違いについて説明します。

記事を読む →
データベースとSQL

SQL ビューの説明: 作成、使用、落とし穴の回避、例を示します

SQL ビューについて、実行したクエリとともに説明しました。ビューの作成、ライブ結果、列の非表示、パフォーマンス、更新可能なビューと具体化されたビュー、壊れた依存関係、ベスト プラクティスについて説明します。

記事を読む →
ソフトウェア開発

TypeScript インターフェイスと型: 実際の違い、コンパイラでテスト

TypeScript インターフェイスと型、実際のコンパイラでチェック: 両方でできること、片方だけでできること、宣言のマージ、拡張と交差、および従うべき簡単なルール。

記事を読む →
ソフトウェア開発

Python *args と **kwargs の説明: 柔軟な関数と明確な例

Python の *args と **kwargs について、実行したコードで説明しました。パッキングとアンパッキング、パラメーターの順序、キーワードのみの引数と位置のみの引数、デコレーター、一般的なエラーです。

記事を読む →
ソフトウェア開発

Python Lambda 関数: 構文、実際の用途、および使用すべきでない場合

Python のラムダ関数について、実行したコードとともに説明します。構文、キーによるソート、マップとフィルター、クロージャー、遅延バインディング トラップ、通常の def がより適切な選択である場合。

記事を読む →
人工知能

AIエージェントとは何ですか?シンプルなエージェント ループを実行できる仕組み

AIエージェントとは何ですか?エージェント ループ、ツール、メモリ、ガードレール、実行した小さな Python ループ、実際のリスク、およびシンプルなチャットボットがより良い選択である場合についてのわかりやすいガイドです。

記事を読む →
DevOps

モニタリングと可観測性: ログ、メトリクス、トレースによる本当の違い

モニタリングと可観測性について説明: 既知および未知の障害、ログ、メトリクスとトレース、チェックアウト インシデントのウォークスルー、ゴールデン シグナル、OpenTelemetry、および便利なアラート。

記事を読む →
DevOps

Docker ボリュームとバインド マウント: コンテナ データを正しい方法で保持する

Docker ボリュームとバインド マウントについて説明します。コンテナ データが消える理由、名前付きボリューム、バインド マウント、tmpfs、Compose の例、バックアップ、アクセス許可、およびそれぞれをいつ使用するかについて説明します。

記事を読む →
テスト自動化

TDD と BDD: 主な違い、1 つの機能が両方の方法で構築され、それぞれをいつ使用するか

TDD と BDD は、両方の方法で構築された 1 つの割引機能で説明されています。実行したコードによるレッド-グリーン-リファクタリング、Given-When-Then シナリオ、ツール、トレードオフ、およびそれぞれをいつ使用するかです。

記事を読む →
ソフトウェアテスト

ユーザー受け入れテスト (UAT): プロセス、チェックリスト、および実際の例

ユーザー受け入れテストの説明: 誰が実行するか、QA との違い、7 段階のプロセス、UAT テスト ケース テンプレート、チェックリスト、サインオフ基準、およびよくある間違い。

記事を読む →
データベースとSQL

SQL NULL 値の説明: IS NULL、COALESCE、NULLIF、および回避すべきトラップ

SQL の NULL 値について、実行したクエリで説明しました。3 つの値のロジック、IS NULL、COALESCE、NULLIF、集計、結合、並べ替えでの NULL の扱い方、およびそれが密かに引き起こすバグです。

記事を読む →
データベースとSQL

SQL CASE WHEN ステートメント: 構文、実際の例、およびよくある間違い

SQL CASE WHEN では、単純な検索フォーム、条件順序、SUM を使用したピボット、COUNT トリック、カスタム並べ替え、更新、回避すべき NULL トラップなど、実行したクエリを使用して説明しました。

記事を読む →
ソフトウェア開発

JWTとは何ですか? JSON Web トークンを実際の例で説明する

JWTとは何ですか? JSON Web トークンについて説明しました。3 つの部分、実行したコード内で構築および改ざんされたトークン、JWT とセッション、ストレージ、リフレッシュ トークン、およびセキュリティ上の間違いです。

記事を読む →
ソフトウェア開発

JavaScript イベントループの説明: コールスタック、マイクロタスク、タイマーと例

JavaScript イベント ループについて、実行したコードで説明しました。コール スタック、タスク キュー、マイクロタスク キュー、setTimeout 0 が即時ではない理由、ブロッキング、スターベーション、およびインタビュー クイズです。

記事を読む →
ソフトウェア開発

Python ジェネレーターと収量の説明: 実際の例でメモリを節約する

Python ジェネレーターと Yield について、実行したコードを使用して説明します。一時停止と再開の方法、メモリ節約の測定、パイプライン、無限シーケンス、Yield from、send、および一般的なトラップについて説明します。

記事を読む →
人工知能

埋め込みとは何ですか?ベクトルとコサインの類似度を簡単に説明

埋め込みとは何ですか?ベクトル、コサイン類似度、セマンティック検索に関する平易なガイド。私たちが実行した小さな例、一般的な使用法、モデルの選択、既知の制限が含まれています。

記事を読む →
DevOps

Blue-Green デプロイメントと Canary デプロイメント: 違い、トレードオフ、および選択方法

ブルー グリーン デプロイメントとカナリア デプロイメントについて説明: それぞれの仕組み、コスト、リスクとロールバック、テストした安定したユーザー バケット化、データベース移行、ローリング アップデート、および選択方法。

記事を読む →
テスト自動化

不安定なテスト: 問題の原因とそれを永久に修正する方法

不安定なテストについては、私たちが実行したデモを使用して説明しました。主な原因、確認および診断する方法、タイミングの適切な修正、共有された状態と日付、隔離プロセスなどです。

記事を読む →
ソフトウェアテスト

負荷テストとストレス テスト: 違い、メトリクス、および k6 の例

ロード テストとストレス テストについて説明します。それぞれが何を証明するか、スパイク テストとソーク テスト、重要な指標、平均値が誤解を招く理由、K6 の例、テストの計画方法について説明します。

記事を読む →
ソフトウェアテスト

テスト ケースとテスト シナリオ: 主な違い、例、およびそれぞれをいつ使用するか

テスト ケースとテスト シナリオの説明: 明確な定義、並べて表、シナリオからケースへの 1 つのパスワード リセット機能、テンプレート、およびそれぞれをいつ使用するか。

記事を読む →
データベースとSQL

SQL クエリの最適化: 実行プランを読み取り、タイミングを考慮して遅いクエリを修正

SQL クエリの最適化は 100 万行でテストされています。実行プランの読み取り、適切なインデックスの追加、検索対象外のフィルターの修正、複合インデックスとキーセットのページネーションの使用。

記事を読む →
データベースとSQL

SQL UNION と UNION ALL: 違い、例、テストされたパフォーマンス

SQL UNION と UNION ALL について、実行したクエリで説明しました。重複、両方に従うルール、実際のデータのバグ、測定されたパフォーマンス、INTERSECT と EXCEPT、およびそれぞれをいつ使用するかについて説明します。

記事を読む →
ソフトウェア開発

JavaScript Fetch API チュートリアル: GET、POST、エラー処理、タイムアウト

ローカル サーバーに対してテストされた JavaScript Fetch API チュートリアル: GET と POST、404 がスローされない理由、再利用可能なヘルパー、クエリ文字列、タイムアウト、CORS、およびよくある間違い。

記事を読む →
ソフトウェア開発

Python ファイル処理: 読み取り、書き込み、CSV、JSON、パスライブラリと例

Python のファイル処理について、実行したコードで説明します。オープン モード、大きいファイルの読み取り、CSV、JSON、パスライブラリ、バイナリ ファイル、安全な書き込み、エラー処理、およびよくある間違いについて説明します。

記事を読む →
ソフトウェア開発

Python のクラスとオブジェクト: 実際の例を含む OOP チュートリアル

Python のクラスとオブジェクトについて、実行したコードとともに説明します: __init__、メソッド、クラスとインスタンスの属性、継承、プロパティ、ダンダー メソッド、データクラス、およびよくある間違い。

記事を読む →
人工知能

大規模言語モデルとは何ですか? LLM の仕組みを誇大広告なしで説明

大規模言語モデルとは何ですか? LLM は、トークン、エンベディング、アテンション、トレーニング、温度およびコンテキスト ウィンドウ、小さな次の単語のデモ、実際の制限など、平易な言葉で説明されています。

記事を読む →
DevOps

初心者のための Linux コマンド: 例を含む基本ターミナル ガイド

初心者向けの Linux コマンド。ナビゲーション、ファイル、ログの表示、grep、パイプ、権限、プロセス、アーカイブなどのタスク別にグループ化されており、実用的なログ分析の例も含まれています。

記事を読む →
テスト自動化

Selenium と Playwright: 主な違い、コードの比較、どちらを選択するか

Selenium と Playwright の比較: アーキテクチャ、待機、ブラウザと言語のサポート、デバッグ、両方のツールでの同じテスト、移行のアドバイスと選択方法。

記事を読む →
ソフトウェアテスト

等価性分割: テスト設計手法を実際の例で説明

等価性パーティション化について説明しました。有効なパーティションと無効なパーティションを見つける方法、年齢、パスワード、クーポンに関する実際の例、実行したテスト、境界と組み合わせる理由。

記事を読む →
ソフトウェアテスト

ソフトウェアテストにおける重大度と優先度: 相違点、マトリックス、および実際の例

ソフトウェア テストにおける重大度と優先度について説明します。明確な定義、例を含む 4 方向のマトリックス、レベル スケール、それぞれの設定者、バグ トリアージの実行方法。

記事を読む →
データベースとSQL

SQL サブクエリのチュートリアル: 型、相関サブクエリ、および EXISTS と例

実行したクエリを含む SQL サブクエリのチュートリアル: スカラー、IN、FROM、SELECT サブクエリ、相関サブクエリ、EXISTS、NOT IN NULL トラップ、サブクエリ対 JOIN 対 CTE。

記事を読む →
データベースとSQL

SQL トランザクションと ACID の説明: COMMIT、ROLLBACK、分離レベル

SQL トランザクションと ACID について、実行した銀行振込で説明しました。COMMIT、ROLLBACK、セーブポイント、ロック、分離レベル、ダーティ リード、デッドロック、ベスト プラクティスについて説明します。

記事を読む →
ソフトウェア開発

Git コマンドのチートシート: 実際に使用するコマンドと例

実際のデモ リポジトリからの出力を含む、タスク別にグループ化された Git コマンド チート シート (セットアップ、ステージング、ブランチ、リモート、スタッシュ、履歴、間違いの取り消し)。

記事を読む →
ソフトウェア開発

JavaScript Promise の説明: then、catch、Promise.all、およびよくある間違い

JavaScript の Promise を、実行したコードで説明します。ステート、then および catch チェーン、エラー処理、Promise.all、allSettled、race および any、イベント ループ、およびよくある間違いです。

記事を読む →
ソフトウェア開発

Python 辞書チュートリアル: メソッド、例、一般的なパターン

私たちが実行したコードを含む Python 辞書チュートリアル: 辞書の作成、読み取り、更新、主要なメソッド、マージ、内包表記、パターンのカウントとグループ化、およびよくある間違い。

記事を読む →
人工知能

RAGとは何ですか?検索拡張生成を実際の例で説明する

RAGとは何ですか?検索拡張生成について、インデックス作成、チャンク化、埋め込み、検索、実際に動作する小さな Python の例、評価、一般的な失敗など、ステップごとに説明します。

記事を読む →
DevOps

初心者向け Terraform チュートリアル: 最初のファイルからモジュールまでのコードとしてのインフラストラクチャ

初心者向けの Terraform チュートリアル: クラウド アカウントなしで開始し、初期化、計画、適用を学び、次に変数、出力、状態、モジュール、安全なチーム ワークフローを学びます。

記事を読む →
DevOps

Docker と Kubernetes: 主な違い、連携方法、どちらが必要か

Docker と Kubernetes について説明しました。それぞれの機能、同じアプリを両方で実行すること、Docker Compose と Swarm の比較、dockershim の変更、必要なものを決定する方法などです。

記事を読む →
テスト自動化

初心者向けの Pytest チュートリアル: フィクスチャ、パラメータ化、実際の例

pytest 9.2 で実行したテストを含む初心者向けの pytest チュートリアル: アサーション、フィクスチャ、parametrize、conftest、マーカー、tmp_path、monkeypatch、便利なフラグ、CI。

記事を読む →
ソフトウェアテスト

ソフトウェア テスト ライフ サイクル (STLC): 6 つのフェーズ、開始基準と終了基準、例

ソフトウェア テストのライフ サイクルについては、開始基準と終了基準を含む 6 つの STLC フェーズ、成果物、実際に動作するログイン機能の例、STLC と SDLC、およびアジャイルにおける STLC について説明しました。

記事を読む →
ソフトウェア開発

Git mergeとrebaseの違い:例と使い分け

Git mergeとrebaseの違いを、実際のログ出力、比較表、rebaseの黄金律、安全なチームワークフローで解説します。

記事を読む →
ソフトウェア開発

Pythonのリスト内包表記:構文・例・使うべきでない場面

Pythonのリスト内包表記を解説:構文、フィルタ、if-else、ネストしたループ、実測した処理時間、そして通常のforループの方が良い場面。

記事を読む →
データベースとSQL

SQL JOINを例で解説(Inner・Left・Right・Full)

サンプルのテーブルとクエリでSQL JOINを順に解説。INNER、LEFT、RIGHT、FULL、CROSS、SELFに加え、よくある間違いとパフォーマンスのコツも紹介します。

記事を読む →