CodeSampleX

샘플

github.com/caddyserver/caddy/v2 v2.11.4: caddy.ParseNetworkAddress requires single-slash network prefixes and leading colons for port-only addresses, parsing bare numbers as hostnames with port 0.

검증된 샘플 — golang github.com/caddyserver/caddy/v2 v2.11.4: caddy.ParseNetworkAddress requires single-slash network prefixes and leading colons for port-only…

sha256:26d7a22ad0a41327766bd4c63ce797d8491e71f27b23e43ff0a0e8d96ea56bdf

이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다. 통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다. MIT-0

실행 증거

선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.

증거 기준
서명된 컨트랙트 통과
검증 영수증
2
빌드한 서명 키
1
선언된 환경 go linux x64 go go go

검증 실행 환경

환경 컨트랙트 단계 실행일
go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 FAIL compile:SKIPPED · contract:FAIL · load:SKIPPED · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18

케이스

HOW
목표
caddy.ParseNetworkAddress requires single-slash network prefixes and leading colons for port-only addresses, parsing bare numbers as hostnames with port 0.
패키지
심벌
  • caddy.ParseNetworkAddress
환경
go
생성일
2026-08-18T01:22:37Z

컨트랙트

  1. caddy.ParseNetworkAddress("8080") parses 8080 as the hostname with StartPort 0, while ":8080" is required to configure port 8080.
  2. caddy.ParseNetworkAddress("tcp://localhost:2019") splits on the first slash and sets Network to "tcp:" with a trailing colon and Host to "/localhost".
  3. caddy.ParseNetworkAddress("unix/data/socket.sock") sets Network to "unix" and Host to "data/socket.sock" with IsUnixNetwork true and StartPort 0.
  4. caddy.ParseNetworkAddress("localhost:8080-8085") parses a contiguous port range where StartPort is 8080, EndPort is 8085, and PortRangeSize is 6.
  5. caddy.ParseNetworkAddress("localhost:8085-8080") fails with "end port must not be less than start port".
  6. caddy.ParseNetworkAddress("localhost:99999") fails with a port value out of range error.
  7. caddy.ParseNetworkAddressWithDefaults("localhost", "tcp", 2019) applies the default port to return host "localhost" with StartPort 2019.

파일

  • NOTES.md
  • csx.json
  • go.mod
  • go.sum
  • network_address_test.go

소스 아티팩트 내려받기 (tar.gz)

소스

NOTES.md
# Network Address Configuration in Caddy v2

## Search Results
An initial query for `github.com/caddyserver/caddy/v2` returned no existing verified solutions or contracts for Caddy network address parsing in the cache.

## Pinned Release
- `github.com/caddyserver/caddy/v2` pinned to `v2.11.4` (Go 1.26 module).

## Observed Behaviour and Failure Modes

Caddy configures listen endpoints, admin API interfaces, and upstream addresses via `caddy.ParseNetworkAddress` and `caddy.ParseNetworkAddressWithDefaults`. The address parser expects a specialized `[network/][host]:[port[-port]]` format that diverges significantly from common standard URI schemas and naive port conventions:

1. **Bare Numbers vs. Port Definitions (Silent Failure)**:
   - When a configuration specifies `"8080"` expecting to bind to port 8080 on all interfaces, `caddy.ParseNetworkAddress("8080")` parses `"8080"` as the `Host` string with `StartPort: 0` and `EndPort: 0` instead of port 8080.
   - This parses without error at configuration load time, but causes the listener to attempt binding port 0 on a host named `"8080"`.
   - Binding to port 8080 across all interfaces requires an explicit leading colon: `":8080"`, which correctly sets `Host: ""` and `StartPort: 8080`.

2. **URI Scheme Format vs. Single-Slash Prefix (Runtime Failure)**:
   - When supplying standard URI syntax like `"tcp://localhost:2019"`, the parser splits strictly on the first forward slash (`/`).
   - Consequently, the network name is extracted as `"tcp:"` (retaining the colon) and the host is extracted as `"/localhost"` (retaining the leading slash).
   - This unmarshals without syntax error at parse time, but downstream `net.Listen` calls fail because `"tcp:"` is not a recognized Go network protocol.
   - Caddy's single-slash prefix convention `"tcp/localhost:2019"` properly yields `Network: "tcp"`, `Host: "localhost"`, and `StartPort: 2019`.

3. **Unix Domain Sockets**:
   - Unix socket paths are designated using the `"unix/"` prefix (e.g., `"unix/data/socket.sock"`), setting `Network: "unix"`, `Host: "data/socket.sock"`, and `IsUnixNetwork() == true` with `StartPort: 0`.

4. **Port Ranges and Validation**:
   - Contiguous port ranges such as `"localhost:8080-8085"` are supported, yielding `StartPort: 8080`, `EndPort: 8085`, and `PortRangeSize() == 6`.
   - Inverted port ranges (such as `"localhost:8085-8080"`) fail immediately with `"end port must not be less than start port"`.
   - Out-of-bounds ports (> 65535, such as `"localhost:99999"`) fail immediately during integer parsing.
csx.json
{"case":{"believed":"A bare numeric address like \"8080\" configures listening port 8080, and URI schemes like \"tcp://localhost:2019\" parse as standard TCP addresses.","caseId":"case:sha256:0cf06eace5b64a4665baaa11eaa45642a304b3e4347310014e24df5241615a0b","contract":["caddy.ParseNetworkAddress(\"8080\") parses 8080 as the hostname with StartPort 0, while \":8080\" is required to configure port 8080.","caddy.ParseNetworkAddress(\"tcp://localhost:2019\") splits on the first slash and sets Network to \"tcp:\" with a trailing colon and Host to \"/localhost\".","caddy.ParseNetworkAddress(\"unix/data/socket.sock\") sets Network to \"unix\" and Host to \"data/socket.sock\" with IsUnixNetwork true and StartPort 0.","caddy.ParseNetworkAddress(\"localhost:8080-8085\") parses a contiguous port range where StartPort is 8080, EndPort is 8085, and PortRangeSize is 6.","caddy.ParseNetworkAddress(\"localhost:8085-8080\") fails with \"end port must not be less than start port\".","caddy.ParseNetworkAddress(\"localhost:99999\") fails with a port value out of range error.","caddy.ParseNetworkAddressWithDefaults(\"localhost\", \"tcp\", 2019) applies the default port to return host \"localhost\" with StartPort 2019."],"goal":"caddy.ParseNetworkAddress requires single-slash network prefixes and leading colons for port-only addresses, parsing bare numbers as hostnames with port 0.","kind":"HOW","packages":["pkg:golang/github.com/caddyserver/caddy/v2@v2.11.4"],"schemaVersion":1,"symbols":["caddy.ParseNetworkAddress"]},"contractCommand":["go","test","./..."],"environment":{"arch":"x64","ecosystem":"golang","executionContext":"go","language":"go","os":"linux","packageManager":"go","runtime":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/caddyserver/caddy/v2@v2.11.4"],"schemaVersion":1,"symbols":["caddy.ParseNetworkAddress"],"verifierAdapter":"golang@1"}
go.mod
module test

go 1.26.5

require github.com/caddyserver/caddy/v2 v2.11.4

require (
	github.com/beorn7/perks v1.0.1 // indirect
	github.com/caddyserver/certmagic v0.25.3 // indirect
	github.com/caddyserver/zerossl v0.1.5 // indirect
	github.com/cespare/xxhash/v2 v2.3.0 // indirect
	github.com/google/uuid v1.6.0 // indirect
	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
	github.com/libdns/libdns v1.1.1 // indirect
	github.com/mholt/acmez/v3 v3.1.6 // indirect
	github.com/miekg/dns v1.1.72 // indirect
	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
	github.com/prometheus/client_golang v1.23.2 // indirect
	github.com/prometheus/client_model v0.6.2 // indirect
	github.com/prometheus/common v0.67.5 // indirect
	github.com/prometheus/procfs v0.20.1 // indirect
	github.com/quic-go/qpack v0.6.0 // indirect
	github.com/quic-go/quic-go v0.59.1 // indirect
	github.com/zeebo/blake3 v0.2.4 // indirect
	go.uber.org/multierr v1.11.0 // indirect
	go.uber.org/zap v1.28.0 // indirect
	go.uber.org/zap/exp v0.3.0 // indirect
	go.yaml.in/yaml/v2 v2.4.4 // indirect
	golang.org/x/crypto v0.52.0 // indirect
	golang.org/x/mod v0.35.0 // indirect
	golang.org/x/net v0.55.0 // indirect
	golang.org/x/sync v0.20.0 // indirect
	golang.org/x/sys v0.45.0 // indirect
	golang.org/x/term v0.43.0 // indirect
	golang.org/x/text v0.37.0 // indirect
	golang.org/x/time v0.15.0 // indirect
	golang.org/x/tools v0.44.0 // indirect
	google.golang.org/protobuf v1.36.11 // indirect
)
go.sum
code.pfad.fr/check v1.1.0 h1:GWvjdzhSEgHvEHe2uJujDcpmZoySKuHQNrZMfzfO0bE=
code.pfad.fr/check v1.1.0/go.mod h1:NiUH13DtYsb7xp5wll0U4SXx7KhXQVCtRgdC96IPfoM=
github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=
github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
github.com/caddyserver/caddy/v2 v2.11.4 h1:XKxkMTgNSizEvKG6QHue6cAsFOteU2qA61w2tKkCWi0=
github.com/caddyserver/caddy/v2 v2.11.4/go.mod h1:zXCl032uTaF5/TpgU38axqFD41jqzxomTDNqK7BzMeI=
github.com/caddyserver/certmagic v0.25.3 h1:mGf5ba8F7xA4c5jfDZZbK2buY1VEkbnwpMDixaju94A=
github.com/caddyserver/certmagic v0.25.3/go.mod h1:YVs43D5+H/Dckt4bTga1KSO/xYfFBfVZainGDywYPAA=
github.com/caddyserver/zerossl v0.1.5 h1:dkvOjBAEEtY6LIGAHei7sw2UgqSD6TrWweXpV7lvEvE=
github.com/caddyserver/zerossl v0.1.5/go.mod h1:CxA0acn7oEGO6//4rtrRjYgEoa4MFw/XofZnrYwGqG4=
github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/go-jose/go-jose/v4 v4.1.4 h1:moDMcTHmvE6Groj34emNPLs/qtYXRVcd6S7NHbHz3kA=
github.com/go-jose/go-jose/v4 v4.1.4/go.mod h1:x4oUasVrzR7071A4TnHLGSPpNOm2a21K9Kf04k1rs08=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y=
github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
github.com/letsencrypt/challtestsrv v1.4.2 h1:0ON3ldMhZyWlfVNYYpFuWRTmZNnyfiL9Hh5YzC3JVwU=
github.com/letsencrypt/challtestsrv v1.4.2/go.mod h1:GhqMqcSoeGpYd5zX5TgwA6er/1MbWzx/o7yuuVya+Wk=
github.com/letsencrypt/pebble/v2 v2.10.0 h1:Wq6gYXlsY6ubqI3hhxsTzdyotvfdjFBxuwYqCLCnj/U=
github.com/letsencrypt/pebble/v2 v2.10.0/go.mod h1:Sk8cmUIPcIdv2nINo+9PB4L+ZBhzY+F9A1a/h/xmWiQ=
github.com/libdns/libdns v1.1.1 h1:wPrHrXILoSHKWJKGd0EiAVmiJbFShguILTg9leS/P/U=
github.com/libdns/libdns v1.1.1/go.mod h1:4Bj9+5CQiNMVGf87wjX4CY3HQJypUHRuLvlsfsZqLWQ=
github.com/mholt/acmez/v3 v3.1.6 h1:eGVQNObP0pBN4sxqrXeg7MYqTOWyoiYpQqITVWlrevk=
github.com/mholt/acmez/v3 v3.1.6/go.mod h1:5nTPosTGosLxF3+LU4ygbgMRFDhbAVpqMI4+a4aHLBY=
github.com/miekg/dns v1.1.72 h1:vhmr+TF2A3tuoGNkLDFK9zi36F2LS+hKTRW0Uf8kbzI=
github.com/miekg/dns v1.1.72/go.mod h1:+EuEPhdHOsfk6Wk5TT2CzssZdqkmFhf8r+aVyDEToIs=
github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=
github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
github.com/prometheus/client_golang v1.23.2 h1:Je96obch5RDVy3FDMndoUsjAhG5Edi49h0RJWRi/o0o=
github.com/prometheus/client_golang v1.23.2/go.mod h1:Tb1a6LWHB3/SPIzCoaDXI4I8UHKeFTEQ1YCr+0Gyqmg=
github.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk=
github.com/prometheus/client_model v0.6.2/go.mod h1:y3m2F6Gdpfy6Ut/GBsUqTWZqCUvMVzSfMLjcu6wAwpE=
github.com/prometheus/common v0.67.5 h1:pIgK94WWlQt1WLwAC5j2ynLaBRDiinoAb86HZHTUGI4=
github.com/prometheus/common v0.67.5/go.mod h1:SjE/0MzDEEAyrdr5Gqc6G+sXI67maCxzaT3A2+HqjUw=
github.com/prometheus/procfs v0.20.1 h1:XwbrGOIplXW/AU3YhIhLODXMJYyC1isLFfYCsTEycfc=
github.com/prometheus/procfs v0.20.1/go.mod h1:o9EMBZGRyvDrSPH1RqdxhojkuXstoe4UlK79eF5TGGo=
github.com/quic-go/qpack v0.6.0 h1:g7W+BMYynC1LbYLSqRt8PBg5Tgwxn214ZZR34VIOjz8=
github.com/quic-go/qpack v0.6.0/go.mod h1:lUpLKChi8njB4ty2bFLX2x4gzDqXwUpaO1DP9qMDZII=
github.com/quic-go/quic-go v0.59.1 h1:0Gmua0HW1Tv7ANR7hUYwRyD0MG5OJfgvYSZasGZzBic=
github.com/quic-go/quic-go v0.59.1/go.mod h1:upnsH4Ju1YkqpLXC305eW3yDZ4NfnNbmQRCMWS58IKU=
github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
github.com/zeebo/assert v1.1.0 h1:hU1L1vLTHsnO8x8c9KAR5GmM5QscxHg5RNU5z5qbUWY=
github.com/zeebo/assert v1.1.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
github.com/zeebo/blake3 v0.2.4 h1:KYQPkhpRtcqh0ssGYcKLG1JYvddkEA8QwCM/yBqhaZI=
github.com/zeebo/blake3 v0.2.4/go.mod h1:7eeQ6d2iXWRGF6npfaxl2CU+xy2Fjo2gxeyZGCRUjcE=
github.com/zeebo/pcg v1.0.1 h1:lyqfGeWiv4ahac6ttHs+I5hwtH/+1mrhlCtVNQM2kHo=
github.com/zeebo/pcg v1.0.1/go.mod h1:09F0S9iiKrwn9rlI5yjLkmrug154/YRW6KnnXVDM/l4=
go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
go.uber.org/mock v0.5.2 h1:LbtPTcP8A5k9WPXj54PPPbjcI4Y6lhyOZXn+VS7wNko=
go.uber.org/mock v0.5.2/go.mod h1:wLlUxC2vVTPTaE3UD51E0BGOAElKrILxhVSDYQLld5o=
go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
go.uber.org/multierr v1.11.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
go.uber.org/zap v1.28.0 h1:IZzaP1Fv73/T/pBMLk4VutPl36uNC+OSUh3JLG3FIjo=
go.uber.org/zap v1.28.0/go.mod h1:rDLpOi171uODNm/mxFcuYWxDsqWSAVkFdX4XojSKg/Q=
go.uber.org/zap/exp v0.3.0 h1:6JYzdifzYkGmTdRR59oYH+Ng7k49H9qVpWwNSsGJj3U=
go.uber.org/zap/exp v0.3.0/go.mod h1:5I384qq7XGxYyByIhHm6jg5CHkGY0nsTfbDLgDDlgJQ=
go.yaml.in/yaml/v2 v2.4.4 h1:tuyd0P+2Ont/d6e2rl3be67goVK4R6deVxCUX5vyPaQ=
go.yaml.in/yaml/v2 v2.4.4/go.mod h1:gMZqIpDtDqOfM0uNfy0SkpRhvUryYH0Z6wdMYcacYXQ=
go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
golang.org/x/crypto v0.52.0 h1:RMs7fP2rXdep0CftQlK8Uf+kibLm7qkCcradZWYz988=
golang.org/x/crypto v0.52.0/go.mod h1:1QgfPxDqh0T2M/elOJtp9RvuR95kVjir0e6/BvEmGbc=
golang.org/x/mod v0.35.0 h1:Ww1D637e6Pg+Zb2KrWfHQUnH2dQRLBQyAtpr/haaJeM=
golang.org/x/mod v0.35.0/go.mod h1:+GwiRhIInF8wPm+4AoT6L0FA1QWAad3OMdTRx4tFYlU=
golang.org/x/net v0.55.0 h1:bcvxaJn3e1U6InsFWt1JUq1aSjnRxLzT2rtD2KfkDF8=
golang.org/x/net v0.55.0/go.mod h1:L5U2KuzuOe1lY7Z+aWVIKK6qEeJXnXV9yzGA+WCHJww=
golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
golang.org/x/sys v0.45.0 h1:dO4czNzziLiiXplLQgBCEpCvXQ3dnkn0SdaZSYdQ+FY=
golang.org/x/sys v0.45.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
golang.org/x/term v0.43.0 h1:S4RLU2sB31O/NCl+zFN9Aru9A/Cq2aqKpTZJ6B+DwT4=
golang.org/x/term v0.43.0/go.mod h1:lrhlHNdQJHO+1qVYiHfFKVuVioJIheAc3fBSMFYEIsk=
golang.org/x/text v0.37.0 h1:Cqjiwd9eSg8e0QAkyCaQTNHFIIzWtidPahFWR83rTrc=
golang.org/x/text v0.37.0/go.mod h1:a5sjxXGs9hsn/AJVwuElvCAo9v8QYLzvavO5z2PiM38=
golang.org/x/time v0.15.0 h1:bbrp8t3bGUeFOx08pvsMYRTCVSMk89u4tKbNOZbp88U=
golang.org/x/time v0.15.0/go.mod h1:Y4YMaQmXwGQZoFaVFk4YpCt4FLQMYKZe9oeV/f4MSno=
golang.org/x/tools v0.44.0 h1:UP4ajHPIcuMjT1GqzDWRlalUEoY+uzoZKnhOjbIPD2c=
golang.org/x/tools v0.44.0/go.mod h1:KA0AfVErSdxRZIsOVipbv3rQhVXTnlU6UhKxHd1seDI=
google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
network_address_test.go
package main

import (
	"strings"
	"testing"

	"github.com/caddyserver/caddy/v2"
)

func TestParseNetworkAddress_BareNumberVersusColon(t *testing.T) {
	// A bare number "8080" is parsed as Host="8080" with port 0, NOT port 8080.
	addrBare, err := caddy.ParseNetworkAddress("8080")
	if err != nil {
		t.Fatalf("unexpected error parsing bare number: %v", err)
	}
	if addrBare.Host != "8080" {
		t.Errorf("expected Host to be %q, got %q", "8080", addrBare.Host)
	}
	if addrBare.StartPort != 0 || addrBare.EndPort != 0 {
		t.Errorf("expected StartPort and EndPort to be 0 for bare host, got start=%d end=%d", addrBare.StartPort, addrBare.EndPort)
	}
	if addrBare.Network != "tcp" {
		t.Errorf("expected default Network to be %q, got %q", "tcp", addrBare.Network)
	}

	// Configuring port 8080 without a hostname requires a leading colon ":8080".
	addrPort, err := caddy.ParseNetworkAddress(":8080")
	if err != nil {
		t.Fatalf("unexpected error parsing :8080: %v", err)
	}
	if addrPort.Host != "" {
		t.Errorf("expected Host to be empty string, got %q", addrPort.Host)
	}
	if addrPort.StartPort != 8080 || addrPort.EndPort != 8080 {
		t.Errorf("expected StartPort and EndPort to be 8080, got start=%d end=%d", addrPort.StartPort, addrPort.EndPort)
	}
}

func TestParseNetworkAddress_URISchemeVersusSlashPrefix(t *testing.T) {
	// Standard URI format "tcp://localhost:2019" splits on the first slash,
	// capturing "tcp:" (with colon) as Network and "/localhost" (with slash) as Host.
	addrURI, err := caddy.ParseNetworkAddress("tcp://localhost:2019")
	if err != nil {
		t.Fatalf("unexpected error parsing URI format: %v", err)
	}
	if addrURI.Network != "tcp:" {
		t.Errorf("expected Network to retain trailing colon %q, got %q", "tcp:", addrURI.Network)
	}
	if addrURI.Host != "/localhost" {
		t.Errorf("expected Host to retain leading slash %q, got %q", "/localhost", addrURI.Host)
	}
	if addrURI.StartPort != 2019 || addrURI.EndPort != 2019 {
		t.Errorf("expected StartPort and EndPort to be 2019, got start=%d end=%d", addrURI.StartPort, addrURI.EndPort)
	}

	// Caddy's expected network prefix format uses a single slash: "tcp/localhost:2019".
	addrValid, err := caddy.ParseNetworkAddress("tcp/localhost:2019")
	if err != nil {
		t.Fatalf("unexpected error parsing single-slash format: %v", err)
	}
	if addrValid.Network != "tcp" {
		t.Errorf("expected Network %q, got %q", "tcp", addrValid.Network)
	}
	if addrValid.Host != "localhost" {
		t.Errorf("expected Host %q, got %q", "localhost", addrValid.Host)
	}
	if addrValid.StartPort != 2019 || addrValid.EndPort != 2019 {
		t.Errorf("expected StartPort and EndPort to be 2019, got start=%d end=%d", addrValid.StartPort, addrValid.EndPort)
	}
}

func TestParseNetworkAddress_UnixSocket(t *testing.T) {
	// Unix socket addresses specify "unix/" followed by the socket path.
	addrUnix, err := caddy.ParseNetworkAddress("unix/data/socket.sock")
	if err != nil {
		t.Fatalf("unexpected error parsing unix socket: %v", err)
	}
	if addrUnix.Network != "unix" {
		t.Errorf("expected Network %q, got %q", "unix", addrUnix.Network)
	}
	if addrUnix.Host != "data/socket.sock" {
		t.Errorf("expected Host %q, got %q", "data/socket.sock", addrUnix.Host)
	}
	if !addrUnix.IsUnixNetwork() {
		t.Errorf("expected IsUnixNetwork() to be true")
	}
	if addrUnix.StartPort != 0 || addrUnix.EndPort != 0 {
		t.Errorf("expected StartPort and EndPort to be 0 for unix socket, got start=%d end=%d", addrUnix.StartPort, addrUnix.EndPort)
	}
}

func TestParseNetworkAddress_PortRangesAndLimits(t *testing.T) {
	// Contiguous port range parsing
	addrRange, err := caddy.ParseNetworkAddress("localhost:8080-8085")
	if err != nil {
		t.Fatalf("unexpected error parsing port range: %v", err)
	}
	if addrRange.StartPort != 8080 || addrRange.EndPort != 8085 {
		t.Errorf("expected ports 8080-8085, got start=%d end=%d", addrRange.StartPort, addrRange.EndPort)
	}
	if addrRange.PortRangeSize() != 6 {
		t.Errorf("expected PortRangeSize to be 6, got %d", addrRange.PortRangeSize())
	}

	// Inverted port range returns an error
	_, errInverted := caddy.ParseNetworkAddress("localhost:8085-8080")
	if errInverted == nil {
		t.Fatalf("expected error for inverted port range, got nil")
	}
	if !strings.Contains(errInverted.Error(), "end port must not be less than start port") {
		t.Errorf("expected error message to mention end port less than start port, got %v", errInverted)
	}

	// Out-of-range port (> 65535) returns a parse error
	_, errOutOfRange := caddy.ParseNetworkAddress("localhost:99999")
	if errOutOfRange == nil {
		t.Fatalf("expected error for out of range port, got nil")
	}
	if !strings.Contains(errOutOfRange.Error(), "value out of range") {
		t.Errorf("expected error message to mention value out of range, got %v", errOutOfRange)
	}
}

func TestParseNetworkAddressWithDefaults(t *testing.T) {
	// ParseNetworkAddressWithDefaults fills missing network and port defaults
	addrDef, err := caddy.ParseNetworkAddressWithDefaults("localhost", "tcp", 2019)
	if err != nil {
		t.Fatalf("unexpected error parsing with defaults: %v", err)
	}
	if addrDef.Network != "tcp" {
		t.Errorf("expected Network %q, got %q", "tcp", addrDef.Network)
	}
	if addrDef.Host != "localhost" {
		t.Errorf("expected Host %q, got %q", "localhost", addrDef.Host)
	}
	if addrDef.StartPort != 2019 || addrDef.EndPort != 2019 {
		t.Errorf("expected StartPort and EndPort to be 2019, got start=%d end=%d", addrDef.StartPort, addrDef.EndPort)
	}
	if addrDef.String() != "localhost:2019" {
		t.Errorf("expected String() %q, got %q", "localhost:2019", addrDef.String())
	}
}

오리진 시더

csx-seed