25720733814
94%
main: 88%

Ran 12 May 2026 07:44AM UTC

Jobs 3

Files 11

Run time 1min

Badge

Embed ▾

Committed 12 May 2026 07:30AM UTC coverage: 93.78% (+2.5%) from 91.26%

Build # 25720733814

Build Type

push

github

Committed by

hardbyte

Commit Message

feat(cli): --source-ip option for tcp, http, and dns probes

Closes #70.

All three probe types now accept a local source IP to bind the
outgoing socket to. Surfaced as a top-level CLI option and as a
`source-ip` field in the run config:

  netcheck tcp  --host github.com --port 443 --source-ip 192.168.1.10
  netcheck http --url https://example.com --source-ip 192.168.1.10
  netcheck dns  --host example.com           --source-ip 192.168.1.10

Implementation notes:
- TCP uses socket.create_connection(source_address=(ip, 0)).
- HTTP uses a small urllib3 SourceAddressAdapter mounted on a
  per-call requests.Session.
- DNS uses dnspython's Resolver.resolve(source=ip), which already
  exposes the source address parameter.

The source-ip echoes back in the probe spec so it shows up in
PolicyReport evidence.

Coverage Stats

392 of 418 relevant lines covered (93.78%)

5.63 hits per line

Coverage Regressions

Lines	Coverage	∆	File
5	92.86	0.47%	netcheck/cli.py
4	94.79	0.0%	netcheck/runner.py
3	91.11	10.16%	netcheck/checks/dns.py
1	90.32	16.25%	netcheck/checks/tcp.py

Jobs

ID	Job ID	Ran	Files	Coverage
1	Unittests-ubuntu-latest- - 25720733814.1	12 May 2026 07:44AM UTC	11	93.78	GitHub Action Run
2	Unittests-macos-latest- - 25720733814.2	12 May 2026 07:44AM UTC	11	93.78	GitHub Action Run
3	Unittests-windows-latest- - 25720733814.3	12 May 2026 07:44AM UTC	11	93.78	GitHub Action Run

hardbyte / netchecks / 25720733814
94%
main: 88%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 25720733814

hardbyte / netchecks / 25720733814 94% main: 88%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 25720733814

hardbyte / netchecks / 25720733814
94%
main: 88%

README BADGES
x