gitaly 15.0.0.pre.rc2 → 15.0.0.pre.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7314e721c1446413c74605d6e1a4d0f71e3cc2c3f298e631675a960f8798b9b
-  data.tar.gz: 0d4660c5effa6c7437b946c99f75810edbb8ba7640d09257ca82122aeb2b22e7
+  metadata.gz: e7e733116309c6a8bfd647c20c776333d44e8ce757dbfd41bb5a3241a612d0a8
+  data.tar.gz: 8c09558f5ebf6136b564808cab3a45c988957bb2faa7b8516022e9f3839f7e1e
 SHA512:
-  metadata.gz: 70e8307d998ebce708648e3a53d13e7500f56bbf4f6aaf04a3b6b581ad4393f531d59c3e130c069120bfc8cd778128dcfa159f042c83b097347e53b1595c9db2
-  data.tar.gz: 63c0d62f5e6585508aeaf406866615ec80891f8a672f670ff081c4d208ea434d2f904e413b817c9bea45e3db151e1445e8b6877dd3e4f3c7879c8fe90b1383e6
+  metadata.gz: 3129a09a6ab17110afdaf41dc91e0df04a0a4596e241eb3a962ac4fc90b64e2bbdcd8a8ebcecbe06d821832744b4576ad4624fa0152c5d64479217e5198e3306
+  data.tar.gz: 77823d9ccc24ffa9f628d31bf25c987e2af37f9826b7234568fac9f6ee166015c4131096a98f6c2ea80ef584f72138b6741a9a787636c9e4f9b412e29cc6eefb

data/ruby/proto/gitaly/blob_services_pb.rb

@@ -6,6 +6,8 @@ require 'blob_pb'
 
 module Gitaly
   module BlobService
+    # BlobService is a service which provides RPCs to retrieve Git blobs from a
+    # specific repository.
     class Service
 
       include ::GRPC::GenericService
@@ -18,6 +20,7 @@ module Gitaly
       # ID. We use a stream to return a chunked arbitrarily large binary
       # response
       rpc :GetBlob, ::Gitaly::GetBlobRequest, stream(::Gitaly::GetBlobResponse)
+      # This comment is left unintentionally blank.
       rpc :GetBlobs, ::Gitaly::GetBlobsRequest, stream(::Gitaly::GetBlobsResponse)
       # ListBlobs will list all blobs reachable from a given set of revisions by
       # doing a graph walk. It is not valid to pass revisions which do not resolve

data/ruby/proto/gitaly/cleanup_services_pb.rb

@@ -6,6 +6,7 @@ require 'cleanup_pb'
 
 module Gitaly
   module CleanupService
+    # CleanupService provides RPCs to clean up a repository's contents.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +15,7 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.CleanupService'
 
+      # This comment is left unintentionally blank.
       rpc :ApplyBfgObjectMapStream, stream(::Gitaly::ApplyBfgObjectMapStreamRequest), stream(::Gitaly::ApplyBfgObjectMapStreamResponse)
     end
 

data/ruby/proto/gitaly/commit_pb.rb

@@ -20,6 +20,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :after, :message, 8, "google.protobuf.Timestamp"
       optional :before, :message, 9, "google.protobuf.Timestamp"
       optional :author, :bytes, 10
+      optional :ignore_case, :bool, 12
+      repeated :commit_message_patterns, :bytes, 13
     end
     add_enum "gitaly.ListCommitsRequest.Order" do
       value :NONE, 0

data/ruby/proto/gitaly/commit_services_pb.rb

@@ -6,6 +6,8 @@ require 'commit_pb'
 
 module Gitaly
   module CommitService
+    # CommitService is a service which provides RPCs that interact with Git
+    # commits.
     class Service
 
       include ::GRPC::GenericService
@@ -21,26 +23,45 @@ module Gitaly
       # ListAllCommits lists all commits present in the repository, including
       # those not reachable by any reference.
       rpc :ListAllCommits, ::Gitaly::ListAllCommitsRequest, stream(::Gitaly::ListAllCommitsResponse)
+      # This comment is left unintentionally blank.
       rpc :CommitIsAncestor, ::Gitaly::CommitIsAncestorRequest, ::Gitaly::CommitIsAncestorResponse
+      # This comment is left unintentionally blank.
       rpc :TreeEntry, ::Gitaly::TreeEntryRequest, stream(::Gitaly::TreeEntryResponse)
+      # This comment is left unintentionally blank.
       rpc :CountCommits, ::Gitaly::CountCommitsRequest, ::Gitaly::CountCommitsResponse
+      # This comment is left unintentionally blank.
       rpc :CountDivergingCommits, ::Gitaly::CountDivergingCommitsRequest, ::Gitaly::CountDivergingCommitsResponse
+      # This comment is left unintentionally blank.
       rpc :GetTreeEntries, ::Gitaly::GetTreeEntriesRequest, stream(::Gitaly::GetTreeEntriesResponse)
+      # This comment is left unintentionally blank.
       rpc :ListFiles, ::Gitaly::ListFilesRequest, stream(::Gitaly::ListFilesResponse)
+      # This comment is left unintentionally blank.
       rpc :FindCommit, ::Gitaly::FindCommitRequest, ::Gitaly::FindCommitResponse
+      # This comment is left unintentionally blank.
       rpc :CommitStats, ::Gitaly::CommitStatsRequest, ::Gitaly::CommitStatsResponse
       # Use a stream to paginate the result set
       rpc :FindAllCommits, ::Gitaly::FindAllCommitsRequest, stream(::Gitaly::FindAllCommitsResponse)
+      # This comment is left unintentionally blank.
       rpc :FindCommits, ::Gitaly::FindCommitsRequest, stream(::Gitaly::FindCommitsResponse)
+      # This comment is left unintentionally blank.
       rpc :CommitLanguages, ::Gitaly::CommitLanguagesRequest, ::Gitaly::CommitLanguagesResponse
+      # This comment is left unintentionally blank.
       rpc :RawBlame, ::Gitaly::RawBlameRequest, stream(::Gitaly::RawBlameResponse)
+      # This comment is left unintentionally blank.
       rpc :LastCommitForPath, ::Gitaly::LastCommitForPathRequest, ::Gitaly::LastCommitForPathResponse
+      # This comment is left unintentionally blank.
       rpc :ListLastCommitsForTree, ::Gitaly::ListLastCommitsForTreeRequest, stream(::Gitaly::ListLastCommitsForTreeResponse)
+      # This comment is left unintentionally blank.
       rpc :CommitsByMessage, ::Gitaly::CommitsByMessageRequest, stream(::Gitaly::CommitsByMessageResponse)
+      # This comment is left unintentionally blank.
       rpc :ListCommitsByOid, ::Gitaly::ListCommitsByOidRequest, stream(::Gitaly::ListCommitsByOidResponse)
+      # This comment is left unintentionally blank.
       rpc :ListCommitsByRefName, ::Gitaly::ListCommitsByRefNameRequest, stream(::Gitaly::ListCommitsByRefNameResponse)
+      # This comment is left unintentionally blank.
       rpc :FilterShasWithSignatures, stream(::Gitaly::FilterShasWithSignaturesRequest), stream(::Gitaly::FilterShasWithSignaturesResponse)
+      # This comment is left unintentionally blank.
       rpc :GetCommitSignatures, ::Gitaly::GetCommitSignaturesRequest, stream(::Gitaly::GetCommitSignaturesResponse)
+      # This comment is left unintentionally blank.
       rpc :GetCommitMessages, ::Gitaly::GetCommitMessagesRequest, stream(::Gitaly::GetCommitMessagesResponse)
       # CheckObjectsExist will check for the existence of revisions against a
       # repository. It returns two sets of data. An array containing the revisions

data/ruby/proto/gitaly/conflicts_services_pb.rb

@@ -6,6 +6,8 @@ require 'conflicts_pb'
 
 module Gitaly
   module ConflictsService
+    # ConflictsService is a service which provides RPCs to interact with conflicts
+    # resulting from a merge.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +16,8 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.ConflictsService'
 
+      # ListConflictFiles returns all conflicting files which result from a merge
+      # of two specified commit objects.
       rpc :ListConflictFiles, ::Gitaly::ListConflictFilesRequest, stream(::Gitaly::ListConflictFilesResponse)
       # ResolveConflicts tries to resolve a conflicting merge with a set of
       # user-provided merge resolutions. If resolving the conflict succeeds, the

data/ruby/proto/gitaly/diff_services_pb.rb

@@ -6,6 +6,8 @@ require 'diff_pb'
 
 module Gitaly
   module DiffService
+    # DiffService is a service which provides RPCs to inspect differences
+    # introduced between a set of commits.
     class Service
 
       include ::GRPC::GenericService
@@ -18,8 +20,11 @@ module Gitaly
       rpc :CommitDiff, ::Gitaly::CommitDiffRequest, stream(::Gitaly::CommitDiffResponse)
       # Return a stream so we can divide the response in chunks of deltas
       rpc :CommitDelta, ::Gitaly::CommitDeltaRequest, stream(::Gitaly::CommitDeltaResponse)
+      # This comment is left unintentionally blank.
       rpc :RawDiff, ::Gitaly::RawDiffRequest, stream(::Gitaly::RawDiffResponse)
+      # This comment is left unintentionally blank.
       rpc :RawPatch, ::Gitaly::RawPatchRequest, stream(::Gitaly::RawPatchResponse)
+      # This comment is left unintentionally blank.
       rpc :DiffStats, ::Gitaly::DiffStatsRequest, stream(::Gitaly::DiffStatsResponse)
       # Return a list of files changed along with the status of each file
       rpc :FindChangedPaths, ::Gitaly::FindChangedPathsRequest, stream(::Gitaly::FindChangedPathsResponse)

data/ruby/proto/gitaly/errors_pb.rb

@@ -33,6 +33,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :error_message, :string, 1
       optional :retry_after, :message, 2, "google.protobuf.Duration"
     end
+    add_message "gitaly.CustomHookError" do
+      optional :stdout, :bytes, 1
+      optional :stderr, :bytes, 2
+      optional :hook_type, :enum, 3, "gitaly.CustomHookError.HookType"
+    end
+    add_enum "gitaly.CustomHookError.HookType" do
+      value :HOOK_TYPE_UNSPECIFIED, 0
+      value :HOOK_TYPE_PRERECEIVE, 1
+      value :HOOK_TYPE_UPDATE, 2
+      value :HOOK_TYPE_POSTRECEIVE, 3
+    end
   end
 end
 
@@ -44,4 +55,6 @@ module Gitaly
   ReferenceUpdateError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ReferenceUpdateError").msgclass
   ResolveRevisionError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ResolveRevisionError").msgclass
   LimitError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.LimitError").msgclass
+  CustomHookError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.CustomHookError").msgclass
+  CustomHookError::HookType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.CustomHookError.HookType").enummodule
 end

data/ruby/proto/gitaly/hook_services_pb.rb

@@ -6,6 +6,9 @@ require 'hook_pb'
 
 module Gitaly
   module HookService
+    # HookService is a service which provides the implementation of a subset of
+    # Git hooks. These are typically invoked via the `gitaly-hooks` binary to
+    # ensure that the actual hook logic is executed in the context of the server.
     class Service
 
       include ::GRPC::GenericService
@@ -14,9 +17,13 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.HookService'
 
+      # This comment is left unintentionally blank.
       rpc :PreReceiveHook, stream(::Gitaly::PreReceiveHookRequest), stream(::Gitaly::PreReceiveHookResponse)
+      # This comment is left unintentionally blank.
       rpc :PostReceiveHook, stream(::Gitaly::PostReceiveHookRequest), stream(::Gitaly::PostReceiveHookResponse)
+      # This comment is left unintentionally blank.
       rpc :UpdateHook, ::Gitaly::UpdateHookRequest, stream(::Gitaly::UpdateHookResponse)
+      # This comment is left unintentionally blank.
       rpc :ReferenceTransactionHook, stream(::Gitaly::ReferenceTransactionHookRequest), stream(::Gitaly::ReferenceTransactionHookResponse)
       # PackObjectsHookWithSidechannel is an optimized version of PackObjectsHook that uses
       # a unix socket side channel.

data/ruby/proto/gitaly/namespace_services_pb.rb

@@ -6,6 +6,9 @@ require 'namespace_pb'
 
 module Gitaly
   module NamespaceService
+    # NamespaceService is a service which provides RPCs to manage namespaces of a
+    # storage. Namespaces had been used before Gitaly migrated to hashed storages
+    # and shouldn't be used nowadays anymore.
     class Service
 
       include ::GRPC::GenericService
@@ -14,9 +17,13 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.NamespaceService'
 
+      # This comment is left unintentionally blank.
       rpc :AddNamespace, ::Gitaly::AddNamespaceRequest, ::Gitaly::AddNamespaceResponse
+      # This comment is left unintentionally blank.
       rpc :RemoveNamespace, ::Gitaly::RemoveNamespaceRequest, ::Gitaly::RemoveNamespaceResponse
+      # This comment is left unintentionally blank.
       rpc :RenameNamespace, ::Gitaly::RenameNamespaceRequest, ::Gitaly::RenameNamespaceResponse
+      # This comment is left unintentionally blank.
       rpc :NamespaceExists, ::Gitaly::NamespaceExistsRequest, ::Gitaly::NamespaceExistsResponse
     end
 

data/ruby/proto/gitaly/objectpool_services_pb.rb

@@ -6,6 +6,10 @@ require 'objectpool_pb'
 
 module Gitaly
   module ObjectPoolService
+    # ObjectPoolService is a service containing RPCs to manipulate object pools.
+    # An object pool is a separate repository that can be linked to from multiple
+    # satellite repositories in order to deduplicate common objects between them.
+    # This is mostly used in the contexet of repository forks.
     class Service
 
       include ::GRPC::GenericService
@@ -14,13 +18,19 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.ObjectPoolService'
 
+      # This comment is left unintentionally blank.
       rpc :CreateObjectPool, ::Gitaly::CreateObjectPoolRequest, ::Gitaly::CreateObjectPoolResponse
+      # This comment is left unintentionally blank.
       rpc :DeleteObjectPool, ::Gitaly::DeleteObjectPoolRequest, ::Gitaly::DeleteObjectPoolResponse
       # Repositories are assumed to be stored on the same disk
       rpc :LinkRepositoryToObjectPool, ::Gitaly::LinkRepositoryToObjectPoolRequest, ::Gitaly::LinkRepositoryToObjectPoolResponse
+      # This comment is left unintentionally blank.
       rpc :ReduplicateRepository, ::Gitaly::ReduplicateRepositoryRequest, ::Gitaly::ReduplicateRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :DisconnectGitAlternates, ::Gitaly::DisconnectGitAlternatesRequest, ::Gitaly::DisconnectGitAlternatesResponse
+      # This comment is left unintentionally blank.
       rpc :FetchIntoObjectPool, ::Gitaly::FetchIntoObjectPoolRequest, ::Gitaly::FetchIntoObjectPoolResponse
+      # This comment is left unintentionally blank.
       rpc :GetObjectPool, ::Gitaly::GetObjectPoolRequest, ::Gitaly::GetObjectPoolResponse
     end
 

data/ruby/proto/gitaly/operations_pb.rb

@@ -76,6 +76,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       oneof :error do
         optional :access_check, :message, 1, "gitaly.AccessCheckError"
         optional :reference_update, :message, 2, "gitaly.ReferenceUpdateError"
+        optional :custom_hook, :message, 3, "gitaly.CustomHookError"
       end
     end
     add_message "gitaly.UserMergeToRefRequest" do

data/ruby/proto/gitaly/operations_services_pb.rb

@@ -18,11 +18,15 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.OperationService'
 
+      # This comment is left unintentionally blank.
       rpc :UserCreateBranch, ::Gitaly::UserCreateBranchRequest, ::Gitaly::UserCreateBranchResponse
+      # This comment is left unintentionally blank.
       rpc :UserUpdateBranch, ::Gitaly::UserUpdateBranchRequest, ::Gitaly::UserUpdateBranchResponse
+      # This comment is left unintentionally blank.
       rpc :UserDeleteBranch, ::Gitaly::UserDeleteBranchRequest, ::Gitaly::UserDeleteBranchResponse
       # UserCreateTag creates a new tag.
       rpc :UserCreateTag, ::Gitaly::UserCreateTagRequest, ::Gitaly::UserCreateTagResponse
+      # This comment is left unintentionally blank.
       rpc :UserDeleteTag, ::Gitaly::UserDeleteTagRequest, ::Gitaly::UserDeleteTagResponse
       # UserMergeRef creates a merge commit and updates target_ref to point to that
       # new commit. The first parent of the merge commit (the main line) is taken

data/ruby/proto/gitaly/praefect_services_pb.rb

@@ -6,6 +6,8 @@ require 'praefect_pb'
 
 module Gitaly
   module PraefectInfoService
+    # PraefectInfoService is a service which provides RPCs to query and modify
+    # Praefect-specific parameters.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +16,7 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.PraefectInfoService'
 
+      # This comment is left unintentionally blank.
       rpc :RepositoryReplicas, ::Gitaly::RepositoryReplicasRequest, ::Gitaly::RepositoryReplicasResponse
       # DatalossCheck checks for unavailable repositories.
       rpc :DatalossCheck, ::Gitaly::DatalossCheckRequest, ::Gitaly::DatalossCheckResponse

data/ruby/proto/gitaly/ref_services_pb.rb

@@ -6,6 +6,7 @@ require 'ref_pb'
 
 module Gitaly
   module RefService
+    # RefService is a service that provides RPCs to list and modify Git references.
     class Service
 
       include ::GRPC::GenericService
@@ -14,28 +15,39 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.RefService'
 
+      # This comment is left unintentionally blank.
       rpc :FindDefaultBranchName, ::Gitaly::FindDefaultBranchNameRequest, ::Gitaly::FindDefaultBranchNameResponse
+      # This comment is left unintentionally blank.
       rpc :FindAllBranchNames, ::Gitaly::FindAllBranchNamesRequest, stream(::Gitaly::FindAllBranchNamesResponse)
+      # This comment is left unintentionally blank.
       rpc :FindAllTagNames, ::Gitaly::FindAllTagNamesRequest, stream(::Gitaly::FindAllTagNamesResponse)
       # Return a stream so we can divide the response in chunks of branches
       rpc :FindLocalBranches, ::Gitaly::FindLocalBranchesRequest, stream(::Gitaly::FindLocalBranchesResponse)
+      # This comment is left unintentionally blank.
       rpc :FindAllBranches, ::Gitaly::FindAllBranchesRequest, stream(::Gitaly::FindAllBranchesResponse)
       # Returns a stream of tags repository has.
       rpc :FindAllTags, ::Gitaly::FindAllTagsRequest, stream(::Gitaly::FindAllTagsResponse)
+      # This comment is left unintentionally blank.
       rpc :FindTag, ::Gitaly::FindTagRequest, ::Gitaly::FindTagResponse
+      # This comment is left unintentionally blank.
       rpc :FindAllRemoteBranches, ::Gitaly::FindAllRemoteBranchesRequest, stream(::Gitaly::FindAllRemoteBranchesResponse)
+      # This comment is left unintentionally blank.
       rpc :RefExists, ::Gitaly::RefExistsRequest, ::Gitaly::RefExistsResponse
       # FindBranch finds a branch by its unqualified name (like "master") and
       # returns the commit it currently points to.
       rpc :FindBranch, ::Gitaly::FindBranchRequest, ::Gitaly::FindBranchResponse
+      # This comment is left unintentionally blank.
       rpc :DeleteRefs, ::Gitaly::DeleteRefsRequest, ::Gitaly::DeleteRefsResponse
+      # This comment is left unintentionally blank.
       rpc :ListBranchNamesContainingCommit, ::Gitaly::ListBranchNamesContainingCommitRequest, stream(::Gitaly::ListBranchNamesContainingCommitResponse)
+      # This comment is left unintentionally blank.
       rpc :ListTagNamesContainingCommit, ::Gitaly::ListTagNamesContainingCommitRequest, stream(::Gitaly::ListTagNamesContainingCommitResponse)
       # GetTagSignatures returns signatures for annotated tags resolved from a set of revisions. Revisions
       # which don't resolve to an annotated tag are silently discarded. Revisions which cannot be resolved
       # result in an error. Tags which are annotated but not signed will return a TagSignature response
       # which has no signature, but its unsigned contents will still be returned.
       rpc :GetTagSignatures, ::Gitaly::GetTagSignaturesRequest, stream(::Gitaly::GetTagSignaturesResponse)
+      # This comment is left unintentionally blank.
       rpc :GetTagMessages, ::Gitaly::GetTagMessagesRequest, stream(::Gitaly::GetTagMessagesResponse)
       # PackRefs is deprecated in favor of OptimizeRepository.
       rpc :PackRefs, ::Gitaly::PackRefsRequest, ::Gitaly::PackRefsResponse

data/ruby/proto/gitaly/remote_services_pb.rb

@@ -6,6 +6,8 @@ require 'remote_pb'
 
 module Gitaly
   module RemoteService
+    # RemoteService is a service providing RPCs to interact with a remote
+    # repository that is hosted on another Git server.
     class Service
 
       include ::GRPC::GenericService
@@ -20,6 +22,7 @@ module Gitaly
       # deleted from the mirror. UpdateRemoteMirror updates all tags. Branches are updated if they match
       # the patterns specified in the requests.
       rpc :UpdateRemoteMirror, stream(::Gitaly::UpdateRemoteMirrorRequest), ::Gitaly::UpdateRemoteMirrorResponse
+      # This comment is left unintentionally blank.
       rpc :FindRemoteRepository, ::Gitaly::FindRemoteRepositoryRequest, ::Gitaly::FindRemoteRepositoryResponse
       # FindRemoteRootRef tries to find the root reference of a remote
       # repository. The root reference is the default branch as pointed to by

data/ruby/proto/gitaly/repository_services_pb.rb

@@ -6,6 +6,7 @@ require 'repository_pb'
 
 module Gitaly
   module RepositoryService
+    # RepositoryService is a service providing RPCs accessing repositories as a whole.
     class Service
 
       include ::GRPC::GenericService
@@ -14,6 +15,7 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.RepositoryService'
 
+      # This comment is left unintentionally blank.
       rpc :RepositoryExists, ::Gitaly::RepositoryExistsRequest, ::Gitaly::RepositoryExistsResponse
       # RepackIncremental is deprecated in favor of OptimizeRepository.
       rpc :RepackIncremental, ::Gitaly::RepackIncrementalRequest, ::Gitaly::RepackIncrementalResponse
@@ -25,21 +27,31 @@ module Gitaly
       rpc :GarbageCollect, ::Gitaly::GarbageCollectRequest, ::Gitaly::GarbageCollectResponse
       # WriteCommitGraph is deprecated in favor of OptimizeRepository.
       rpc :WriteCommitGraph, ::Gitaly::WriteCommitGraphRequest, ::Gitaly::WriteCommitGraphResponse
+      # This comment is left unintentionally blank.
       rpc :RepositorySize, ::Gitaly::RepositorySizeRequest, ::Gitaly::RepositorySizeResponse
+      # This comment is left unintentionally blank.
       rpc :ApplyGitattributes, ::Gitaly::ApplyGitattributesRequest, ::Gitaly::ApplyGitattributesResponse
       # FetchRemote fetches references from a remote repository into the local
       # repository.
       rpc :FetchRemote, ::Gitaly::FetchRemoteRequest, ::Gitaly::FetchRemoteResponse
+      # This comment is left unintentionally blank.
       rpc :CreateRepository, ::Gitaly::CreateRepositoryRequest, ::Gitaly::CreateRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :GetArchive, ::Gitaly::GetArchiveRequest, stream(::Gitaly::GetArchiveResponse)
+      # This comment is left unintentionally blank.
       rpc :HasLocalBranches, ::Gitaly::HasLocalBranchesRequest, ::Gitaly::HasLocalBranchesResponse
       # FetchSourceBranch fetches a branch from a second (potentially remote)
       # repository into the given repository.
       rpc :FetchSourceBranch, ::Gitaly::FetchSourceBranchRequest, ::Gitaly::FetchSourceBranchResponse
+      # This comment is left unintentionally blank.
       rpc :Fsck, ::Gitaly::FsckRequest, ::Gitaly::FsckResponse
+      # This comment is left unintentionally blank.
       rpc :WriteRef, ::Gitaly::WriteRefRequest, ::Gitaly::WriteRefResponse
+      # This comment is left unintentionally blank.
       rpc :FindMergeBase, ::Gitaly::FindMergeBaseRequest, ::Gitaly::FindMergeBaseResponse
+      # This comment is left unintentionally blank.
       rpc :CreateFork, ::Gitaly::CreateForkRequest, ::Gitaly::CreateForkResponse
+      # This comment is left unintentionally blank.
       rpc :CreateRepositoryFromURL, ::Gitaly::CreateRepositoryFromURLRequest, ::Gitaly::CreateRepositoryFromURLResponse
       # CreateBundle creates a bundle from all refs
       rpc :CreateBundle, ::Gitaly::CreateBundleRequest, stream(::Gitaly::CreateBundleResponse)
@@ -50,28 +62,42 @@ module Gitaly
       # Refs will be mirrored to the target repository with the refspec
       # "+refs/*:refs/*" and refs that do not exist in the bundle will be removed.
       rpc :FetchBundle, stream(::Gitaly::FetchBundleRequest), ::Gitaly::FetchBundleResponse
+      # This comment is left unintentionally blank.
       rpc :CreateRepositoryFromBundle, stream(::Gitaly::CreateRepositoryFromBundleRequest), ::Gitaly::CreateRepositoryFromBundleResponse
       # GetConfig reads the target repository's gitconfig and streams its contents
       # back. Returns a NotFound error in case no gitconfig was found.
       rpc :GetConfig, ::Gitaly::GetConfigRequest, stream(::Gitaly::GetConfigResponse)
+      # This comment is left unintentionally blank.
       rpc :FindLicense, ::Gitaly::FindLicenseRequest, ::Gitaly::FindLicenseResponse
+      # This comment is left unintentionally blank.
       rpc :GetInfoAttributes, ::Gitaly::GetInfoAttributesRequest, stream(::Gitaly::GetInfoAttributesResponse)
+      # This comment is left unintentionally blank.
       rpc :CalculateChecksum, ::Gitaly::CalculateChecksumRequest, ::Gitaly::CalculateChecksumResponse
       # Cleanup is deprecated in favor of OptimizeRepository.
       rpc :Cleanup, ::Gitaly::CleanupRequest, ::Gitaly::CleanupResponse
+      # This comment is left unintentionally blank.
       rpc :GetSnapshot, ::Gitaly::GetSnapshotRequest, stream(::Gitaly::GetSnapshotResponse)
+      # This comment is left unintentionally blank.
       rpc :CreateRepositoryFromSnapshot, ::Gitaly::CreateRepositoryFromSnapshotRequest, ::Gitaly::CreateRepositoryFromSnapshotResponse
+      # This comment is left unintentionally blank.
       rpc :GetRawChanges, ::Gitaly::GetRawChangesRequest, stream(::Gitaly::GetRawChangesResponse)
+      # This comment is left unintentionally blank.
       rpc :SearchFilesByContent, ::Gitaly::SearchFilesByContentRequest, stream(::Gitaly::SearchFilesByContentResponse)
+      # This comment is left unintentionally blank.
       rpc :SearchFilesByName, ::Gitaly::SearchFilesByNameRequest, stream(::Gitaly::SearchFilesByNameResponse)
+      # This comment is left unintentionally blank.
       rpc :RestoreCustomHooks, stream(::Gitaly::RestoreCustomHooksRequest), ::Gitaly::RestoreCustomHooksResponse
+      # This comment is left unintentionally blank.
       rpc :BackupCustomHooks, ::Gitaly::BackupCustomHooksRequest, stream(::Gitaly::BackupCustomHooksResponse)
+      # This comment is left unintentionally blank.
       rpc :GetObjectDirectorySize, ::Gitaly::GetObjectDirectorySizeRequest, ::Gitaly::GetObjectDirectorySizeResponse
       # RemoveRepository will move the repository to `+gitaly/tmp/<relative_path>_removed` and
       # eventually remove it. This ensures that even on networked filesystems the
       # data is actually removed even if there's someone still handling the data.
       rpc :RemoveRepository, ::Gitaly::RemoveRepositoryRequest, ::Gitaly::RemoveRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :RenameRepository, ::Gitaly::RenameRepositoryRequest, ::Gitaly::RenameRepositoryResponse
+      # This comment is left unintentionally blank.
       rpc :ReplicateRepository, ::Gitaly::ReplicateRepositoryRequest, ::Gitaly::ReplicateRepositoryResponse
       # OptimizeRepository performs all maintenance tasks in a repository to keep
       # it in an efficient state. It cleans up stale data, repacks objects,

data/ruby/proto/gitaly/server_services_pb.rb

@@ -6,6 +6,7 @@ require 'server_pb'
 
 module Gitaly
   module ServerService
+    # ServerService is a service that provides information about a Gitaly server.
     class Service
 
       include ::GRPC::GenericService
@@ -14,7 +15,9 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.ServerService'
 
+      # This comment is left unintentionally blank.
       rpc :ServerInfo, ::Gitaly::ServerInfoRequest, ::Gitaly::ServerInfoResponse
+      # This comment is left unintentionally blank.
       rpc :DiskStatistics, ::Gitaly::DiskStatisticsRequest, ::Gitaly::DiskStatisticsResponse
       # ClockSynced checks if machine clock is synced
       # (the offset is less that the one passed in the request).

data/ruby/proto/gitaly/smarthttp_services_pb.rb

@@ -6,6 +6,8 @@ require 'smarthttp_pb'
 
 module Gitaly
   module SmartHTTPService
+    # SmartHTTPService is a service that provides RPCs required for HTTP-based Git
+    # clones via the smart HTTP protocol.
     class Service
 
       include ::GRPC::GenericService

data/ruby/proto/gitaly/ssh_services_pb.rb

@@ -6,6 +6,7 @@ require 'ssh_pb'
 
 module Gitaly
   module SSHService
+    # SSHService is a service that provides RPCs required for SSH-based Git clones.
     class Service
 
       include ::GRPC::GenericService

data/ruby/proto/gitaly/transaction_services_pb.rb

@@ -6,6 +6,11 @@ require 'transaction_pb'
 
 module Gitaly
   module RefTransaction
+    # RefTransaction is a service which provides RPCs to interact with reference
+    # transactions. Reference transactions are used in the context of Gitaly
+    # Cluster to ensure that all nodes part of a single transaction perform the
+    # same change: given a set of changes, the changes are hashed and the hash is
+    # then voted on.
     class Service
 
       include ::GRPC::GenericService
@@ -14,7 +19,28 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.RefTransaction'
 
+      # VoteTransaction casts a vote on a transaction to establish whether the
+      # node is doing the same change as all the other nodes part of the
+      # transaction. This RPC blocks until quorum has been reached, which may be
+      # _before_ all nodes have cast a vote.
+      #
+      # This RPC may return one of the following error codes:
+      #
+      # - `NotFound` in case the transaction could not be found.
+      # - `Canceled` in case the transaction has been canceled before quorum was
+      #   reached.
       rpc :VoteTransaction, ::Gitaly::VoteTransactionRequest, ::Gitaly::VoteTransactionResponse
+      # StopTransaction gracefully stops a transaction. This RPC can be used if
+      # only a subset of nodes executes specific code which may cause the
+      # transaction to fail. One such example is Git hooks, which only execute on
+      # the primary Gitaly noded. Other nodes which vote on this transaction will
+      # get a response with the `STOP` state being set.
+      #
+      # This RPC may return one of the following error codes:
+      #
+      # - `NotFound` in case the transaction could not be found.
+      # - `Canceled` in case the transaction has been canceled before quorum was
+      #   reached.
       rpc :StopTransaction, ::Gitaly::StopTransactionRequest, ::Gitaly::StopTransactionResponse
     end
 

data/ruby/proto/gitaly/version.rb

@@ -2,5 +2,5 @@
 # (https://gitlab.com/gitlab-org/release-tools/), and should not be
 # modified.
 module Gitaly
-  VERSION = '15.0.0-rc2'
+  VERSION = '15.0.0-rc3'
 end

data/ruby/proto/gitaly/wiki_services_pb.rb

@@ -6,6 +6,9 @@ require 'wiki_pb'
 
 module Gitaly
   module WikiService
+    # WikiService is a service that provides Wiki-related functionality. This
+    # service is deprecated and should not be used anymore. Instead, all
+    # functionality to implement Wikis should use Git-based RPCS.
     class Service
 
       include ::GRPC::GenericService
@@ -14,11 +17,15 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.WikiService'
 
+      # This comment is left unintentionally blank.
       rpc :WikiWritePage, stream(::Gitaly::WikiWritePageRequest), ::Gitaly::WikiWritePageResponse
+      # This comment is left unintentionally blank.
       rpc :WikiUpdatePage, stream(::Gitaly::WikiUpdatePageRequest), ::Gitaly::WikiUpdatePageResponse
       # WikiFindPage returns a stream because the page's raw_data field may be arbitrarily large.
       rpc :WikiFindPage, ::Gitaly::WikiFindPageRequest, stream(::Gitaly::WikiFindPageResponse)
+      # This comment is left unintentionally blank.
       rpc :WikiGetAllPages, ::Gitaly::WikiGetAllPagesRequest, stream(::Gitaly::WikiGetAllPagesResponse)
+      # This comment is left unintentionally blank.
       rpc :WikiListPages, ::Gitaly::WikiListPagesRequest, stream(::Gitaly::WikiListPagesResponse)
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitaly
 version: !ruby/object:Gem::Version
-  version: 15.0.0.pre.rc2
+  version: 15.0.0.pre.rc3
 platform: ruby
 authors:
 - Jacob Vosmaer
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-04 00:00:00.000000000 Z
+date: 2022-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc
@@ -79,7 +79,7 @@ homepage: https://gitlab.com/gitlab-org/gitaly
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - ruby/proto
@@ -94,8 +94,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.3.8
+signing_key:
 specification_version: 4
 summary: Auto-generated gRPC client for gitaly
 test_files: []