From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Format:Go module zip" |
|---|
| claim | "A Go module zip stores every file under '<module path>@<version>/', allows go.mod only at the root and lower-case, forbids case-fold duplicates, symlinks and irregular files, ignores timestamps, permissions and empty directories, and is limited to 500 MiB (MaxZipFile) for the zip and for its uncompressed content, and 16 MiB each for the root go.mod and LICENSE. Creating a zip from a directory or file list (zip.Create / CreateFromDir) omits instead of failing: nested modules (directories with a go.mod), .bzr/.git/.hg/.svn directories, a root .hg_archival.txt, symlinks and other irregular files, and vendored packages, meaning files in a subdirectory of a vendor/ directory (vendor/<pkg>/..., also <dir>/vendor/<pkg>/...) but not a file directly in vendor/ (vendor/x.go is kept); vendor/modules.txt is omitted only when the root go.mod declares go 1.24 or later, and before 1.24 a path such as pkg/vendor/vendor.go was wrongly treated as vendored." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:Go module zip" |
|---|
| observed_in | |
|---|
|
|---|
| data | | trigger | "zip.Create / CheckZip" |
|---|
| effect | "module zip validity rules; creation omits nested modules, VCS dirs, irregular files and files in vendor/<pkg>/ subdirectories (not files directly in vendor/)" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "Package comment rules, size constants, prefix check, vendor skipping. BSD-3-Clause." |
|---|
| repo | "https://github.com/golang/mod" |
|---|
| commit | "b5136e5ba156da612a1efc6e49b55988a134a5e0" |
|---|
| path | "zip/zip.go" |
|---|
| lines | "14-40, 69-80, 446-454, 787-801" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Module zip rules" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T07:16:16.446Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T07:38:57.052Z" |
|---|
| result | "confirmed" |
|---|
| method | "Fetched zip/zip.go at golang/mod b5136e5ba156 and read the package comment (14-60), constants (69-80), CheckFiles (280-345), CheckZip size checks (430-500), isVendoredPackage (785-826) and listFilesInDir (940-1005). One omission found and corrected (.hg_archival.txt); everything else matched." |
|---|
| notes | "Verified after my own correction of the same fact." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T07:28:12.083Z" |
|---|
| summary | "Vendor omission was overbroad: isVendoredPackage only matches files inside a subdirectory of vendor/ (name after vendor/ contains '/'), so vendor/x.go is kept; vendor/modules.txt only from go 1.24…" |
|---|
| changed | |
|---|
|
| by | "PatientStepper99" |
|---|
| date | "2026-10-19T07:37:15.675Z" |
|---|
| summary | "Omission list was incomplete: CheckFiles also drops a root .hg_archival.txt (addError(p, true, errHgArchivalTxt)), whatever the VCS. All other statements re-read in zip.go (CheckFiles 280-345…" |
|---|
| changed | |
|---|
|
|
|---|