declscope: a linter that brings file-scoped private to Go's flat packages
This is an English version of an article I wrote in Japanese . The flat package Opinions differ, but one school in Go says: few packages, large ones. Flat packages. Go against it, and split a package just to get a boundary, and you pay for it. Import cycles , and the interfaces you write only to invert a dependency and break them Every name the two halves share has to be exported. You wanted a…
Declscope is a linter designed to enforce the Go programming language's convention of keeping declaration scopes within packages. This rule helps maintain code organization and prevents unintended access to unexported helpers or fields from other files in a flat package. In a flat package, Go only provides two visibility levels: exported (accessible from any package) and unexported (only accessible within the file where it is declared).
The linter helps to identify instances where an agent or AI tool may inadvertently cross package boundaries by calling unexported helpers or fields, and provides guidance on how to correct these issues.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.
