SharpPortico.Cli 1.3.0-preview.1

SharpPortico.Cli

Command-line companion for the SharpPortico OpenAPI → gRPC source generator.

A preview/validation tool that runs the generator's own mapping pipeline over your OpenAPI 3.0/3.1 spec (YAML or JSON) and reports what SharpPortico would generate — service name, namespace, proto package, RPC surface, protobuf message and enum counts — and, with --out, writes the .proto descriptor the generator embeds as {Service}Proto.Text. The actual C# code generation happens at compile time via the source generator.

dotnet tool install -g SharpPortico.Cli --version 1.3.0-preview.1

# What the mapping makes of the spec
sharpportico generate openapi/petstore.yaml

# And the contract a build of it would ship
sharpportico generate openapi/petstore.yaml --out contracts/

The descriptor is not a second, hand-written rendering of the spec: it comes from the emitter the generator itself calls and is LF-normalized exactly as the {Service}Proto.Text const holds it, so what you review — or hand to protoc, to a client generator, or to a colleague — is the contract a build of the same spec produces. The diagnostics are the generator's own, with the ids and messages the compiler reports: SP1002 says a 3.1 document was read through the 3.0 rewrite, and SP1003 names each construct the mapping widened and what it became.

Every sample spec's descriptor is compiled by protoc in CI (.github/scripts/check-protos.sh), which is the check for what the C# compiler never reads — a name protoc rejects or an import left out of the descriptor.

📖 Full documentation & samples: SharpPortico on GitHub

License

MIT — see LICENSE. Copyright (c) 2026 MPCoreDeveloper.