hemmer-provider-generator-parser 0.1.2

Multi-format parsers for cloud SDK specifications (Smithy, OpenAPI, Discovery, Protobuf)
Documentation

SDK parsing for cloud provider definitions

This crate handles parsing of various cloud provider SDK definitions into an intermediate representation (ServiceDefinition).

Parsing Strategy

Spec-Based Parsing (Recommended)

  • AWS: Parse Smithy JSON AST from github.com/aws/api-models-aws
  • Kubernetes: Parse OpenAPI 3.0 specs from API server
  • GCP: Parse Discovery Documents from googleapis.com or gRPC FileDescriptorSet
  • Azure: Parse OpenAPI specs from github.com/Azure/azure-rest-api-specs
  • gRPC: Parse Protocol Buffer FileDescriptorSet from .proto files or gRPC reflection

Legacy Parsing

For AWS SDK for Rust, we parse the published crate structure:

  • operation::* modules contain Input/Output types for each operation
  • types::* module contains data types used by operations

Operations are grouped by resource and mapped to CRUD:

  • CreateX, PutX → Create
  • GetX, DescribeX, HeadX → Read
  • UpdateX, ModifyX, PutX → Update
  • DeleteX, RemoveX → Delete