Matcher Overview

GripMock's matcher determines which stub responds to an incoming gRPC request based on input data and headers.

Core Concepts

Concept	Description
Matching Logic	AND/OR composition, anyOf semantics, ignoreArrayOrder
Input	Match against request body fields
Headers	Match against gRPC metadata/headers

Quick Reference

input:
  equals:       # exact match (AND)
  contains:     # partial match (AND)
  matches:      # regex match (AND)
  anyOf:        # OR alternatives
  ignoreArrayOrder: true

headers:
  # same structure

Matching Flow

1. Fast Path: Exact equals matches are checked first
2. Full Match: contains, matches, and anyOf are evaluated
3. Ranking: Multiple matches are scored by specificity
4. Priority: Explicit priority overrides scoring

Examples

Exact match:

input:
  equals:
    user_id: "123"

Flexible match:

input:
  contains:
    name: "john"
  matches:
    email: "@company\\.com$"

OR conditions:

input:
  equals:
    role: "admin"
  anyOf:
    - equals:
        department: "engineering"
    - matches:
        team: "^platform-"

Related

• Stub Priority
• Schema Reference