uber/prototoolArchived
Prototool
Prototool 是一个 Protocol Buffers 开发工具包，提供了一套用于对 schema 文件进行 lint 检查、格式化和代码生成的工具。它通过命令行界面管理 Protocol Buffer 定义的生命周期。
该工具包的特色在于提供了一个破坏性变更检测器，通过比较不同版本的定义来识别线路或源代码层面的不兼容变更。它还包含一个 gRPC 客户端接口，能够通过动态编译 Protobuf 定义来使用 JSON 请求调用端点。
该项目涵盖了广泛的功能领域，包括 schema 验证和样式强制执行、特定语言的代码存根生成以及自动化的编译器二进制文件管理。它还提供了用于导出文件描述符集和自动生成样板 schema 文件的实用程序。
Features
- Breaking Change Detectors - Identifies wire and source incompatible changes by comparing serialized FileDescriptorSets between different versions of definitions.
- Protobuf Code Generators - Produces language-specific source code and file descriptor sets from Protocol Buffer definitions.
- Protobuf Formatters - Standardizes the layout of schema files by alphabetizing imports and applying consistent spacing.
- Protobuf Linters - Analyzes schema files against configurable rule groups to enforce naming conventions and structural requirements.
- Protobuf Style Rules - Provides static analysis of Protobuf schemas to enforce naming conventions and structural rules via AST traversal.
- API Specification Breaking Change Detectors - Compares different versions of Protobuf definitions to identify incompatible changes that could break service clients.
- Protobuf Stub Generators - Generates language-specific client and server stubs from Protocol Buffer interface definitions.
- Multi-Language Code Generators - Transforms schema definitions into source code for various languages using managed compiler versions.
- Protobuf Code Generators - Generates language-specific source code from Protobuf definitions using a configuration-driven template mapping.
- Style Enforcement Strategies - Validates schema files against a set of rules for naming, ordering, and structure to ensure consistency.
- JSON-to-gRPC Translation - Enables calling gRPC endpoints using JSON requests by dynamically compiling Protobuf definitions.
- Protobuf Syntax Validation - Validates schema files by compiling them without output stubs to ensure syntax correctness.
- Binary Cache Managers - Manages the downloading and caching of specific compiler binaries and type definitions to ensure consistent builds.
- Binary Process Wrappers - Wraps the official Protocol Buffer compiler to manage its installation and execution across different environments.
- Compiler Binary Management - Buf CLI & Automation downloads, caches, and updates the schema compiler and type definitions automatically or via configuration.
- gRPC Command-Line Clients - Provides a command-line interface for invoking gRPC methods and inspecting service definitions using JSON.
- Interactive Clients - Enables sending JSON requests to gRPC servers by dynamically compiling Protobuf files.
- gRPC API Testing - Sends JSON requests to gRPC endpoints by dynamically compiling Protobuf files to validate server behavior.
- Protocol Buffer Tools - Integrated suite for compiling, linting, and formatting Protobuf files.
