Skip to content

resolveGoResponses

reference
1 min readUpdated

Kind: Function

Source: atloria-monorepo/libs/parser-core/src/techdocs/cross-file-routes.ts

Document what a Go handler writes, against the structs the parse produced.

The Go parser records EVIDENCE — a swaggo @Success type, a composite literal, the call whose result was written — because none of it can be resolved from one file: the handler, the serializer method and the struct that states the shape are conventionally three different files in the same package.

Everything here fails closed. A name that matches no struct in the parse, a handler that two packages both declare, a gin.H{…} with one value that cannot be named: the endpoint keeps no response at all. An invented body is worse than a missing one — a reader can see that nothing is documented, but cannot see that something documented is false.

Signature

ts
function resolveGoResponses(entities: Entity[]): number

Parameters

NameType
entitiesEntity[]

Returns: number

Was this page helpful?

Download as PDF