doc: document that "main" is a reserved import path

[gopherbot]

by Kevapo:

What steps will reproduce the problem?
1. create a package main, with a few file, and a Main.go file (with main method)
2. create a main_test.go inside this package (with a simple test that use the data or
methods inside the package main)
3. go test main

What is the expected output? ==> that it will launch the tests inside main_test.go

What do you see instead?
kevapo@ubuntu:~/workspace/dtstrike/starters/Go/src/main$ go test -x -v
WORK=/tmp/go-build574310510
mkdir -p $WORK/main/_test/
cd /home/kevapo/workspace/dtstrike/starters/Go/src/main
/usr/local/go/pkg/tool/linux_amd64/6g -o $WORK/main/_test/_go_.6 -p main -complete -D
_/home/kevapo/workspace/dtstrike/starters/Go/src/main -I $WORK ./GameState.go ./Main.go
./MyBot.go ./PlanetSystem.go ./main_test.go
/usr/local/go/pkg/tool/linux_amd64/pack grcP $WORK $WORK/main/_test/main.a
$WORK/main/_test/_go_.6
cd $WORK/main/_test
/usr/local/go/pkg/tool/linux_amd64/6g -o ./_go_.6 -p testmain -complete -D ""
-I . -I $WORK ./_testmain.go
# testmain
/tmp/go-build574310510/main/_test/_testmain.go:9: cannot import "main"
$WORK/main/_test/main.test -test.v=true
FAIL    main [build failed]

Version : 
go version go1.1.1 linux/amd64 on ubuntu

Attachments:

1. main.zip (8312 bytes)

[vdobler]

Comment 1:

Works as intended. Running "$ go test" works fine and runs the tests in the local
directory.
Maybe go test could print something like "Use 'go test' without a package name to test
package in local directory." when the package cannot be loaded.

[adg]

Comment 2:

Don't put your code in $GOPATH/src/main. "main" is a reserved import path.
We should document this.

Labels changed: added priority-soon, documentation, go1.2maybe, removed priority-triage.

Status changed to Accepted.

[gopherbot]

Comment 3 by Kevapo:

go test in the package directory doesn't work for me.
But as said comment #2, if i just rename my package to anything other than main, then
it's working perfectly.
I agree it should be documented.

[gopherbot]

Comment 4 by Kevapo:

Just to be sure, this in addition to :
"An application - Go code that will be compiled into an executable command - always
defines package main with a main() function."
Those 2 restriction make it impossible to have a single package with the main() methods
and tests.
So i'm will never be able to
- to test a main package,
- to name the launcher/command line package something else than main 
and if I want to test part of a simple executable, I still have to have 2 different
package : a dummy main and the code inside another one that I want to test.

[vdobler]

Comment 5:

You are misled here: Just put your code somewhere else in
filesystem than where it is now: E.g. just rename the main 
directory to whatever /workspace/dtstrike/starters/Go/src/whatever
and testing works.

[robpike]

Comment 6:

This issue was closed by revision 29b4de2.

Status changed to Fixed.