cgalo5758
0d81d9b627
docs/models/entitlements.md (invariant 13) and docs/models/resource-pools.md (invariant 8) now say that a metered key's usage row holds an absolute count of the pool's units, written by the key's owner under the row's lock with the count as its own statement, and that consumers only read it. The pages no longer describe a counter that consumers increment or an atomic draw against it; the purpose list, the consumers row, the pools introduction, invariants 4, 7 and 9, and the vocabulary lines of the pools and provider-integration pages follow. docs/go-conventions.md: a transaction whose correctness needs each statement's own snapshot opens with db.ReadCommitted, and the doc comment of the function that opens it, or of the function it relies on, says so; the FedWiki sync's insert and farm-absent delete, the permanent delete's row transaction and DecrementUsageActivity now say it. status/design-feedback.md records that the design describes usage as a counter consumers increment and does not name reservations in flight. The deadcode entries for startClaimVerification and claimErrorMessage now name #44, and the complexity exceptions of CreateSite and swapActiveSite name #174, which deletes both functions; their pinned texts are unchanged.
60 lines
3.5 KiB
Plaintext
60 lines
3.5 KiB
Plaintext
# Production functions that only tests reach, one per line:
|
|
#
|
|
# <package path>.<Func> # reason (owner)
|
|
#
|
|
# The package path is relative to the module path, as in
|
|
# internal/domains.WithEvidenceLookup. A method is <package path>.<Type>.<Method>.
|
|
# An entry ending in .* covers a whole package and names it a test-support
|
|
# package: scripts/sqlc-unused counts a query call from it as a test use. A
|
|
# function that is reachable from a program, or that no longer exists, fails
|
|
# scripts/deadcode.sh, so an entry leaves with the code it covers. The owner
|
|
# is the issue that removes the entry; "permanent" marks entries no change
|
|
# removes.
|
|
|
|
# Test-support packages, by design.
|
|
internal/integration/transporttest.* # fake transport for the integration contract's tests (permanent)
|
|
internal/stripetest.* # Stripe backend mock and its fixtures (permanent)
|
|
internal/integrations/discourse/discoursetest.* # fake Discourse server (permanent)
|
|
internal/testkit.* # helpers every test package shares (permanent)
|
|
internal/testkit/dbtest.* # helpers every database test shares (permanent)
|
|
internal/testkit/htmltest.* # HTML parsing and selection every render test shares (permanent)
|
|
internal/testkit/golden.* # golden files and the normaliser every golden test shares (permanent)
|
|
internal/testkit/replay.* # replaying and recording the Temporal histories every workflow package keeps (permanent)
|
|
internal/testkit/world.* # the builder every fixture shares (permanent)
|
|
internal/testkit/authtest.* # signed-in sessions every handler test shares (permanent)
|
|
internal/integrations/fedwiki/fedwikitest.* # FedWiki's fixtures, shared by its three packages' tests (permanent)
|
|
test/e2e/browsertest.* # browser session helpers for the walkthroughs (permanent)
|
|
|
|
# By design.
|
|
internal/domains.WithEvidenceLookup # the test seam for DNS lookups (permanent)
|
|
internal/forms.FamilyFor # the form registry's checks, which tests run over every registered form (permanent)
|
|
internal/forms.CheckInvariants # same (permanent)
|
|
internal/forms.isFormMethod # same (permanent)
|
|
internal/forms.isSentence # same (permanent)
|
|
internal/forms.contentWords # same (permanent)
|
|
internal/forms.hintRestatesLabel # same (permanent)
|
|
internal/forms.checkKindAndFamily # same (permanent)
|
|
internal/forms.checkFamilyScope # same (permanent)
|
|
internal/forms.checkRowsScope # same (permanent)
|
|
internal/forms.checkRoutes # same (permanent)
|
|
internal/forms.checkWayOut # same (permanent)
|
|
internal/forms.checkFieldOrder # same (permanent)
|
|
internal/forms.checkFieldStructure # same (permanent)
|
|
internal/forms.checkFieldPlacement # same (permanent)
|
|
internal/forms.checkFieldWidth # same (permanent)
|
|
internal/forms.checkFieldCopy # same (permanent)
|
|
internal/forms.checkEscapeHatch # same (permanent)
|
|
internal/forms.checkFieldDashes # same (permanent)
|
|
internal/forms.checkFormDashes # same (permanent)
|
|
internal/forms.All # same (permanent)
|
|
internal/forms.ActionTriggers # same (permanent)
|
|
internal/forms.Routes # same (permanent)
|
|
internal/lint.Routes # the route table the forms registry test reads (permanent)
|
|
internal/lint.Route.IsMutation # same (permanent)
|
|
|
|
# Owned: removed by the step or issue named in the parentheses.
|
|
internal/httplimit.IsTooLarge # no production caller yet (#146)
|
|
internal/server.MemberDomainsHandler.startClaimVerification # a copy of FedWiki's claim glue whose test helpers 14 server test files share (#44)
|
|
internal/server.MemberDomainsHandler.claimErrorMessage # same (#44)
|
|
internal/workflows/desiredstate.DeliveryStates # a reader with no page yet (#171)
|