Skip to content

examples.md

Latest commit

 

History

History
58 lines (41 loc) · 2.15 KB

examples.md

File metadata and controls

58 lines (41 loc) · 2.15 KB
Raw

Examples

简体中文 | Docs Index

Example 1: Add the Module to an Application

mkdir gnalloy-app && cd gnalloy-app
go mod init example.com/gnalloy-app
go get gnalloy.org/handler-timeout@dev
go doc gnalloy.org/handler-timeout

Example 2: Inspect Current Packages

The current source tree exposes these package import paths:

  • gnalloy.org/handler-timeout

Use go doc against the package that matches the behavior you need:

go doc gnalloy.org/handler-timeout

Selected current exported entry points:

  • var ErrReadTimeout = errors.New("gnalloy/handler/timeout: read timeout") ...
  • type IdleState uint8
  • type IdleStateEvent struct{ ... }
  • type IdleStateHandler struct{ ... }
  • type ReadTimeoutHandler struct{ ... }
  • type WriteTimeoutHandler struct{ ... }

Example 3: Use Executable Tests as Behavioral Examples

Repository tests are executable examples of supported behavior. Start with the selected names below, then read the matching _test.go files for complete setup and assertions. See Testing and Performance for the complete discovered list.

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

Selected current test, benchmark, fuzz, and example entry points:

  • TestIdleStateHandlerFiresReaderIdle
  • TestIdleStateHandlerReschedulesOnRead
  • TestReadTimeoutHandlerClosesChannel

Example 4: Cross-Module Assembly

Direct Gnalloy dependencies for this module:

  • gnalloy.org/gnalloy

Assembly guidance:

  • Use this handler inside a Gnalloy pipeline to apply policy, lifecycle, protection, logging, metrics, or traffic behavior.
  • Keep protocol parsing in codec modules and socket ownership in transport modules.
  • Place the handler where its inbound and outbound semantics match the selected protocol stack.

Example 5: Pressure-Test Harness

For sustained load, wire this module into a scenario under gnalloy.org/benchmarks or a runnable client under gnalloy.org/examples when the module participates in network traffic. Record host, OS, CPU, Go version, protocol, payload, concurrency, warmup, repetitions, throughput, and p99 latency in the report.