Skip to content

testing.md

Latest commit

 

History

History
121 lines (98 loc) · 4.73 KB

testing.md

File metadata and controls

121 lines (98 loc) · 4.73 KB
Raw

Testing and Performance

简体中文 | Docs Index

Required Checks

GOWORK=off GOTOOLCHAIN=local go test ./... -count=1
GOWORK=off GOTOOLCHAIN=local go vet ./...
gofmt -l .
git diff --check

Focused Behavior Checks

Run focused tests while working on a small behavior change:

GOWORK=off GOTOOLCHAIN=local go test ./... -run 'TestName' -count=1

Discovered Test Entry Points

This inventory is generated from the current _test.go files in this repository. It is intentionally complete so documentation review can catch stale test, benchmark, fuzz, and example coverage when code changes.

Total discovered entry points: 62.

Tests (60)

  • TestApplyUpgradeHeadersAddsH2CHeaders
  • TestCompressorCompressesAcceptedResponseStream
  • TestConnectionControllerAppliesAndValidatesSettings
  • TestConnectionControllerAppliesReceiveWindowUpdate
  • TestConnectionControllerEnforcesMaxConcurrentRemoteStreams
  • TestConnectionControllerEnforcesReceiveConnectionWindow
  • TestConnectionControllerRejectsNewLocalStreamAfterGoAway
  • TestConnectionControllerRejectsPushWhenPeerDisabled
  • TestControlFrameLimitEncoderRejectsUnflushedControlFrames
  • TestDataChunkedInputEmitsEmptyEndStream
  • TestDataChunkedInputSplitsByteBufIntoDataFrames
  • TestDataCompressingInputStreamsHTTP2DataFrames
  • TestDecompressorDecodesGzipDataFrame
  • TestEncodeDecodeHTTP2SettingsHeader
  • TestFrameDecoderDecodesPayloadZeroCopy
  • TestFrameEncoderCoalescesHeaderAndPayload
  • TestFrameEncoderWritesHeaderThenPayload
  • TestHeaderCodecRoundTripWithContinuation
  • TestHeaderDecoderRejectsContinuationWithoutHeaders
  • TestHeadersBlockFromRequestBuildsPseudoHeadersFirst
  • TestMaxRstFrameDecoderExpiresWindow
  • TestMaxRstFrameDecoderRejectsRstFlood
  • TestOutboundFlowControllerAppliesInitialWindowSettings
  • TestOutboundFlowControllerPassesDataWithinWindow
  • TestOutboundFlowControllerQueuesDataUntilWindowUpdate
  • TestPrefaceDecoderConsumesFragmentedPrefaceAndForwardsRemainingFrame
  • TestPrefaceEncoderWritesClientPrefaceOnActive
  • TestRequestFromHeadersBlockMapsPseudoHeaders
  • TestResponseBridgeMapsStatus
  • TestSettingsAckHandlerAcknowledgesPeerSettingsAndFiresEvent
  • TestSettingsAckHandlerDoesNotAckAck
  • TestSettingsAckHasNoPayload
  • TestStreamBufferingEncoderDrainsOnSettingsIncrease
  • TestStreamBufferingEncoderDrainsWhenActiveStreamCloses
  • TestStreamBufferingEncoderRejectsQueueOverflow
  • TestStreamChildHandlerBindsOutboundStreamID
  • TestStreamChildHandlerClosesChildOnRST
  • TestStreamChildHandlerRoutesInboundFramesToChild
  • TestStreamChildRejectsMismatchedStreamID
  • TestStreamFrameToHTTPObjectCodecClientInboundDataAndTrailers
  • TestStreamFrameToHTTPObjectCodecOutboundResponseWithBody
  • TestStreamFrameToHTTPObjectCodecServerInboundEndStream
  • TestStreamMultiplexerAcceptsDecodedHeadersBlock
  • TestStreamMultiplexerAllowsServerResponseOnClientStream
  • TestStreamMultiplexerAppliesWindowUpdate
  • TestStreamMultiplexerClosesAfterBothHalfCloses
  • TestStreamMultiplexerEmitsStreamLifecycleEvents
  • TestStreamMultiplexerRejectsOutboundFlowControlViolation
  • TestStreamMultiplexerRejectsWrongLocalStreamParity
  • TestStreamStateTransitions
  • TestTypedFrameDecoderAcceptsEmptyPayloadFrames
  • TestTypedFrameDecoderParsesHeadersWithPriority
  • TestTypedFrameDecoderReleasesInvalidFrameOnce
  • TestTypedFrameDecoderRetainsUnknownFramePayload
  • TestTypedFrameEncoderKeepsDataPayloadZeroCopy
  • TestTypedFrameEncoderReleasesFrameOnWriteError
  • TestTypedFrameEncoderWritesSettingsFrame
  • TestWeightedFairQueueDistributorHonorsWeights
  • TestWeightedFairQueueDistributorPropagatesWriterError
  • TestWeightedFairQueueDistributorSkipsInactiveStreams

Benchmarks (1)

  • BenchmarkStreamMultiplexerReadData

Fuzz Targets (1)

  • FuzzHTTP2FramePipeline

Examples (0)

  • No Example functions are currently declared.

Race Checks

GOWORK=off GOTOOLCHAIN=local go test -race ./... -count=1

Race checks are most valuable for core, transport, handler, resolver, observability, examples, and benchmark modules. Platform-specific transports may require native host capabilities.

Benchmarks

GOWORK=off GOTOOLCHAIN=local go test ./... -run '^$' -bench . -benchmem -benchtime=1s -count=5

Report ns/op, B/op, allocs/op, throughput, and p99 latency separately. Include host and OS details with every result.

Pressure Testing

Pressure tests should run against a realistic assembled stack. Use gnalloy.org/benchmarks for repeatable matrices and gnalloy.org/examples for runnable clients. Keep warmup and measurement phases separate.

CI

The repository validation workflow runs formatting, tests, and vet on Linux, macOS, and Windows for pushes and pull requests.