uber/prototoolArchived
Prototool
Prototool es un kit de herramientas de desarrollo para Protocol Buffers que proporciona un conjunto de herramientas para linting, formateo y generación de código a partir de archivos de esquema. Funciona como un sistema para gestionar el ciclo de vida de las definiciones de Protocol Buffer a través de una interfaz de línea de comandos.
El kit de herramientas se distingue por proporcionar un detector de cambios disruptivos (breaking change detector) que compara diferentes versiones de definiciones para identificar cambios incompatibles en la red o en el código fuente. También incluye una interfaz de cliente gRPC capaz de invocar endpoints utilizando solicitudes JSON mediante la compilación dinámica de definiciones Protobuf.
El proyecto cubre amplias áreas de capacidad, incluyendo validación de esquemas y aplicación de estilos, generación de stubs de código específicos para cada lenguaje y gestión automatizada de binarios del compilador. También proporciona utilidades para la exportación de conjuntos de descriptores de archivos y la generación de archivos de esquema con boilerplate automatizado.
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.
