uber/prototoolArchived
Prototool
Prototool est une boîte à outils de développement pour Protocol Buffers qui fournit une suite d'outils pour le linting, le formatage et la génération de code à partir de fichiers de schéma. Il fonctionne comme un système pour gérer le cycle de vie des définitions Protocol Buffer via une interface en ligne de commande.
La boîte à outils se distingue en fournissant un détecteur de changements cassants qui compare différentes versions de définitions pour identifier les changements incompatibles au niveau du fil ou de la source. Elle inclut également une interface client gRPC capable d'invoquer des points de terminaison en utilisant des requêtes JSON en compilant dynamiquement les définitions Protobuf.
Le projet couvre de larges domaines de capacités incluant la validation de schéma et l'application de style, la génération de stubs de code spécifiques au langage et la gestion automatisée des binaires de compilateur. Il fournit également des utilitaires pour l'exportation de jeux de descripteurs de fichiers et la génération de fichiers de schéma avec du boilerplate automatisé.
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.
