gitlab

package

Go to main page

Versions in this module

v3

v3.4.0

Oct 30, 2026

Changes in this version

+ var ErrRequestPathRefused = errors.New("request path refused")

+ type DotSegment struct

+ Decoded bool

+ Name string

+ func HasDotSegment(text string) (DotSegment, bool)

+ func (s DotSegment) String() string

v3.3.0

Oct 20, 2026

Changes in this version

+ const MembershipTierQuery

+ const MetadataRefusedHint

+ var ErrMetadataDestinationRefused error = metadataRefusalError

+ func DestinationRefusedHintFor(err error) string

+ func FoldHostCase(host string) string

type Client

+ func (c *Client) AtLeast(ctx context.Context, major, minor int) bool

+ func (c *Client) BearerToken() gl.RequestOptionFunc

+ func (c *Client) SendsBearer() bool

v3.2.0

Oct 9, 2026

Changes in this version

+ const GrantMaxBytes

+ const GrantMaxScopes

+ const GranularNotFound

+ const GranularScopeRefusalCode

+ const ScopeGranular

+ const ScopeReadAPI

+ func AuthorityFrom(ctx context.Context) *finegrained.Authority

+ func BelowMinimum(facts TokenFacts) bool

+ func CatalogScopes(scopes []string) []string

+ func FineGrained(scopes []string) bool

+ func MeetsMinimum(scopes []string) bool

+ func MissingClassicScopes(need finegrained.ClassicScope, groupScopes, tokenScopes []string, ...) (byGitLab, byServer []string)

+ func PermissionRefusal(body []byte) (string, bool)

+ func ReadGrant(ctx context.Context, client *gl.Client, id int64) (finegrained.Grant, finegrained.FallbackReason, error)

+ func VersionRefusedForScope(err error) bool

+ func WithResponseLimit(ctx context.Context, n int64) context.Context

type Client

+ func (c *Client) Authority() *finegrained.Authority

+ func (c *Client) ReadFineGrained(ctx context.Context, facts TokenFacts) finegrained.Reading

+ func (c *Client) ReadFineGrainedAt(ctx context.Context, facts TokenFacts, version string) finegrained.Reading

+ func (c *Client) ReadVersion(ctx context.Context) (string, bool)

+ func (c *Client) RefreshAuthority(ctx context.Context, facts TokenFacts, table *finegrained.Table) (moved *finegrained.Authority, kept string)

+ func (c *Client) SetAuthority(authority *finegrained.Authority)

+ func (c *Client) SetOnRecovered(fn func())

+ func (c *Client) Version() string

+ func (c *Client) VersionRefusal() (string, bool)

type CredentialCheck

+ Description string

type CredentialVerdict

+ const CredentialAcceptedBelowMinimum

+ const CredentialAcceptedPermissionMissing

+ type GranularRefusal struct

+ Boundary string

+ Kind GranularRefusalKind

+ Permissions []string

+ TokenType string

+ func ParseGranularRefusal(sentence string) GranularRefusal

+ func ParseGraphQLGranularRefusal(message string) GranularRefusal

+ type GranularRefusalKind uint8

+ const GranularRefusalDisabled

+ const GranularRefusalMissingPermissions

+ const GranularRefusalNotFound

+ const GranularRefusalUnrecognized

+ const GranularRefusalUnsupported

+ type TokenFacts struct

+ FineGrained bool

+ GrantReadable bool

+ ID int64

+ KindUnknown bool

+ Scopes []string

+ func DescribeToken(ctx context.Context, client *gl.Client) TokenFacts

+ func DetectToken(ctx context.Context, client *gl.Client) TokenFacts

+ func FactsFromScopes(scopes []string, id int64) TokenFacts

+ func RedetectToken(ctx context.Context, client *gl.Client) TokenFacts

v3.1.0

Sep 30, 2026

Changes in this version

+ func RefusalMayBePermission(status int, req *http.Request, body []byte) bool

+ func UnauthorizedNamesCredential(req *http.Request, body []byte) bool

type Client

+ func (c *Client) CheckCredential(ctx context.Context) CredentialVerdict

+ func (c *Client) CheckCredentialDetail(ctx context.Context) CredentialCheck

+ func (c *Client) PinTier(t edition.Tier)

+ func (c *Client) TierPinned() bool

+ type CredentialCheck struct

+ Err error

+ Status int

+ Verdict CredentialVerdict

+ type CredentialVerdict uint8

+ const CredentialAccepted

+ const CredentialRefused

+ const CredentialUnanswered

+ type UnauthorizedAnswer uint8

+ const UnauthorizedCredential

+ const UnauthorizedUnexplained

v3.0.0

Sep 10, 2026

Changes in this version

+ const AllowPrivateInstancesEnv

+ const DefaultMaxResponseBytes

+ const DestinationRefusedHint

+ const GitLabDotComHost

+ const ScopeAPI

+ var ErrDestinationRefused = errors.New("outbound destination refused")

+ var ErrNoResponseCaptured = errors.New("no response was captured")

+ var ErrResponseTooLarge = errors.New("gitlab response exceeded the maximum size")

+ var ErrUnboundClient = errors.New(...)

+ func CheckCallerNamedInstance(rawURL string) error

+ func DetectScopes(ctx context.Context, client *gl.Client) []string

+ func HTTPTransport(skipTLSVerify bool) http.RoundTripper

+ func IsCredentialRejection(err error) bool

+ func IsGitLabDotComURL(rawURL string) bool

+ func NarrowToTokenScope(cfg *config.ServerConfig) bool

+ func ScopeSatisfied(tokenScopes, requiredScopes []string) bool

+ func WithClient(ctx context.Context, c *Client) context.Context

+ func WriteCapable(scopes []string) bool

+ type Client struct

+ func ClientFrom(ctx context.Context) (*Client, bool)

+ func NewClient(cfg *config.Config) (*Client, error)

+ func NewClientWithToken(baseURL, token string, skipTLSVerify bool) (*Client, error)

+ func NewClientWithTokenRetries(baseURL, token string, skipTLSVerify, disableRetries bool) (*Client, error)

+ func NewOAuthClientWithToken(baseURL, token string, skipTLSVerify bool) (*Client, error)

+ func NewUnboundClient(baseURL string) *Client

+ func (c *Client) CredentialRejected(ctx context.Context) bool

+ func (c *Client) CurrentUser(ctx context.Context) (*CurrentUserInfo, error)

+ func (c *Client) CurrentUsername(ctx context.Context) (string, error)

+ func (c *Client) DetectEnterprise(ctx context.Context, fallback bool) bool

+ func (c *Client) DetectTier(ctx context.Context) edition.Tier

+ func (c *Client) EnableLazyInit()

+ func (c *Client) EnsureInitialized(ctx context.Context)

+ func (c *Client) For(ctx context.Context) *Client

+ func (c *Client) GL() *gl.Client

+ func (c *Client) Initialize(ctx context.Context) (string, error)

+ func (c *Client) IsEnterprise() bool

+ func (c *Client) IsGitLabDotCom() bool

+ func (c *Client) IsInitialized() bool

+ func (c *Client) IsUnbound() bool

+ func (c *Client) MarkInitialized()

+ func (c *Client) MarkInstanceCallerNamed()

+ func (c *Client) Ping(ctx context.Context) (string, error)

+ func (c *Client) SetEnterprise(v bool)

+ func (c *Client) SetMaxResponseBytes(n int64)

+ func (c *Client) SetOnUnauthorized(fn func())

+ func (c *Client) SetTier(t edition.Tier)

+ func (c *Client) Tier() edition.Tier

+ type CurrentUserInfo struct

+ UserID int

+ Username string

+ type ResponseCapture struct

+ func CapturedBody(body []byte) *ResponseCapture

+ func WithResponseCapture(ctx context.Context) (context.Context, *ResponseCapture)

+ func (c *ResponseCapture) Decode(v any) error

Other modules containing this package

github.com/jmrplens/gitlab-mcp-server

github.com/jmrplens/gitlab-mcp-server/v2

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL