67999f0dcf
This pdates the proto docstrings a bit, especially w.r.t. verified streaming. It also adds send_chunks, send_bao fields to StatBlobRequest (renamed from BlobMeta) Change-Id: I590cc8646d86b73bca9f38a9b6d9ea15e4df5cb6 Reviewed-on: https://cl.tvl.fyi/c/depot/+/9951 Tested-by: BuildkiteCI Reviewed-by: raitobezarius <tvl@lahfa.xyz>
288 lines
9.5 KiB
Go
288 lines
9.5 KiB
Go
// SPDX-License-Identifier: MIT
|
|
// Copyright © 2022 The Tvix Authors
|
|
|
|
// Code generated by protoc-gen-go-grpc. DO NOT EDIT.
|
|
// versions:
|
|
// - protoc-gen-go-grpc v1.3.0
|
|
// - protoc (unknown)
|
|
// source: tvix/castore/protos/rpc_blobstore.proto
|
|
|
|
package castorev1
|
|
|
|
import (
|
|
context "context"
|
|
grpc "google.golang.org/grpc"
|
|
codes "google.golang.org/grpc/codes"
|
|
status "google.golang.org/grpc/status"
|
|
)
|
|
|
|
// This is a compile-time assertion to ensure that this generated file
|
|
// is compatible with the grpc package it is being compiled against.
|
|
// Requires gRPC-Go v1.32.0 or later.
|
|
const _ = grpc.SupportPackageIsVersion7
|
|
|
|
const (
|
|
BlobService_Stat_FullMethodName = "/tvix.castore.v1.BlobService/Stat"
|
|
BlobService_Read_FullMethodName = "/tvix.castore.v1.BlobService/Read"
|
|
BlobService_Put_FullMethodName = "/tvix.castore.v1.BlobService/Put"
|
|
)
|
|
|
|
// BlobServiceClient is the client API for BlobService service.
|
|
//
|
|
// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.
|
|
type BlobServiceClient interface {
|
|
// Stat can be used to check for the existence of a blob, as well as
|
|
// gathering more data about it, like more granular chunking information
|
|
// or baos.
|
|
// Server implementations are not required to provide more granular chunking
|
|
// information, especially if the digest specified in [StatBlobRequest] is
|
|
// already a chunk of a blob.
|
|
Stat(ctx context.Context, in *StatBlobRequest, opts ...grpc.CallOption) (*StatBlobResponse, error)
|
|
// Read allows reading (all) data of a blob/chunk by the BLAKE3 digest of
|
|
// its contents.
|
|
// If the backend communicated more granular chunks in the `Stat` request,
|
|
// this can also be used to read chunks.
|
|
// This request returns a stream of BlobChunk, which is just a container for
|
|
// a stream of bytes.
|
|
// The server may decide on whatever chunking it may seem fit as a size for
|
|
// the individual BlobChunk sent in the response stream, this is mostly to
|
|
// keep individual messages at a manageable size.
|
|
Read(ctx context.Context, in *ReadBlobRequest, opts ...grpc.CallOption) (BlobService_ReadClient, error)
|
|
// Put uploads a Blob, by reading a stream of bytes.
|
|
//
|
|
// The way the data is chunked up in individual BlobChunk messages sent in
|
|
// the stream has no effect on how the server ends up chunking blobs up, if
|
|
// it does at all.
|
|
Put(ctx context.Context, opts ...grpc.CallOption) (BlobService_PutClient, error)
|
|
}
|
|
|
|
type blobServiceClient struct {
|
|
cc grpc.ClientConnInterface
|
|
}
|
|
|
|
func NewBlobServiceClient(cc grpc.ClientConnInterface) BlobServiceClient {
|
|
return &blobServiceClient{cc}
|
|
}
|
|
|
|
func (c *blobServiceClient) Stat(ctx context.Context, in *StatBlobRequest, opts ...grpc.CallOption) (*StatBlobResponse, error) {
|
|
out := new(StatBlobResponse)
|
|
err := c.cc.Invoke(ctx, BlobService_Stat_FullMethodName, in, out, opts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return out, nil
|
|
}
|
|
|
|
func (c *blobServiceClient) Read(ctx context.Context, in *ReadBlobRequest, opts ...grpc.CallOption) (BlobService_ReadClient, error) {
|
|
stream, err := c.cc.NewStream(ctx, &BlobService_ServiceDesc.Streams[0], BlobService_Read_FullMethodName, opts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
x := &blobServiceReadClient{stream}
|
|
if err := x.ClientStream.SendMsg(in); err != nil {
|
|
return nil, err
|
|
}
|
|
if err := x.ClientStream.CloseSend(); err != nil {
|
|
return nil, err
|
|
}
|
|
return x, nil
|
|
}
|
|
|
|
type BlobService_ReadClient interface {
|
|
Recv() (*BlobChunk, error)
|
|
grpc.ClientStream
|
|
}
|
|
|
|
type blobServiceReadClient struct {
|
|
grpc.ClientStream
|
|
}
|
|
|
|
func (x *blobServiceReadClient) Recv() (*BlobChunk, error) {
|
|
m := new(BlobChunk)
|
|
if err := x.ClientStream.RecvMsg(m); err != nil {
|
|
return nil, err
|
|
}
|
|
return m, nil
|
|
}
|
|
|
|
func (c *blobServiceClient) Put(ctx context.Context, opts ...grpc.CallOption) (BlobService_PutClient, error) {
|
|
stream, err := c.cc.NewStream(ctx, &BlobService_ServiceDesc.Streams[1], BlobService_Put_FullMethodName, opts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
x := &blobServicePutClient{stream}
|
|
return x, nil
|
|
}
|
|
|
|
type BlobService_PutClient interface {
|
|
Send(*BlobChunk) error
|
|
CloseAndRecv() (*PutBlobResponse, error)
|
|
grpc.ClientStream
|
|
}
|
|
|
|
type blobServicePutClient struct {
|
|
grpc.ClientStream
|
|
}
|
|
|
|
func (x *blobServicePutClient) Send(m *BlobChunk) error {
|
|
return x.ClientStream.SendMsg(m)
|
|
}
|
|
|
|
func (x *blobServicePutClient) CloseAndRecv() (*PutBlobResponse, error) {
|
|
if err := x.ClientStream.CloseSend(); err != nil {
|
|
return nil, err
|
|
}
|
|
m := new(PutBlobResponse)
|
|
if err := x.ClientStream.RecvMsg(m); err != nil {
|
|
return nil, err
|
|
}
|
|
return m, nil
|
|
}
|
|
|
|
// BlobServiceServer is the server API for BlobService service.
|
|
// All implementations must embed UnimplementedBlobServiceServer
|
|
// for forward compatibility
|
|
type BlobServiceServer interface {
|
|
// Stat can be used to check for the existence of a blob, as well as
|
|
// gathering more data about it, like more granular chunking information
|
|
// or baos.
|
|
// Server implementations are not required to provide more granular chunking
|
|
// information, especially if the digest specified in [StatBlobRequest] is
|
|
// already a chunk of a blob.
|
|
Stat(context.Context, *StatBlobRequest) (*StatBlobResponse, error)
|
|
// Read allows reading (all) data of a blob/chunk by the BLAKE3 digest of
|
|
// its contents.
|
|
// If the backend communicated more granular chunks in the `Stat` request,
|
|
// this can also be used to read chunks.
|
|
// This request returns a stream of BlobChunk, which is just a container for
|
|
// a stream of bytes.
|
|
// The server may decide on whatever chunking it may seem fit as a size for
|
|
// the individual BlobChunk sent in the response stream, this is mostly to
|
|
// keep individual messages at a manageable size.
|
|
Read(*ReadBlobRequest, BlobService_ReadServer) error
|
|
// Put uploads a Blob, by reading a stream of bytes.
|
|
//
|
|
// The way the data is chunked up in individual BlobChunk messages sent in
|
|
// the stream has no effect on how the server ends up chunking blobs up, if
|
|
// it does at all.
|
|
Put(BlobService_PutServer) error
|
|
mustEmbedUnimplementedBlobServiceServer()
|
|
}
|
|
|
|
// UnimplementedBlobServiceServer must be embedded to have forward compatible implementations.
|
|
type UnimplementedBlobServiceServer struct {
|
|
}
|
|
|
|
func (UnimplementedBlobServiceServer) Stat(context.Context, *StatBlobRequest) (*StatBlobResponse, error) {
|
|
return nil, status.Errorf(codes.Unimplemented, "method Stat not implemented")
|
|
}
|
|
func (UnimplementedBlobServiceServer) Read(*ReadBlobRequest, BlobService_ReadServer) error {
|
|
return status.Errorf(codes.Unimplemented, "method Read not implemented")
|
|
}
|
|
func (UnimplementedBlobServiceServer) Put(BlobService_PutServer) error {
|
|
return status.Errorf(codes.Unimplemented, "method Put not implemented")
|
|
}
|
|
func (UnimplementedBlobServiceServer) mustEmbedUnimplementedBlobServiceServer() {}
|
|
|
|
// UnsafeBlobServiceServer may be embedded to opt out of forward compatibility for this service.
|
|
// Use of this interface is not recommended, as added methods to BlobServiceServer will
|
|
// result in compilation errors.
|
|
type UnsafeBlobServiceServer interface {
|
|
mustEmbedUnimplementedBlobServiceServer()
|
|
}
|
|
|
|
func RegisterBlobServiceServer(s grpc.ServiceRegistrar, srv BlobServiceServer) {
|
|
s.RegisterService(&BlobService_ServiceDesc, srv)
|
|
}
|
|
|
|
func _BlobService_Stat_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
|
|
in := new(StatBlobRequest)
|
|
if err := dec(in); err != nil {
|
|
return nil, err
|
|
}
|
|
if interceptor == nil {
|
|
return srv.(BlobServiceServer).Stat(ctx, in)
|
|
}
|
|
info := &grpc.UnaryServerInfo{
|
|
Server: srv,
|
|
FullMethod: BlobService_Stat_FullMethodName,
|
|
}
|
|
handler := func(ctx context.Context, req interface{}) (interface{}, error) {
|
|
return srv.(BlobServiceServer).Stat(ctx, req.(*StatBlobRequest))
|
|
}
|
|
return interceptor(ctx, in, info, handler)
|
|
}
|
|
|
|
func _BlobService_Read_Handler(srv interface{}, stream grpc.ServerStream) error {
|
|
m := new(ReadBlobRequest)
|
|
if err := stream.RecvMsg(m); err != nil {
|
|
return err
|
|
}
|
|
return srv.(BlobServiceServer).Read(m, &blobServiceReadServer{stream})
|
|
}
|
|
|
|
type BlobService_ReadServer interface {
|
|
Send(*BlobChunk) error
|
|
grpc.ServerStream
|
|
}
|
|
|
|
type blobServiceReadServer struct {
|
|
grpc.ServerStream
|
|
}
|
|
|
|
func (x *blobServiceReadServer) Send(m *BlobChunk) error {
|
|
return x.ServerStream.SendMsg(m)
|
|
}
|
|
|
|
func _BlobService_Put_Handler(srv interface{}, stream grpc.ServerStream) error {
|
|
return srv.(BlobServiceServer).Put(&blobServicePutServer{stream})
|
|
}
|
|
|
|
type BlobService_PutServer interface {
|
|
SendAndClose(*PutBlobResponse) error
|
|
Recv() (*BlobChunk, error)
|
|
grpc.ServerStream
|
|
}
|
|
|
|
type blobServicePutServer struct {
|
|
grpc.ServerStream
|
|
}
|
|
|
|
func (x *blobServicePutServer) SendAndClose(m *PutBlobResponse) error {
|
|
return x.ServerStream.SendMsg(m)
|
|
}
|
|
|
|
func (x *blobServicePutServer) Recv() (*BlobChunk, error) {
|
|
m := new(BlobChunk)
|
|
if err := x.ServerStream.RecvMsg(m); err != nil {
|
|
return nil, err
|
|
}
|
|
return m, nil
|
|
}
|
|
|
|
// BlobService_ServiceDesc is the grpc.ServiceDesc for BlobService service.
|
|
// It's only intended for direct use with grpc.RegisterService,
|
|
// and not to be introspected or modified (even as a copy)
|
|
var BlobService_ServiceDesc = grpc.ServiceDesc{
|
|
ServiceName: "tvix.castore.v1.BlobService",
|
|
HandlerType: (*BlobServiceServer)(nil),
|
|
Methods: []grpc.MethodDesc{
|
|
{
|
|
MethodName: "Stat",
|
|
Handler: _BlobService_Stat_Handler,
|
|
},
|
|
},
|
|
Streams: []grpc.StreamDesc{
|
|
{
|
|
StreamName: "Read",
|
|
Handler: _BlobService_Read_Handler,
|
|
ServerStreams: true,
|
|
},
|
|
{
|
|
StreamName: "Put",
|
|
Handler: _BlobService_Put_Handler,
|
|
ClientStreams: true,
|
|
},
|
|
},
|
|
Metadata: "tvix/castore/protos/rpc_blobstore.proto",
|
|
}
|