README
¶
web.go
web.go is the simplest way to write web applications in the Go programming language.
Overview
web.go should be familiar to people who've developed websites with higher-level web frameworks like sinatra, pylons, or web.py. It is designed to be a lightweight web framework that doesn't impose any scaffolding on the user. Some features include:
- Routing to url handlers based on regular expressions
- User sessions
- Support for fastcgi and scgi
- Web applications are compiled to native code. This means very fast execution and page render speed ( benchmarks coming soon :)
Installation
- Make sure you have the a working Go environment. See the install instructions
- git clone git://github.com/hoisie/web.go.git
- cd web.go && make install
Example
package main
import (
"web"
)
func hello(val string) string { return "hello " + val }
func main() {
web.Get("/(.*)", hello)
web.Run("0.0.0.0:9999")
}
To run the application, put the code in a file called hello.go and run:
8g hello.go && 8l -o hello hello.8 && ./hello
You can point your browser to http://localhost:9999/world .
Documentation
For a quickstart guide, check out web.go's home page
There is also a tutorial
If you use web.go, I'd greatly appreciate a quick message about what you're building with it. This will help me get a sense of usage patterns, and helps me focus development effors on features that people will actually use.
About
web.go was written by Michael Hoisie.
Follow me on Twitter!
Documentation
¶
Index ¶
- func Delete(route string, handler interface{})
- func Get(route string, handler interface{})
- func Post(route string, handler interface{})
- func Put(route string, handler interface{})
- func Run(addr string)
- func RunFcgi(addr string)
- func RunScgi(addr string)
- func SetCookieSecret(key string)
- func SetStaticDir(dir string) os.Error
- func Urlencode(data map[string]string) string
- type Context
- func (ctx *Context) Abort(status int, body string)
- func (ctx *Context) GetSecureCookie(name string) (string, bool)
- func (ctx *Context) NotFound(message string)
- func (ctx *Context) Redirect(status int, url string)
- func (ctx *Context) SetCookie(name string, value string, age int64)
- func (ctx *Context) SetSecureCookie(name string, val string, age int64)
- func (ctx *Context) StartResponse(status int)
- func (ctx *Context) Write(data []byte) (n int, err os.Error)
- func (ctx *Context) WriteString(content string)
- type Request
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Delete ¶
func Delete(route string, handler interface{})
Adds a handler for the 'DELETE' http method.
func SetCookieSecret ¶
func SetCookieSecret(key string)
func SetStaticDir ¶
changes the location of the static directory. by default, it's under the 'static' folder of the directory containing the web application
Types ¶
type Context ¶
type Context struct {
*Request
// contains filtered or unexported fields
}
func (*Context) SetSecureCookie ¶
func (*Context) StartResponse ¶
func (*Context) WriteString ¶
type Request ¶
type Request struct {
Method string // GET, POST, PUT, etc.
RawURL string // The raw URL given in the request.
URL *http.URL // Parsed URL.
Proto string // "HTTP/1.0"
ProtoMajor int // 1
ProtoMinor int // 0
Headers map[string]string
Body io.Reader
Close bool
Host string
Referer string
UserAgent string
Params map[string][]string
Cookies map[string]string
Files map[string]filedata
}
Source Files
Directories