Feature: once and done

[jceaser]

1. Adding a way to make one request and return the response to the console so that the tool can be used as a CGI handler on simple web hosting shell accounts. To use pass a request to the flag -once like this: -once /README.md
2. Exposing a setting for configuring the gopher document root. To use pass -root <path> when launching
3. Changing port to a number to enforce more accurate values are used
4. Adding a script to document things, sample content, a wrapper CGI script.

[jceaser]

An example of this work can be seen at http://thomascherry.name/cgi-bin/gwrap.cgi?/. My web service does not let me host anything on port 70, so I'm stuck on the web. Not knowing much, this is my attempt to get your app to run as a web application, but returning gopher content. Bombadillo will not handle it as of yet, but I have been playing with its code as well. I may just write a new client which makes HTTP calls but expects gopher content. Any ideas are welcome.

These changes should be pretty independent of my global plans to create a gopher server on the web. It's just nice for testing to be able to call one request and get a response, so I hope you find it helpful.

[peterhellberg]

Instead of having a Compile section, the Installation section should be updated to use go install github.com/peterhellberg/gopher/cmd/gopherd@latest instead of go get -u github.com/peterhellberg/gopher/cmd/gopherd

[jceaser]

well, I don't want to install at this point, I want a local compile. The primary reason is that I can't compile go on my web server (a hosted service I pay for but have little control over), so I am only interested in generating a binary that I can scp up. Installing would put the files in ~/go right? I don't mind documenting an install command.

Also, can you name a binary when you install? golang/go#44469

[peterhellberg]

The name of the binary should be gopherd

[jceaser]

do you object to the longer names for the cross compiled versions?

[peterhellberg]

Thank you for opening the PR, I've left a few comments as I'm a bit reluctant to bring in all of the changes.