Documentation

Index

Constants

This section is empty.

Variables

View Source
var File_go_chromium_org_luci_milo_api_service_v1_rpc_proto protoreflect.FileDescriptor

Functions

func FileDescriptorSet

func FileDescriptorSet() *descriptorpb.FileDescriptorSet

FileDescriptorSet returns a descriptor set for this proto package, which includes all defined services, and all transitive dependencies.

Will not return nil.

Do NOT modify the returned descriptor.

func RegisterMiloInternalServer

func RegisterMiloInternalServer(s prpc.Registrar, srv MiloInternalServer)

Types

type GetCurrentUserRequest

type GetCurrentUserRequest struct {
	// contains filtered or unexported fields
}

A request message for `GetCurrentUser` RPC.

func (*GetCurrentUserRequest) Descriptor

func (*GetCurrentUserRequest) Descriptor() ([]byte, []int)

Deprecated: Use GetCurrentUserRequest.ProtoReflect.Descriptor instead.

func (*GetCurrentUserRequest) ProtoMessage

func (*GetCurrentUserRequest) ProtoMessage()

func (*GetCurrentUserRequest) ProtoReflect

func (x *GetCurrentUserRequest) ProtoReflect() protoreflect.Message

func (*GetCurrentUserRequest) Reset

func (x *GetCurrentUserRequest) Reset()

func (*GetCurrentUserRequest) String

func (x *GetCurrentUserRequest) String() string

type GetProjectCfgRequest

type GetProjectCfgRequest struct {

	// The project name.
	Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"`
	// contains filtered or unexported fields
}

func (*GetProjectCfgRequest) Descriptor

func (*GetProjectCfgRequest) Descriptor() ([]byte, []int)

Deprecated: Use GetProjectCfgRequest.ProtoReflect.Descriptor instead.

func (*GetProjectCfgRequest) GetProject

func (x *GetProjectCfgRequest) GetProject() string

func (*GetProjectCfgRequest) ProtoMessage

func (*GetProjectCfgRequest) ProtoMessage()

func (*GetProjectCfgRequest) ProtoReflect

func (x *GetProjectCfgRequest) ProtoReflect() protoreflect.Message

func (*GetProjectCfgRequest) Reset

func (x *GetProjectCfgRequest) Reset()

func (*GetProjectCfgRequest) String

func (x *GetProjectCfgRequest) String() string

type MiloInternalClient

type MiloInternalClient interface {
	// Retrieves blamelist of a build.
	//
	// The blamelist of a build is defined as [end_commit, start_commit)
	// end_commit is the Gitiles commit of the build (specified in gitiles
	// buildset tag).
	// start_commit is the closest ancestor commit with an associated build that
	// is from the same builder and is not expired, cancelled, or infra-failed.
	QueryBlamelist(ctx context.Context, in *QueryBlamelistRequest, opts ...grpc.CallOption) (*QueryBlamelistResponse, error)
	// Gets the current user.
	//
	// Return the current user if user is logged in. Otherwise, return an
	// anonymous user.
	GetCurrentUser(ctx context.Context, in *GetCurrentUserRequest, opts ...grpc.CallOption) (*User, error)
	// Gets the project config.
	//
	// Return the config of the project.
	GetProjectCfg(ctx context.Context, in *GetProjectCfgRequest, opts ...grpc.CallOption) (*config.Project, error)
}

MiloInternalClient is the client API for MiloInternal service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.

func NewMiloInternalPRPCClient

func NewMiloInternalPRPCClient(client *prpc.Client) MiloInternalClient

type MiloInternalServer

type MiloInternalServer interface {
	// Retrieves blamelist of a build.
	//
	// The blamelist of a build is defined as [end_commit, start_commit)
	// end_commit is the Gitiles commit of the build (specified in gitiles
	// buildset tag).
	// start_commit is the closest ancestor commit with an associated build that
	// is from the same builder and is not expired, cancelled, or infra-failed.
	QueryBlamelist(context.Context, *QueryBlamelistRequest) (*QueryBlamelistResponse, error)
	// Gets the current user.
	//
	// Return the current user if user is logged in. Otherwise, return an
	// anonymous user.
	GetCurrentUser(context.Context, *GetCurrentUserRequest) (*User, error)
	// Gets the project config.
	//
	// Return the config of the project.
	GetProjectCfg(context.Context, *GetProjectCfgRequest) (*config.Project, error)
}

MiloInternalServer is the server API for MiloInternal service.

type QueryBlamelistPageToken

type QueryBlamelistPageToken struct {

	// The first commit in the next page.
	NextCommitId string `protobuf:"bytes,2,opt,name=next_commit_id,json=nextCommitId,proto3" json:"next_commit_id,omitempty"`
	// contains filtered or unexported fields
}

A stateless page token for QueryBlamelist RPC.

func (*QueryBlamelistPageToken) Descriptor

func (*QueryBlamelistPageToken) Descriptor() ([]byte, []int)

Deprecated: Use QueryBlamelistPageToken.ProtoReflect.Descriptor instead.

func (*QueryBlamelistPageToken) GetNextCommitId

func (x *QueryBlamelistPageToken) GetNextCommitId() string

func (*QueryBlamelistPageToken) ProtoMessage

func (*QueryBlamelistPageToken) ProtoMessage()

func (*QueryBlamelistPageToken) ProtoReflect

func (x *QueryBlamelistPageToken) ProtoReflect() protoreflect.Message

func (*QueryBlamelistPageToken) Reset

func (x *QueryBlamelistPageToken) Reset()

func (*QueryBlamelistPageToken) String

func (x *QueryBlamelistPageToken) String() string

type QueryBlamelistRequest

type QueryBlamelistRequest struct {

	// The Gitiles commit of the build.
	//
	// This defines the end_commit of the blamelist.
	// It should be set to the output Gitiles commit of the build.
	// Input Gitiles commit should be used when output gitiles commit is not
	// available.
	GitilesCommit *proto.GitilesCommit `protobuf:"bytes,1,opt,name=gitiles_commit,json=gitilesCommit,proto3" json:"gitiles_commit,omitempty"`
	// The context builder of the blamelist.
	//
	// The start commit of the blamelist is the closest ancestor commit with an
	// associated build that is from the same builder and is not expired,
	// cancelled, or infra-failed.
	Builder *proto.BuilderID `protobuf:"bytes,2,opt,name=builder,proto3" json:"builder,omitempty"`
	// Optional. The maximum number of commits to return.
	//
	// The service may return fewer than this value.
	// If unspecified, at most 100 commits will be returned.
	// The maximum value is 1000; values above 1000 will be coerced to 1000.
	PageSize int32 `protobuf:"varint,3,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Optional. A page token, received from a previous `QueryBlamelist` call.
	// Provide this to retrieve the subsequent page.
	//
	// When paginating, all parameters provided to `QueryBlamelist`, with the
	// exception of page_size and page_token, must match the call that provided
	// the page token.
	PageToken string `protobuf:"bytes,4,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// Enable multi-project support.
	//
	// When set to false (default), BuildSummary.BuildSets will be used to find
	// the closest ancestor commit with an associated build.
	// When set to true, BuildSummary.BlamelistPins will be used instead. Older
	// builds may not have BlamelistPins populated.
	// TODO(crbugs/1047893): once all recent builds have BlamelistPins populated,
	// remove this flag and use BlamelistPins unconditionally.
	MultiProjectSupport bool `protobuf:"varint,5,opt,name=multi_project_support,json=multiProjectSupport,proto3" json:"multi_project_support,omitempty"`
	// contains filtered or unexported fields
}

A request message for `QueryBlamelist` RPC.

func (*QueryBlamelistRequest) Descriptor

func (*QueryBlamelistRequest) Descriptor() ([]byte, []int)

Deprecated: Use QueryBlamelistRequest.ProtoReflect.Descriptor instead.

func (*QueryBlamelistRequest) GetBuilder

func (x *QueryBlamelistRequest) GetBuilder() *proto.BuilderID

func (*QueryBlamelistRequest) GetGitilesCommit

func (x *QueryBlamelistRequest) GetGitilesCommit() *proto.GitilesCommit

func (*QueryBlamelistRequest) GetMultiProjectSupport

func (x *QueryBlamelistRequest) GetMultiProjectSupport() bool

func (*QueryBlamelistRequest) GetPageSize

func (x *QueryBlamelistRequest) GetPageSize() int32

func (*QueryBlamelistRequest) GetPageToken

func (x *QueryBlamelistRequest) GetPageToken() string

func (*QueryBlamelistRequest) ProtoMessage

func (*QueryBlamelistRequest) ProtoMessage()

func (*QueryBlamelistRequest) ProtoReflect

func (x *QueryBlamelistRequest) ProtoReflect() protoreflect.Message

func (*QueryBlamelistRequest) Reset

func (x *QueryBlamelistRequest) Reset()

func (*QueryBlamelistRequest) String

func (x *QueryBlamelistRequest) String() string

type QueryBlamelistResponse

type QueryBlamelistResponse struct {

	// The commits from the blamelist of the build, in reverse chronological
	// order.
	Commits []*git.Commit `protobuf:"bytes,1,rep,name=commits,proto3" json:"commits,omitempty"`
	// A token that can be sent as `page_token` to retrieve the next page.
	// If this field is omitted, there are no subsequent pages.
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// The repo commit immediately preceding |commits|. Useful for creating
	// git log queries, which are exclusive of the first commit.
	// Unset when |commits| includes the first commit in the repository.
	PrecedingCommit *git.Commit `protobuf:"bytes,3,opt,name=preceding_commit,json=precedingCommit,proto3" json:"preceding_commit,omitempty"`
	// contains filtered or unexported fields
}

A response message for QueryBlamelist RPC.

func (*QueryBlamelistResponse) Descriptor

func (*QueryBlamelistResponse) Descriptor() ([]byte, []int)

Deprecated: Use QueryBlamelistResponse.ProtoReflect.Descriptor instead.

func (*QueryBlamelistResponse) GetCommits

func (x *QueryBlamelistResponse) GetCommits() []*git.Commit

func (*QueryBlamelistResponse) GetNextPageToken

func (x *QueryBlamelistResponse) GetNextPageToken() string

func (*QueryBlamelistResponse) GetPrecedingCommit

func (x *QueryBlamelistResponse) GetPrecedingCommit() *git.Commit

func (*QueryBlamelistResponse) ProtoMessage

func (*QueryBlamelistResponse) ProtoMessage()

func (*QueryBlamelistResponse) ProtoReflect

func (x *QueryBlamelistResponse) ProtoReflect() protoreflect.Message

func (*QueryBlamelistResponse) Reset

func (x *QueryBlamelistResponse) Reset()

func (*QueryBlamelistResponse) String

func (x *QueryBlamelistResponse) String() string

type UnimplementedMiloInternalServer

type UnimplementedMiloInternalServer struct {
}

UnimplementedMiloInternalServer can be embedded to have forward compatible implementations.

func (*UnimplementedMiloInternalServer) GetCurrentUser

func (*UnimplementedMiloInternalServer) GetProjectCfg

func (*UnimplementedMiloInternalServer) QueryBlamelist

type User

type User struct {

	// Identity string of the user (anonymous:anonymous if the user is not logged
	// in).
	Identity string `protobuf:"bytes,1,opt,name=identity,proto3" json:"identity,omitempty"`
	// The email of the user. Optional, default "".
	Email string `protobuf:"bytes,2,opt,name=email,proto3" json:"email,omitempty"`
	// The URL of the user avatar. Optional, default "".
	Picture string `protobuf:"bytes,3,opt,name=picture,proto3" json:"picture,omitempty"`
	// contains filtered or unexported fields
}

A message that represents identity and profile of a user.

func (*User) Descriptor

func (*User) Descriptor() ([]byte, []int)

Deprecated: Use User.ProtoReflect.Descriptor instead.

func (*User) GetEmail

func (x *User) GetEmail() string

func (*User) GetIdentity

func (x *User) GetIdentity() string

func (*User) GetPicture

func (x *User) GetPicture() string

func (*User) ProtoMessage

func (*User) ProtoMessage()

func (*User) ProtoReflect

func (x *User) ProtoReflect() protoreflect.Message

func (*User) Reset

func (x *User) Reset()

func (*User) String

func (x *User) String() string