ktr0731/evans
Evans
Evans is a gRPC client and API explorer designed for testing, debugging, and automating remote procedure calls. It functions as an interactive client and a stateless command line utility for executing gRPC methods and inspecting remote server API surfaces.
The tool provides specialized support for the gRPC-Web protocol to facilitate communication with web-based implementations. It enables the discovery of services and message structures through server reflection or definition files, and supports the management of unary, client-side, server-side, and bidirectional streaming communication.
The project covers request management through custom metadata headers and the handling of complex field types such as arrays, enums, and base64-encoded bytes. It utilizes JSON-based representations for input and output to allow for machine-readable results and file-based request automation.
Features
- gRPC Command-Line Clients - Ships a stateless command line utility for executing gRPC methods with custom metadata and JSON output.
- Interactive Remote Method Execution - Provides an interactive interface for executing gRPC methods and inspecting services using definition files or reflection.
- gRPC - Provides an interactive environment to list services, describe message structures, and inspect the API surface of remote gRPC servers.
- API Inspection Tools - Allows listing available services, methods, and message structures from a remote server via runtime introspection.
- API Request Execution from CLI - Provides a command line interface for running requests that accept input from files and output results as JSON.
- Interactive Command Line Interfaces - Maintains a stateful session for navigating service hierarchies and executing remote procedure calls.
- Streaming Lifecycle Management - Manages the flow of client-side, server-side, and bidirectional streaming communication.
- Method Invocation - Enables sending requests to remote gRPC methods to retrieve data or trigger actions.
- Reflection Services - Determines API surface by querying the server for its own service definitions and message structures at runtime.
- gRPC Service Discovery - Discovers available methods and message structures of a remote server using server reflection or definition files.
- Schema and Reflection Exploration - Enables listing available services and methods or describing message structures using server reflection or definition files.
- gRPC API Testing - Enables testing and debugging gRPC services by sending requests and inspecting responses through an interactive client.
- Client-Side gRPC-Web Integration - Interacts with web-based remote procedure call implementations using the gRPC-Web protocol for browser-compatible communication.
- Client-Side Request Support - Provides the ability to send requests using the gRPC-Web protocol to interact with web-based remote procedure call implementations.
- JSON Message Serializers - Serializes internal message structures to JSON for human-readable input and output display.
- Complex Field Type Handling - Supports specialized input fields including arrays for repeated values, enums for selections, and base64-encoded bytes.
- Dynamic Request Payloads - Builds request payloads at runtime based on schema definitions to allow flexible input for complex field types.
- Asynchronous Stream Handling - Manages asynchronous request and response sequences to support unary, client-side, server-side, and bidirectional streaming.
- Wire Format Mapping - Translates user input into gRPC-Web or standard gRPC wire formats for transmission to remote servers.
- gRPC Stream Testing - Tests and manages the data flow for client-side, server-side, and bidirectional streaming remote procedure calls.
- Request Header Configuration - Provides tools for adding, removing, and displaying custom metadata headers within remote procedure call requests.
- gRPC-Web Clients - Implements specialized support for the gRPC-Web protocol to facilitate communication with web-based RPC implementations.
- Distributed Systems - Universal gRPC client.
- Command Line Tools - Expressive universal CLI client for gRPC.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
