Setup: Initial files (#1)

Author: LucJosin

.github/workflows/coverage.yml

@@ -0,0 +1,33 @@
+name: "Go Coverage"
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  coverage:
+    # Ignore drafts
+    if: github.event.pull_request.draft == false
+    name: Go test with coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 10
+
+      - name: Set up Golang
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+
+      - name: Install dependencies
+        run: go mod tidy
+
+      - uses: gwatts/go-coverage-action@v2
+        id: coverage
+        with:
+          coverage-threshold: 60
+          cover-pkg: ./...

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Create Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Golang
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+
+      - name: Install dependencies
+        run: go mod tidy
+
+      - name: Testing
+        run: go test -v ./...
+
+      - name: Publish to pkg.go.dev
+        run: |
+          echo "VERSION=${{ github.ref_name }}"
+          GOPROXY=proxy.golang.org go list -m github.com/HawAPI/go-sdk@${{ github.ref_name }}

.idea/.gitignore

@@ -1,2 +1,117 @@
-# go-sdk
+# HawAPI - go-sdk
+
 HawAPI SDK for Golang
+
+- [API Docs](https://hawapi.theproject.id/docs/)
+- [SDK Docs](https://pkg.go.dev/github.com/HawAPI/go-sdk)
+
+## Topics
+
+- [Installation](#installation)
+- [Usage](#usage)
+    - [Init client](#init-client)
+    - [Fetch information](#fetch-information)
+    - [Error handling](#error-handling)
+
+## Installation
+
+```
+go get github.com/HawAPI/go-sdk@latest
+```
+
+## Usage
+
+- [See examples](./examples)
+
+### Init client
+
+```go
+package main
+
+import (
+  "fmt"
+
+  "github.com/HawAPI/go-sdk"
+)
+
+func main() {
+    // Create a new client with default options
+    client := hawapi.NewClient()
+    
+    // Create client with custom options
+    client = hawapi.NewClientWithOpts(hawapi.Options{
+        Endpoint: "http://localhost:8080/api",
+        // When using 'WithOpts' or 'NewClientWithOpts' the value of
+        // 'UseInMemoryCache' will be set to false
+        UseInMemoryCache: true,
+        // Version
+        // Language
+        // Token
+        // ...
+    })
+	
+    // You can also change the options later
+    client.WithOpts(hawapi.Options{
+        Language: "pt-BR",
+        // When using 'WithOpts' or 'NewClientWithOpts' the value of
+        // 'UseInMemoryCache' will be set to false
+        UseInMemoryCache: true,
+    })
+}
+```
+
+### Fetch information
+
+```go
+package main
+
+import (
+  "fmt"
+
+  "github.com/HawAPI/go-sdk"
+)
+
+func main() {
+    client := hawapi.NewClient()
+    
+    res, err := client.ListActors()
+    if err != nil {
+        panic(err)
+    }
+    
+    fmt.Println(res)
+}
+```
+
+### Error handling
+
+- Check out the [hawapi.ErrorResponse](./pkg/hawapi/error.go)
+
+```go
+package main
+
+import (
+	"fmt"
+
+	"github.com/HawAPI/go-sdk"
+	"github.com/google/uuid"
+)
+
+func main() {
+    client := hawapi.NewClient()
+    
+    id, _ := uuid.Parse("<unknown uuid>")
+    res, err := client.FindActor(id)
+    if err != nil {
+        // If the error is coming from the API request, 
+        // it'll be of type hawapi.ErrorResponse.
+        if resErr, ok := err.(hawapi.ErrorResponse); ok {
+            fmt.Printf("API error %d Message: %s\n", resErr.Code, resErr.Message)
+        } else {
+            fmt.Println("SDK error:", err)
+        }
+    }
+    
+    fmt.Println(res)
+}
+```