blackteay/gin
3
0
Fork 0
mirror of https://github.com/gin-gonic/gin.git synced 2025-10-22 17:42:14 +08:00
Code Issues Projects Releases Wiki Activity

Improvements and more begginer-friendly.

Browse Source 
I have updated the file to make it easier for beginners to get started, and also fixed some weird things.
This commit is contained in:
SamuelSimao 2018-12-20 21:32:40 -02:00 committed by GitHub
parent 678e09c736
commit 52f383c70a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 23 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
README.md
View File

@ -68,9 +68,11 @@ Gin is a web framework written in Go (Golang). It features a martini-like API wi
## Installation
To install Gin package, you need to install Go and set your Go workspace first.
To install Gin, you'll first need to [install Go and set up your Go workspace](https://golang.org/doc/install).
1. Download and install it:
### Installing with `go-get`
1. Download and install Gin:
```sh
$ go get -u github.com/gin-gonic/gin
@ -81,14 +83,13 @@ $ go get -u github.com/gin-gonic/gin
```go
import "github.com/gin-gonic/gin"
```
3. (Optional) Import `net/http`. This is required for example if using constants such as `http.StatusOK`.
3. (Optional) Import `net/http`. This is required if you want to use constants such as `http.StatusOK`.
```go
import "net/http"
```
### Use a vendor tool like [Govendor](https://github.com/kardianos/govendor)
### Installing with [Govendor](https://github.com/kardianos/govendor)
1. `go get` govendor
@ -120,16 +121,19 @@ $ curl https://raw.githubusercontent.com/gin-gonic/gin/master/examples/basic/mai
$ go run main.go
```
## Prerequisite
## Requisites
Now Gin requires Go 1.6 or later and Go 1.7 will be required soon.
For now, Gin will run on Go 1.6 or later. Using go 1.7 is highly recommended as it will become the minimum supported version soon.
To check the version of your Go installation, type in your Terminal emulator:
## Quick start
```sh
# assume the following codes in example.go file
$ cat example.go
```
`$ go version`
## Quickstart project ("Ping, pong")
This example code responds "Pong" when a user `GET`s 0.0.0.0t:8080/ping.
To start, `cd` into your `$GOPATH/src` and create a new folder for your project.
After that, create a new file called `example.go` with the following contents:
```go
package main
@ -140,18 +144,21 @@ func main() {
r := gin.Default()
r.GET("/ping", func(c *gin.Context) {
c.JSON(200, gin.H{
"message": "pong",
"message": "Pong!",
})
})
r.Run() // listen and serve on 0.0.0.0:8080
}
```
Save that file. In that same directory, run:
```
# run example.go and visit 0.0.0.0:8080/ping on browser
$ go run example.go
```
Now, open your favorite browser and go to `0.0.0.0:8080/ping`. If you see `Pong!`, congratulations! You have just finished your first Gin project.
## Benchmarks
Gin uses a custom version of [HttpRouter](https://github.com/julienschmidt/httprouter)
@ -2035,8 +2042,7 @@ func TestPingRoute(t *testing.T) {
```
## Users
Awesome project lists using [Gin](https://github.com/gin-gonic/gin) web framework.
List of awesome projects made with the [Gin](https://github.com/gin-gonic/gin) web framework.
* [drone](https://github.com/drone/drone): Drone is a Continuous Delivery platform built on Docker, written in Go.
* [gorush](https://github.com/appleboy/gorush): A push notification server written in Go.