Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hoisie/web
The easiest way to create web applications with Go
https://github.com/hoisie/web
Last synced: 29 days ago
JSON representation
The easiest way to create web applications with Go
- Host: GitHub
- URL: https://github.com/hoisie/web
- Owner: hoisie
- License: mit
- Created: 2009-12-08T20:46:02.000Z (almost 15 years ago)
- Default Branch: master
- Last Pushed: 2024-06-29T16:29:40.000Z (5 months ago)
- Last Synced: 2024-10-01T14:23:46.881Z (about 1 month ago)
- Language: Go
- Homepage:
- Size: 3.04 MB
- Stars: 3,668
- Watchers: 214
- Forks: 706
- Open Issues: 48
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-repos - hoisie/web - The easiest way to create web applications with Go (Go)
README
[](https://travis-ci.org/hoisie/web)
# web.go
web.go is the simplest way to write web applications in the Go programming language. It's ideal for writing simple, performant backend web services.
## Overview
web.go should be familiar to people who've developed websites with higher-level web frameworks like sinatra 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
* Secure cookies
* Support for fastcgi and scgi
* Web applications are compiled to native code. This means very fast execution and page render speed
* Efficiently serving static files
## Installation
Make sure you have the a working Go environment. See the [install instructions](http://golang.org/doc/install.html). web.go targets the Go `release` branch.
To install web.go, simply run:
go get github.com/hoisie/web
To compile it from source:
git clone git://github.com/hoisie/web.git
cd web && go build
## Example
```go
package main
import (
"github.com/hoisie/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:
go run hello.go
You can point your browser to http://localhost:9999/world .
### Getting parameters
Route handlers may contain a pointer to web.Context as their first parameter. This variable serves many purposes -- it contains information about the request, and it provides methods to control the http connection. For instance, to iterate over the web parameters, either from the URL of a GET request, or the form data of a POST request, you can access `ctx.Params`, which is a `map[string]string`:
```go
package main
import (
"github.com/hoisie/web"
)
func hello(ctx *web.Context, val string) {
for k,v := range ctx.Params {
println(k, v)
}
}
func main() {
web.Get("/(.*)", hello)
web.Run("0.0.0.0:9999")
}
```
In this example, if you visit `http://localhost:9999/?a=1&b=2`, you'll see the following printed out in the terminal:
a 1
b 2
## Documentation
API docs are hosted at https://hoisie.github.io/web/
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 efforts on features that people will actually use.
## About
web.go was written by Michael Hoisie