initial version of go-habbo Habbo API client

Author: gerbenjacobs

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/go.yml

@@ -0,0 +1,25 @@
+name: Go
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Set up Go
+      uses: actions/setup-go@v3
+      with:
+        go-version: 1.18
+
+    - name: Build
+      run: go build -v ./...
+
+    - name: Test
+      run: go test -v ./...

.gitignore

@@ -0,0 +1 @@
+/go-habbo

README.md

@@ -0,0 +1,19 @@
+# go-habbo
+
+Library to deal with unofficial Habbo API.
+
+## Installation
+
+    go get github.com/go-habbo/habbo
+
+## Usage
+
+```go
+parser := client.NewParser(http.DefaultClient)
+api := client.NewHabboAPI(parser)
+
+habbo, err := api.GetHabboByName(ctx, "com", "myHabboName")
+if err != nil {
+    // handle error
+}
+```

client.go

@@ -0,0 +1,53 @@
+package client
+
+import (
+	"context"
+	"regexp"
+
+	"github.com/gerbenjacobs/go-habbo/habbo"
+)
+
+var uniqueIdRegexp = regexp.MustCompile(`^hh\w{2}-[a-zA-Z\d]{32}$`)
+
+// HabboParser is an interface that the Habbo API uses to fetch data.
+type HabboParser interface {
+	habbo(ctx context.Context, hotel string, habboID string, byName bool) (*habbo.Habbo, error)
+	profile(ctx context.Context, hotel string, habboID string) (*habbo.Profile, error)
+}
+
+// HabboAPI is a Habbo API client.
+type HabboAPI struct {
+	parser HabboParser
+}
+
+// NewHabboAPI creates a new Habbo API client.
+func NewHabboAPI(parser HabboParser) *HabboAPI {
+	return &HabboAPI{parser: parser}
+}
+
+// GetHabbo fetches a Habbo by ID.
+func (c *HabboAPI) GetHabbo(ctx context.Context, hotel string, habboID string) (*habbo.Habbo, error) {
+	if !habbo.IsValidHotel(hotel) {
+		return nil, ErrInvalidHotel
+	}
+	if !uniqueIdRegexp.MatchString(habboID) {
+		return nil, ErrInvalidUniqueID
+	}
+	return c.parser.habbo(ctx, hotel, habboID, true)
+}
+
+// GetHabboByName fetches a Habbo by name.
+func (c *HabboAPI) GetHabboByName(ctx context.Context, hotel string, habboName string) (*habbo.Habbo, error) {
+	if !habbo.IsValidHotel(hotel) {
+		return nil, ErrInvalidHotel
+	}
+	return c.parser.habbo(ctx, hotel, habboName, false)
+}
+
+// GetProfile fetches a Habbo's profile.
+func (c *HabboAPI) GetProfile(ctx context.Context, hotel string, habboID string) (*habbo.Profile, error) {
+	if !habbo.IsValidHotel(hotel) {
+		return nil, ErrInvalidHotel
+	}
+	return c.parser.profile(ctx, hotel, habboID)
+}