hub

package
v0.4.6 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 27, 2024 License: Apache-2.0 Imports: 21 Imported by: 6

Documentation

Index

Constants

View Source 
const (
	// LoginURL path to the Hub login URL
	LoginURL = "/v2/users/login?refresh_token=true"
	// TwoFactorLoginURL path to the 2FA
	TwoFactorLoginURL = "/v2/users/2fa-login?refresh_token=true"
	// SecondFactorDetailMessage returned by login if 2FA is enabled
	SecondFactorDetailMessage = "Require secondary authentication on MFA enabled account"
)
View Source 
const (
	//MembersURL path to the Hub API listing the members in an organization
	MembersURL = "/v2/orgs/%s/members/"
	//MembersPerTeamURL path to the Hub API listing the members in a team
	MembersPerTeamURL = "/v2/orgs/%s/groups/%s/members/"
)
View Source 
const (
	// OrganizationsURL path to the Hub API listing the organizations
	OrganizationsURL = "/v2/user/orgs/"
	// OrganizationInfoURL path to the Hub API returning organization info
	OrganizationInfoURL = "/v2/orgs/%s"
)
View Source 
const (
	//HubPlanURL path to the billing API returning the account hub plan
	HubPlanURL = "/api/billing/v4/accounts/%s/hub-plan"
	//TeamPlan refers to a hub team paid account
	TeamPlan = "team"
	//ProPlan refers to a hub individual paid account
	ProPlan = "pro"
	//FreePlan refers to a hub non-paid account
	FreePlan = "free"
)
View Source 
const (
	// TagsURL path to the Hub API listing the tags
	TagsURL = "/v2/repositories/%s/tags/"
	// DeleteTagURL path to the Hub API to remove a tag
	DeleteTagURL = "/v2/repositories/%s/tags/%s/"
)
View Source 
const (
	// TokensURL path to the Hub API listing the Personal Access Tokens
	TokensURL = "/v2/api_tokens"
	// TokenURL path to the Hub API Personal Access Token
	TokenURL = "/v2/api_tokens/%s"
)
View Source 
const (
	//GroupsURL path to the Hub API listing the groups in an organization
	GroupsURL = "/v2/orgs/%s/groups/"
)
View Source 
const (
	//ImageType is the classic image type
	ImageType = RepositoryType("image")
)
View Source 
const (
	// RepositoriesURL is the Hub API base URL
	RepositoriesURL = "/v2/repositories/"
)
View Source 
const (
	//UserURL path to user informations
	UserURL = "/v2/user/"
)

Variables

This section is empty.

Functions

func IsAuthenticationError 

func IsAuthenticationError(err error) bool

IsAuthenticationError check if the error type is an authentication error

func IsForbiddenError 

func IsForbiddenError(err error) bool

IsForbiddenError check if the error type is a forbidden error

func IsInvalidTokenError 

func IsInvalidTokenError(err error) bool

IsInvalidTokenError check if the error type is an invalid token error

func IsNotFoundError added in v0.4.5 

func IsNotFoundError(err error) bool

IsNotFoundError check if the error type is a not found error

func SetURLs 

func SetURLs(newFirst, newSecond string)

SetURLs change the base urls used to check ratelimiting values

Types

type Account 

type Account struct {
	ID       string
	Name     string
	FullName string
	Location string
	Company  string
	Joined   time.Time
}

Account represents a user or organization information

type Client 

type Client struct {
	AuthConfig registry.AuthConfig
	Ctx        context.Context
	// contains filtered or unexported fields
}

Client sends authenticated calls to the Hub API

func NewClient 

func NewClient(ops ...ClientOp) (*Client, error)

NewClient logs the user to the hub and returns a client which can send authenticated requests to the Hub API

func (*Client) CreateToken 

func (c *Client) CreateToken(description string) (*Token, error)

CreateToken creates a Personal Access Token and returns the token field only once

func (*Client) GetHubPlan 

func (c *Client) GetHubPlan(accountID string) (*Plan, error)

GetHubPlan returns an account current Hub plan

func (*Client) GetMembers 

func (c *Client) GetMembers(organization string) ([]Member, error)

GetMembers lists all the members in an organization

func (*Client) GetMembersCount 

func (c *Client) GetMembersCount(organization string) (int, error)

GetMembersCount return the number of members in an organization

func (*Client) GetMembersPerTeam 

func (c *Client) GetMembersPerTeam(organization, team string) ([]Member, error)

GetMembersPerTeam returns the members of a team in an organization

func (*Client) GetOrgConsumption 

func (c *Client) GetOrgConsumption(org string) (*Consumption, error)

GetOrgConsumption return the current organization consumption

func (*Client) GetOrganizationInfo 

func (c *Client) GetOrganizationInfo(orgname string) (*Account, error)

GetOrganizationInfo returns organization info

func (*Client) GetOrganizations 

func (c *Client) GetOrganizations(ctx context.Context) ([]Organization, error)

GetOrganizations lists all the organizations a user has joined

func (*Client) GetRateLimits 

func (c *Client) GetRateLimits() (*RateLimits, error)

GetRateLimits returns the rate limits for the user

func (*Client) GetRepositories 

func (c *Client) GetRepositories(account string) ([]Repository, int, error)

GetRepositories lists all the repositories a user can access

func (*Client) GetTags 

func (c *Client) GetTags(repository string, reqOps ...RequestOp) ([]Tag, int, error)

GetTags calls the hub repo API and returns all the information on all tags

func (*Client) GetTeams 

func (c *Client) GetTeams(organization string) ([]Team, error)

GetTeams lists all the teams in an organization

func (*Client) GetTeamsCount 

func (c *Client) GetTeamsCount(organization string) (int, error)

GetTeamsCount returns the number of teams in an organization

func (*Client) GetToken 

func (c *Client) GetToken(tokenUUID string) (*Token, error)

GetToken calls the hub repo API and returns the information on one token

func (*Client) GetTokens 

func (c *Client) GetTokens() ([]Token, int, error)

GetTokens calls the hub repo API and returns all the information on all tokens

func (*Client) GetUserConsumption 

func (c *Client) GetUserConsumption(user string) (*Consumption, error)

GetUserConsumption return the current user consumption

func (*Client) GetUserInfo 

func (c *Client) GetUserInfo() (*Account, error)

GetUserInfo returns the information on the user retrieved from Hub

func (*Client) Login 

func (c *Client) Login(username string, password string, twoFactorCodeProvider func() (string, error)) (string, string, error)

Login tries to authenticate, it will call the twoFactorCodeProvider if the user has 2FA activated

func (*Client) RemoveRepository 

func (c *Client) RemoveRepository(repository string) error

RemoveRepository removes a repository on Hub

func (*Client) RemoveTag 

func (c *Client) RemoveTag(repository, tag string) error

RemoveTag removes a tag in a repository on Hub

func (*Client) RemoveToken 

func (c *Client) RemoveToken(tokenUUID string) error

RemoveToken deletes a token from personal access token

func (*Client) Update 

func (c *Client) Update(ops ...ClientOp) error

Update changes client behavior using ClientOp

func (*Client) UpdateToken 

func (c *Client) UpdateToken(tokenUUID, description string, isActive bool) (*Token, error)

UpdateToken updates a token's description and activeness

type ClientOp 

type ClientOp func(*Client) error

ClientOp represents an option given to NewClient constructor to customize client behavior.

func WithAllElements 

func WithAllElements() ClientOp

WithAllElements makes the client fetch all the elements it can find, enabling pagination.

func WithContext 

func WithContext(ctx context.Context) ClientOp

WithContext set the client context

func WithHTTPClient added in v0.4.4 

func WithHTTPClient(client *http.Client) ClientOp

WithHTTPClient sets the *http.Client for the client

func WithHubAccount 

func WithHubAccount(account string) ClientOp

WithHubAccount sets the current account name

func WithHubToken 

func WithHubToken(token string) ClientOp

WithHubToken sets the bearer token to the client

func WithInStream 

func WithInStream(in io.Reader) ClientOp

WithInStream sets the input stream

func WithOutStream 

func WithOutStream(out io.Writer) ClientOp

WithOutStream sets the output stream

func WithPassword 

func WithPassword(password string) ClientOp

WithPassword sets the password to the client

func WithRefreshToken 

func WithRefreshToken(refreshToken string) ClientOp

WithRefreshToken sets the refresh token to the client

type Consumption 

type Consumption struct {
	Seats               int
	PrivateRepositories int
	Teams               int
}

Consumption represents current user or org consumption

type Image 

type Image struct {
	Digest       string
	Architecture string
	Os           string
	Variant      string
	Size         int
	LastPulled   time.Time
	LastPushed   time.Time
	Status       string
}

Image represents the metadata of a manifest

type Instance 

type Instance struct {
	APIHubBaseURL string
	RegistryInfo  *registry.IndexInfo
}

Instance stores all the specific pieces needed to dialog with Hub

type Limits 

type Limits struct {
	Seats          int
	PrivateRepos   int
	Teams          int
	Collaborators  int
	ParallelBuilds int
}

Limits represents the current account limits

type Member 

type Member struct {
	Username string `json:"username"`
	FullName string `json:"full_name"`
}

Member is a user part of an organization

type Organization 

type Organization struct {
	Namespace string
	FullName  string
	Role      string
	Teams     []Team
	Members   []Member
}

Organization represents a Docker Hub organization

type Plan 

type Plan struct {
	Name   string
	Limits Limits
}

Plan represents the current account Hub plan

type RateLimits 

type RateLimits struct {
	Limit           *int    `json:",omitempty"`
	LimitWindow     *int    `json:",omitempty"`
	Remaining       *int    `json:",omitempty"`
	RemainingWindow *int    `json:",omitempty"`
	Source          *string `json:",omitempty"`
}

RateLimits ...

type Repository 

type Repository struct {
	Name        string
	Description string
	LastUpdated time.Time
	PullCount   int
	StarCount   int
	IsPrivate   bool
}

Repository represents a Docker Hub repository

type RepositoryType 

type RepositoryType string

RepositoryType lists all the different repository types handled by the Docker Hub

type RequestOp 

type RequestOp func(r *http.Request) error

RequestOp represents an option to customize the request sent to the Hub API

func WithSortingOrder 

func WithSortingOrder(order string) RequestOp

WithSortingOrder adds a sorting order query parameter to the request

type Tag 

type Tag struct {
	Name                string
	FullSize            int
	LastUpdated         time.Time
	LastUpdaterUserName string
	Images              []Image
	LastPulled          time.Time
	LastPushed          time.Time
	Status              string
}

Tag can point to a manifest or manifest list

type Team 

type Team struct {
	Name        string
	Description string
	Members     []Member
}

Team represents a hub group in an organization

type Token 

type Token struct {
	UUID        uuid.UUID
	ClientID    string
	CreatorIP   string
	CreatorUA   string
	CreatedAt   time.Time
	LastUsed    time.Time
	GeneratedBy string
	IsActive    bool
	Token       string
	Description string
}

Token is a personal access token. The token field will only be filled at creation and can never been accessed again.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.