feat(forge): add safe client stringers

Co-Authored-By: Virgil <virgil@lethean.io>

client.go

@@ -159,6 +159,19 @@ func (c *Client) HTTPClient() *http.Client {
 	return c.httpClient
 }
 
+// String returns a safe summary of the client configuration.
+//
+// Usage:
+//
+//	s := client.String()
+func (c *Client) String() string {
+	tokenState := "unset"
+	if c.HasToken() {
+		tokenState = "set"
+	}
+	return core.Concat("forge.Client{baseURL=", strconv.Quote(c.baseURL), ", token=", tokenState, ", userAgent=", strconv.Quote(c.userAgent), "}")
+}
+
 // HasToken reports whether the client was configured with an API token.
 //
 // Usage:

client_test.go

@@ -2,6 +2,7 @@ package forge
 
 import (
 	"context"
+	"fmt"
 	json "github.com/goccy/go-json"
 	"net/http"
 	"net/http/httptest"
@@ -225,6 +226,18 @@ func TestClient_WithHTTPClient_Good(t *testing.T) {
 	}
 }
 
+func TestClient_String_Good(t *testing.T) {
+	c := NewClient("https://forge.lthn.ai", "tok", WithUserAgent("go-forge/1.0"))
+	got := fmt.Sprint(c)
+	want := `forge.Client{baseURL="https://forge.lthn.ai", token=set, userAgent="go-forge/1.0"}`
+	if got != want {
+		t.Fatalf("got %q, want %q", got, want)
+	}
+	if got := c.String(); got != want {
+		t.Fatalf("got String()=%q, want %q", got, want)
+	}
+}
+
 func TestAPIError_Error_Good(t *testing.T) {
 	e := &APIError{StatusCode: 404, Message: "not found", URL: "/api/v1/repos/x/y"}
 	got := e.Error()

forge.go

@@ -110,3 +110,12 @@ func (f *Forge) HTTPClient() *http.Client { return f.client.HTTPClient() }
 //	    _ = "authenticated"
 //	}
 func (f *Forge) HasToken() bool { return f.client.HasToken() }
+
+// String returns a safe summary of the Forge client.
+//
+// Usage:
+//
+//	s := f.String()
+func (f *Forge) String() string {
+	return "forge.Forge{" + f.client.String() + "}"
+}

forge_test.go

@@ -3,6 +3,7 @@ package forge
 import (
 	"bytes"
 	"context"
+	"fmt"
 	json "github.com/goccy/go-json"
 	"net/http"
 	"net/http/httptest"
@@ -81,6 +82,18 @@ func TestForge_HasToken_Bad(t *testing.T) {
 	}
 }
 
+func TestForge_String_Good(t *testing.T) {
+	f := NewForge("https://forge.lthn.ai", "tok", WithUserAgent("go-forge/1.0"))
+	got := fmt.Sprint(f)
+	want := `forge.Forge{forge.Client{baseURL="https://forge.lthn.ai", token=set, userAgent="go-forge/1.0"}}`
+	if got != want {
+		t.Fatalf("got %q, want %q", got, want)
+	}
+	if got := f.String(); got != want {
+		t.Fatalf("got String()=%q, want %q", got, want)
+	}
+}
+
 func TestRepoService_ListOrgRepos_Good(t *testing.T) {
 	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		if r.Method != http.MethodGet {