Text file src/cmd/go/testdata/mod/README

     1  This directory holds Go modules served by a Go module proxy
     2  that runs on localhost during tests, both to make tests avoid
     3  requiring specific network servers and also to make them
     4  significantly faster.
     5  
     6  A small go get'able test module can be added here by running
     7  
     8  	cd cmd/go/testdata
     9  	go run addmod.go path@vers
    10  
    11  where path and vers are the module path and version to add here.
    12  
    13  For interactive experimentation using this set of modules, run:
    14  
    15  	cd cmd/go
    16  	go test -proxy=localhost:1234 &
    17  	export GOPROXY=http://localhost:1234/mod
    18  
    19  and then run go commands as usual.
    20  
    21  Modules saved to this directory should be small: a few kilobytes at most.
    22  It is acceptable to edit the archives created by addmod.go to remove
    23  or shorten files. It is also acceptable to write module archives by hand:
    24  they need not be backed by some public git repo.
    25  
    26  Each module archive is named path_vers.txt, where slashes in path
    27  have been replaced with underscores. The archive must contain
    28  two files ".info" and ".mod", to be served as the info and mod files
    29  in the proxy protocol (see https://research.swtch.com/vgo-module).
    30  The remaining files are served as the content of the module zip file.
    31  The path@vers prefix required of files in the zip file is added
    32  automatically by the proxy: the files in the archive have names without
    33  the prefix, like plain "go.mod", "x.go", and so on.
    34  
    35  See ../addmod.go and ../savedir.go for tools to generate txtar files,
    36  although again it is also fine to write them by hand.
    37  

View as plain text