Compare commits
1 Commits
fix/121-li
...
dea7e441b9
| Author | SHA1 | Date | |
|---|---|---|---|
| dea7e441b9 |
@@ -1,6 +1,5 @@
|
|||||||
.git/
|
.git/
|
||||||
bin/
|
bin/
|
||||||
.lint-cache/
|
|
||||||
*.md
|
*.md
|
||||||
LICENSE
|
LICENSE
|
||||||
.editorconfig
|
.editorconfig
|
||||||
|
|||||||
1
.gitignore
vendored
1
.gitignore
vendored
@@ -1,7 +1,6 @@
|
|||||||
bin/
|
bin/
|
||||||
vendor/
|
vendor/
|
||||||
data/
|
data/
|
||||||
.lint-cache/
|
|
||||||
.env
|
.env
|
||||||
*.exe
|
*.exe
|
||||||
/dnswatcher
|
/dnswatcher
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ FROM golang@sha256:f6751d823c26342f9506c03797d2527668d095b0a15f1862cddb4d927a7a4
|
|||||||
RUN apk add --no-cache git make gcc musl-dev binutils-gold
|
RUN apk add --no-cache git make gcc musl-dev binutils-gold
|
||||||
|
|
||||||
# golangci-lint v2.12.2, 2026-08-07
|
# golangci-lint v2.12.2, 2026-08-07
|
||||||
RUN go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@c0d3ddc9cf3faa61a4e378e879ece580256d76e5
|
RUN go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.12.2
|
||||||
# goimports v0.42.0
|
# goimports v0.42.0
|
||||||
RUN go install golang.org/x/tools/cmd/goimports@009367f5c17a8d4c45a961a3a509277190a9a6f0
|
RUN go install golang.org/x/tools/cmd/goimports@009367f5c17a8d4c45a961a3a509277190a9a6f0
|
||||||
|
|
||||||
|
|||||||
25
README.md
25
README.md
@@ -17,26 +17,6 @@ without requiring an external database.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## No DNS mocking. Ever.
|
|
||||||
|
|
||||||
**DNS is never mocked in this project — not in tests, not anywhere else.**
|
|
||||||
No mock resolvers, no fake DNS servers, no stubbed lookups.
|
|
||||||
|
|
||||||
dnswatcher's entire purpose is correct behavior against the real DNS.
|
|
||||||
Tests exercise real iterative resolution against live nameservers by
|
|
||||||
design; a test suite that passes against a mock proves nothing about the
|
|
||||||
one thing this program exists to do.
|
|
||||||
|
|
||||||
When live tests are flaky, that is a robustness problem, and it gets
|
|
||||||
fixed with robustness: retries with backoff, querying multiple
|
|
||||||
independent nameservers, longer timeouts — or explicit opt-in gating
|
|
||||||
decided by the project owner. Never with mocks.
|
|
||||||
|
|
||||||
Contributions that introduce mocked, faked, or stubbed DNS will be
|
|
||||||
rejected.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
### DNS Domain Monitoring (Apex Domains)
|
### DNS Domain Monitoring (Apex Domains)
|
||||||
@@ -387,10 +367,7 @@ them. We provide:
|
|||||||
- `script/projectname` — print the project name (used for the Docker
|
- `script/projectname` — print the project name (used for the Docker
|
||||||
image tag)
|
image tag)
|
||||||
- `script/test` — run the test suite (race detector, coverage)
|
- `script/test` — run the test suite (race detector, coverage)
|
||||||
- `script/lint` — run golangci-lint, with its cache and its lock file
|
- `script/lint` — run golangci-lint
|
||||||
isolated to this checkout (under the git-ignored `.lint-cache/`) so
|
|
||||||
concurrent checkouts on one host cannot share cache entries or
|
|
||||||
contend on a single lock
|
|
||||||
- `script/fmt` — format all code (gofmt -s, goimports)
|
- `script/fmt` — format all code (gofmt -s, goimports)
|
||||||
- `script/fmt-check` — check formatting (read-only)
|
- `script/fmt-check` — check formatting (read-only)
|
||||||
- `script/check` — run test, lint, and fmt-check
|
- `script/check` — run test, lint, and fmt-check
|
||||||
|
|||||||
21
TODO.md
21
TODO.md
@@ -25,23 +25,10 @@ confirm make check still passes.
|
|||||||
|
|
||||||
# Completed Steps
|
# Completed Steps
|
||||||
|
|
||||||
- 2026-08-09: `script/lint` now isolates golangci-lint's per-user global
|
- 2026-08-07: golangci-lint bumped to v2.12.2 (pins in `Dockerfile` and
|
||||||
state to the checkout (#121): `GOLANGCI_LINT_CACHE` and `TMPDIR` are
|
`script/bootstrap`), `.golangci.yml` replaced with the canonical v2
|
||||||
both pointed at the git-ignored, Docker-ignored `.lint-cache/`. The
|
config (settings moved under `linters.settings` so thresholds now
|
||||||
cache fixes cross-contamination; `TMPDIR` is what moves the lock,
|
apply); fixed all resulting `goconst`, `dupl`, and `lll` findings
|
||||||
which lives at `$TMPDIR/golangci-lint.lock` and not in the cache
|
|
||||||
directory. Reproduced both failure modes on the unfixed script (10 of
|
|
||||||
12 concurrent runs void with `parallel golangci-lint is running`; 11
|
|
||||||
of 12 reporting another checkout's paths) and both are gone at 20-way
|
|
||||||
concurrency after the fix
|
|
||||||
- 2026-08-07: golangci-lint bumped to v2.12.2 (commit-pinned installs
|
|
||||||
in `Dockerfile` and `script/bootstrap`); `.golangci.yml` set to the
|
|
||||||
org-standard v2-schema config used across the org's repos
|
|
||||||
(owner-authorized; same file is being landed as canonical via prompts
|
|
||||||
PR #24), with settings under `linters.settings` so the
|
|
||||||
lll/funlen/cyclop/dupl thresholds apply; fixed the resulting
|
|
||||||
`goconst`, `dupl`, and `lll` findings; the informational `gomodguard`
|
|
||||||
deprecation warning under this config is accepted
|
|
||||||
- 2026-07-07 Adopted scripts-to-rule-them-all: `script/` entrypoints,
|
- 2026-07-07 Adopted scripts-to-rule-them-all: `script/` entrypoints,
|
||||||
Makefile shims, README Entrypoints section
|
Makefile shims, README Entrypoints section
|
||||||
- 2026-02-20: iterative DNS resolver implemented; tests made hermetic
|
- 2026-02-20: iterative DNS resolver implemented; tests made hermetic
|
||||||
|
|||||||
@@ -4,14 +4,14 @@
|
|||||||
# installed tools are skipped. Base tooling comes from nix, apt, brew,
|
# installed tools are skipped. Base tooling comes from nix, apt, brew,
|
||||||
# or apk (detected in that order); assumes nothing is present.
|
# or apk (detected in that order); assumes nothing is present.
|
||||||
# golangci-lint and goimports are installed via `go install` at the same
|
# golangci-lint and goimports are installed via `go install` at the same
|
||||||
# pinned commits the Dockerfile uses (never "latest").
|
# pinned refs the Dockerfile uses (never "latest").
|
||||||
set -eu
|
set -eu
|
||||||
|
|
||||||
ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
|
ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
|
||||||
|
|
||||||
# Pinned versions, 2026-08-07 (same pins as the Dockerfile)
|
# Pinned versions, 2026-08-07 (same pins as the Dockerfile)
|
||||||
# golangci-lint v2.12.2
|
# golangci-lint v2.12.2
|
||||||
GOLANGCI_LINT_REF="github.com/golangci/golangci-lint/v2/cmd/golangci-lint@c0d3ddc9cf3faa61a4e378e879ece580256d76e5"
|
GOLANGCI_LINT_REF="github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.12.2"
|
||||||
# goimports v0.42.0
|
# goimports v0.42.0
|
||||||
GOIMPORTS_REF="golang.org/x/tools/cmd/goimports@009367f5c17a8d4c45a961a3a509277190a9a6f0"
|
GOIMPORTS_REF="golang.org/x/tools/cmd/goimports@009367f5c17a8d4c45a961a3a509277190a9a6f0"
|
||||||
|
|
||||||
|
|||||||
29
script/lint
29
script/lint
@@ -1,40 +1,11 @@
|
|||||||
#!/bin/sh
|
#!/bin/sh
|
||||||
# script/lint: run the linter.
|
# script/lint: run the linter.
|
||||||
#
|
|
||||||
# golangci-lint keeps two pieces of per-user global state, and both of
|
|
||||||
# them break when several checkouts on one host lint concurrently:
|
|
||||||
#
|
|
||||||
# 1. Its analysis cache (GOLANGCI_LINT_CACHE, default
|
|
||||||
# ~/.cache/golangci-lint). Entries are keyed by content, not by
|
|
||||||
# checkout, so a hit written by another checkout is replayed
|
|
||||||
# verbatim - including that checkout's file paths. The run then
|
|
||||||
# reports findings for files it never linted.
|
|
||||||
#
|
|
||||||
# 2. Its "one runner at a time" lock, which does NOT live in the
|
|
||||||
# cache directory: golangci-lint locks
|
|
||||||
# $(os.TempDir())/golangci-lint.lock, i.e.
|
|
||||||
# "$TMPDIR"/golangci-lint.lock (pkg/commands/run.go,
|
|
||||||
# acquireFileLock). It waits 5s, then aborts with "parallel
|
|
||||||
# golangci-lint is running" - a non-result that looks like a lint
|
|
||||||
# failure. Setting GOLANGCI_LINT_CACHE alone does not move it.
|
|
||||||
#
|
|
||||||
# So both are pinned under the checkout root. The cache is never shared,
|
|
||||||
# and TMPDIR makes the lock file per-checkout, which keeps the lock
|
|
||||||
# doing its actual job (serialising runs that share one cache) at the
|
|
||||||
# right scope. .lint-cache/ is git-ignored and Docker-ignored, and
|
|
||||||
# caching still works: it persists across runs in this checkout.
|
|
||||||
set -eu
|
set -eu
|
||||||
|
|
||||||
ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
|
ROOT="$(cd "$(dirname "$0")/.." && pwd -P)"
|
||||||
|
|
||||||
main() {
|
main() {
|
||||||
cd "$ROOT"
|
cd "$ROOT"
|
||||||
|
|
||||||
GOLANGCI_LINT_CACHE="$ROOT/.lint-cache/cache"
|
|
||||||
TMPDIR="$ROOT/.lint-cache/tmp"
|
|
||||||
export GOLANGCI_LINT_CACHE TMPDIR
|
|
||||||
mkdir -p "$GOLANGCI_LINT_CACHE" "$TMPDIR"
|
|
||||||
|
|
||||||
golangci-lint run --config .golangci.yml ./...
|
golangci-lint run --config .golangci.yml ./...
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user