// 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.5.1 // - 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.64.0 or later. const _ = grpc.SupportPackageIsVersion9 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. // // BlobService allows reading (or uploading) content-addressed blobs of data. // BLAKE3 is used as a hashing function for the data. Uploading a blob will // return the BLAKE3 digest of it, and that's the identifier used to Read/Stat // them too. 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) (grpc.ServerStreamingClient[BlobChunk], 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) (grpc.ClientStreamingClient[BlobChunk, PutBlobResponse], 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) { cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...) out := new(StatBlobResponse) err := c.cc.Invoke(ctx, BlobService_Stat_FullMethodName, in, out, cOpts...) if err != nil { return nil, err } return out, nil } func (c *blobServiceClient) Read(ctx context.Context, in *ReadBlobRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[BlobChunk], error) { cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...) stream, err := c.cc.NewStream(ctx, &BlobService_ServiceDesc.Streams[0], BlobService_Read_FullMethodName, cOpts...) if err != nil { return nil, err } x := &grpc.GenericClientStream[ReadBlobRequest, BlobChunk]{ClientStream: 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 } // This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name. type BlobService_ReadClient = grpc.ServerStreamingClient[BlobChunk] func (c *blobServiceClient) Put(ctx context.Context, opts ...grpc.CallOption) (grpc.ClientStreamingClient[BlobChunk, PutBlobResponse], error) { cOpts := append([]grpc.CallOption{grpc.StaticMethod()}, opts...) stream, err := c.cc.NewStream(ctx, &BlobService_ServiceDesc.Streams[1], BlobService_Put_FullMethodName, cOpts...) if err != nil { return nil, err } x := &grpc.GenericClientStream[BlobChunk, PutBlobResponse]{ClientStream: stream} return x, nil } // This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name. type BlobService_PutClient = grpc.ClientStreamingClient[BlobChunk, PutBlobResponse] // BlobServiceServer is the server API for BlobService service. // All implementations must embed UnimplementedBlobServiceServer // for forward compatibility. // // BlobService allows reading (or uploading) content-addressed blobs of data. // BLAKE3 is used as a hashing function for the data. Uploading a blob will // return the BLAKE3 digest of it, and that's the identifier used to Read/Stat // them too. 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, grpc.ServerStreamingServer[BlobChunk]) 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(grpc.ClientStreamingServer[BlobChunk, PutBlobResponse]) error mustEmbedUnimplementedBlobServiceServer() } // UnimplementedBlobServiceServer must be embedded to have // forward compatible implementations. // // NOTE: this should be embedded by value instead of pointer to avoid a nil // pointer dereference when methods are called. 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, grpc.ServerStreamingServer[BlobChunk]) error { return status.Errorf(codes.Unimplemented, "method Read not implemented") } func (UnimplementedBlobServiceServer) Put(grpc.ClientStreamingServer[BlobChunk, PutBlobResponse]) error { return status.Errorf(codes.Unimplemented, "method Put not implemented") } func (UnimplementedBlobServiceServer) mustEmbedUnimplementedBlobServiceServer() {} func (UnimplementedBlobServiceServer) testEmbeddedByValue() {} // 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) { // If the following call pancis, it indicates UnimplementedBlobServiceServer was // embedded by pointer and is nil. This will cause panics if an // unimplemented method is ever invoked, so we test this at initialization // time to prevent it from happening at runtime later due to I/O. if t, ok := srv.(interface{ testEmbeddedByValue() }); ok { t.testEmbeddedByValue() } 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, &grpc.GenericServerStream[ReadBlobRequest, BlobChunk]{ServerStream: stream}) } // This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name. type BlobService_ReadServer = grpc.ServerStreamingServer[BlobChunk] func _BlobService_Put_Handler(srv interface{}, stream grpc.ServerStream) error { return srv.(BlobServiceServer).Put(&grpc.GenericServerStream[BlobChunk, PutBlobResponse]{ServerStream: stream}) } // This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name. type BlobService_PutServer = grpc.ClientStreamingServer[BlobChunk, PutBlobResponse] // 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", }