nine

Nine is an HTTP client and server library in Go that simplifies sending HTTP requests and processing routes. With Nine, you can easily create HTTP clients and servers with support for middleware, response handling, and much more.

Installation

To add the Nine library to your Go project, you can use the following command:

go get github.com/i9si-sistemas/nine

Usage

Client

The HTTP client allows you to make various types of requests (GET, POST, PUT, PATCH, DELETE) easily.

package main

import (
    "context"
    "fmt"
    "github.com/i9si-sistemas/nine"
    "net/http"
)

func main() {
    ctx := context.Background()
    client := nine.New(ctx)
    buf, err := nine.JSON{
        "message":"Hello World"
    }.Buffer()
    if err != nil{
        fmt.Println("Erro ao gerar o buffer do payload:", err)
        return
    }
    options := &nine.Options{
        Headers: []nine.Header{
            {Data: nine.Data{Key: "Content-Type", Value: "application/json"}},
        },
        Body:  buf,
    }

    res, err := client.Get("https://api.exemplo.com/endpoint", options)
    if err != nil {
        fmt.Println("Erro ao fazer requisição:", err)
        return
    }
    defer res.Body.Close()
    // use the response
}

Server

To create a server, you can use the following code:

package main

import (
    "fmt"
    "github.com/i9si-sistemas/nine"
    "log"
)

func main() {
    server := nine.NewServer(8080)

    server.Get("/hello", func(req *nine.Request, res *nine.Response) error {
        return res.Send([]byte("Hello World"))
    })

    server.Get("/hello/{name}", func(req *nine.Request, res *nine.Response) error {
        name := req.Param("name")
        message := fmt.Sprintf("Hello %s", name)
        return res.Send([]byte(message))
    })

    log.Fatal(server.Listen())
}

Route Handling

You can register routes for different HTTP methods using the Get, Post, Put, Patch, and Delete methods.

server.Post("/create", func(req *nine.Request, res *nine.Response) error {
    return res.Status(http.StatusCreated).Send([]byte("Recurso criado com sucesso"))
})

JSON Handling

The library also provides utilities for working with JSON:

server.Get("/user", func(req *nine.Request, res *nine.Response) error {
    data := nine.JSON{"name": "Alice", "age": 30}
    res.JSON(data)
})

Contributing

Contributions are always welcome! Feel free to open issues and pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for more details.