Add WithAuth option

Author: csmith

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 1.6.0 - 2025-11-20
+
+- Added `WithAuth` option to pass basic auth credentials.
+
 ## 1.5.0 - 2025-11-06
 
 - Filter out dereferenced tags (thanks @Greboid)

refs.go

@@ -16,10 +16,16 @@ const (
 	tagPrefix   = "refs/tags/"
 )
 
+type auth struct {
+	Username string
+	Password string
+}
+
 type opts struct {
 	ctx      context.Context
 	client   *http.Client
 	tagsOnly bool
+	auth     *auth
 }
 
 type Option func(*opts)
@@ -42,6 +48,15 @@ func WithContext(ctx context.Context) Option {
 	}
 }
 
+func WithAuth(username string, password string) Option {
+	return func(o *opts) {
+		o.auth = &auth{
+			Username: username,
+			Password: password,
+		}
+	}
+}
+
 // Fetch retrieves a list of all refs from the remote repository at the given url.
 func Fetch(url string, options ...Option) (map[string]string, error) {
 	o := &opts{
@@ -59,6 +74,10 @@ func Fetch(url string, options ...Option) (map[string]string, error) {
 		return nil, err
 	}
 
+	if o.auth != nil {
+		req.SetBasicAuth(o.auth.Username, o.auth.Password)
+	}
+
 	res, err := o.client.Do(req)
 	if err != nil {
 		return nil, err