Inicio Rápido

En este inicio rápido, captaremos información y aprenderemos por medio de porciones de código:

Requerimientos

  • Go 1.13 o superior

Instalación

Para instalar Gin, primero debe instalar Go y configurar el espacio de trabajo Go.

  1. Descargar e instalar:
$ go get -u github.com/gin-gonic/gin
  1. Importar en el código:
import "github.com/gin-gonic/gin"
  1. Importar el paquete net/http (Opcional). Es requerido para el uso de constantes como por ejemplo http.StatusOK.
import "net/http"
  1. Crear la carpeta del proyecto e ingresar en ella con cd
$ mkdir -p $GOPATH/src/github.com/myusername/project && cd "$_"
  1. Copiar una plantilla de inicio dentro del proyecto
$ curl https://raw.githubusercontent.com/gin-gonic/examples/master/basic/main.go > main.go
  1. Ejecutar el proyecto
$ go run main.go

Primeros Pasos

¿No sabes cómo escribir y ejecutar código Go? Click aquí.

Primero, crear un archivo llamado example.go:

# asumimos que el código siguiente se encontrará en el archivo example.go
$ touch example.go

A continuación, coloque el siguiente código dentro en example.go:

package main

import "github.com/gin-gonic/gin"

func main() {
	r := gin.Default()
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "pong",
		})
	})
	r.Run() // Sirve y escucha peticiones en 0.0.0.0:8080
}

Y ahora, puede ejecutar el código a través de go run example.go:

# ejecuta example.go y visita 0.0.0.0:8080/ping en el navegador
$ go run example.go

Última modificación 29.04.2021: update Golang version requirement (#167) (0bda0d4)