gitaly 15.6.0.pre.rc3 → 15.8.0.pre.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 772e2e42038fb06b25beb3e3bef80daf59e350f4409ddc0ec4091c7fe67757bd
-  data.tar.gz: 1d5a6b6e6c9a9dc96032a086df7a21d48cdd0fdea848a31be116f287bbb280c3
+  metadata.gz: '08b62d0be69384cefb00c5d2e07de5e71a766620ac0f681ad175944910df48a6'
+  data.tar.gz: 67f0a288bbf1b193f9a9786925354e0fcf2602d50af84149af15f126bb1bf169
 SHA512:
-  metadata.gz: 2d0d468db91b14a8efe4c708d6bd0046c214b76289c6ce47e17f7b57631137aa64027225418e08bd2ff373ffc2f0e838134e0b7b15eed26476eac9d836df16b4
-  data.tar.gz: d9603f499553f45532f389f535eca159be65e18b36020cd68bf4cdbd12f80b3721f5f7aa1fd8af2ec3b1e54972df2ac3393db35211d59831bbbdc786241b9154
+  metadata.gz: 7c91276bf03746293d24a6e6ab191db1f16a7d9aa761656a0db030b9a04c48b20c50aa52ba4e801c40ca324c770b651ff116d860fac41463e9043bab924fd69e
+  data.tar.gz: b14b7d6662bd4b47f968ccc5b59de53bdfd8498ab8eea0863d555b95df33bd5e8c936507d423fe094103fd36c6f2baf954e62e52f6810bc3055e5d5d845ae953

data/ruby/proto/gitaly/commit_pb.rb

@@ -215,7 +215,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :share, :float, 2
       optional :color, :string, 3
-      optional :file_count, :uint32, 4
       optional :bytes, :uint64, 5
     end
     add_message "gitaly.RawBlameRequest" do

data/ruby/proto/gitaly/diff_pb.rb

@@ -23,6 +23,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :safe_max_lines, :int32, 12
       optional :safe_max_bytes, :int32, 13
       optional :diff_mode, :enum, 15, "gitaly.CommitDiffRequest.DiffMode"
+      map :max_patch_bytes_for_file_extension, :string, :int32, 16
     end
     add_enum "gitaly.CommitDiffRequest.DiffMode" do
       value :DEFAULT, 0
@@ -124,6 +125,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :TYPE_CHANGE, 3
       value :COPIED, 4
     end
+    add_message "gitaly.GetPatchIDRequest" do
+      optional :repository, :message, 1, "gitaly.Repository"
+      optional :old_revision, :bytes, 2
+      optional :new_revision, :bytes, 3
+    end
+    add_message "gitaly.GetPatchIDResponse" do
+      optional :patch_id, :string, 1
+    end
   end
 end
 
@@ -148,4 +157,6 @@ module Gitaly
   FindChangedPathsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.FindChangedPathsResponse").msgclass
   ChangedPaths = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ChangedPaths").msgclass
   ChangedPaths::Status = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ChangedPaths.Status").enummodule
+  GetPatchIDRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.GetPatchIDRequest").msgclass
+  GetPatchIDResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.GetPatchIDResponse").msgclass
 end

data/ruby/proto/gitaly/diff_services_pb.rb

@@ -28,6 +28,11 @@ module Gitaly
       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)
+      # GetPatchID computes a patch ID for a patch. Patch IDs are a unique ID computed by hashing
+      # a patch with some parameters like line numbers ignored. The patch ID can thus be used to compare
+      # whether diffs make the same change. Please refer to git-patch-id(1) for further information.
+      # If the difference between old and new change is empty then this RPC returns an error.
+      rpc :GetPatchID, ::Gitaly::GetPatchIDRequest, ::Gitaly::GetPatchIDResponse
     end
 
     Stub = Service.rpc_stub_class

data/ruby/proto/gitaly/objectpool_services_pb.rb

@@ -6,10 +6,27 @@ 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.
+    # ObjectPoolService is a service that manages the lifetime of object pools.
+    #
+    # An object pool is a separate repository that can be linked to from multiple object pool members
+    # in order to deduplicate common objects between them. This is mostly used in the context of
+    # repository forks.
+    #
+    # The typical lifetime of an object pool is as follows:
+    #
+    # 1. An object pool is created via CreateObjectPool from its primary pool member. Typically this
+    #    would be the repository that gets forked.
+    # 2. One or more repositories are linked to the object pool via LinkRepositoryToObjectPool. Each
+    #    object pool member linked to the repository will have its objects deduplicated when its
+    #    objects get repacked the next time.
+    # 3. The object pool is regularly updated via FetchIntoObjectPool. This is typically only done from
+    #    the primary object pool member.
+    # 4. Repositories may leave the object pool via DisconnectGitAlternates. There is not much of a
+    #    reason to do this for any repositories except for the primary object pool member in case it
+    #    for example becomes private.
+    # 5. When the object pool does not have any members anymore it gets deleted via DeleteObjectPool.
+    #    It is the responsibility of the caller to ensure that it really has no members left, else
+    #    any existing member will become corrupt.
     class Service
 
       include ::GRPC::GenericService
@@ -18,22 +35,47 @@ module Gitaly
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.ObjectPoolService'
 
-      # This comment is left unintentionally blank.
+      # CreateObjectPool creates an object pool from a specific source repository. It will create the
+      # object pool by cloning all contents from that source repository. The source repository will not
+      # automatically be linked to the object pool, you need to call LinkRepositoryToObjectPool for
+      # this. If the object pool exists already this RPC returns an error with the FailedPrecondition
+      # gRPC error code.
       rpc :CreateObjectPool, ::Gitaly::CreateObjectPoolRequest, ::Gitaly::CreateObjectPoolResponse
-      # This comment is left unintentionally blank.
+      # DeleteObjectPool deletes the object pool. There are no safety checks in place, so if any
+      # repository is still using this object pool it will become corrupted.
       rpc :DeleteObjectPool, ::Gitaly::DeleteObjectPoolRequest, ::Gitaly::DeleteObjectPoolResponse
-      # Repositories are assumed to be stored on the same disk
+      # LinkRepositoryToObjectPool links the specified repository to the object pool. Objects contained
+      # in the object pool will be deduplicated for this repository when repacking objects.
       rpc :LinkRepositoryToObjectPool, ::Gitaly::LinkRepositoryToObjectPoolRequest, ::Gitaly::LinkRepositoryToObjectPoolResponse
-      # This comment is left unintentionally blank.
+      # ReduplicateRepository will repack the objects in the object pool member so that the repository
+      # does not depend on the pool member anymore and can be removed from it. Note that this function
+      # is not safe for use.
+      #
+      # This RPC is deprecated. Please use DisconnectGitAlternates instead.  It will be removed in
+      # Gitaly v16.0, refer to https://gitlab.com/gitlab-org/gitaly/-/issues/4655.
       rpc :ReduplicateRepository, ::Gitaly::ReduplicateRepositoryRequest, ::Gitaly::ReduplicateRepositoryResponse
-      # This comment is left unintentionally blank.
+      # DisconnectGitAlternates will disconnect the object pool member from its object pool. It will:
+      #
+      # 1. Link all objects from the object pool into the member repository. This essenitally
+      #    reduplicates previously-duplicated objects so that the repository will continue to function
+      #    after being unlinked.
+      # 2. Remove the alternates link to the object pool.
+      # 3. Perform a consistency check to assert that the repository is indeed fully functional after
+      #    unlinking it from its pool. If the consistency check fails the alternates link is restored
+      #    an the RPC fails.
+      #
+      # If successful, the object pool member is disconnected from the object pool and does not depend
+      # on it anymore.
+      #
+      # This RPC does not return an error in case the repository is not linked to any object pool.
       rpc :DisconnectGitAlternates, ::Gitaly::DisconnectGitAlternatesRequest, ::Gitaly::DisconnectGitAlternatesResponse
       # FetchIntoObjectPool fetches all references from a pool member into an object pool so that
       # objects shared between this repository and other pool members can be deduplicated. This RPC
       # will perform housekeeping tasks after the object pool has been updated to ensure that the pool
       # is in an optimal state.
       rpc :FetchIntoObjectPool, ::Gitaly::FetchIntoObjectPoolRequest, ::Gitaly::FetchIntoObjectPoolResponse
-      # This comment is left unintentionally blank.
+      # GetObjectPool returns the object pool a repository is connected to. If the repository is not
+      # connected to a pool then this RPC returns successfully with an empty response.
       rpc :GetObjectPool, ::Gitaly::GetObjectPoolRequest, ::Gitaly::GetObjectPoolResponse
     end
 

data/ruby/proto/gitaly/ref_services_pb.rb

@@ -17,9 +17,13 @@ module Gitaly
 
       # This comment is left unintentionally blank.
       rpc :FindDefaultBranchName, ::Gitaly::FindDefaultBranchNameRequest, ::Gitaly::FindDefaultBranchNameResponse
-      # This comment is left unintentionally blank.
+      # FindAllBranchNames is deprecated in favor of ListRefs
+      #
+      # https://gitlab.com/gitlab-org/gitaly/-/issues/3966
       rpc :FindAllBranchNames, ::Gitaly::FindAllBranchNamesRequest, stream(::Gitaly::FindAllBranchNamesResponse)
-      # This comment is left unintentionally blank.
+      # FindAllTagNames is deprecated in favor of ListRefs
+      #
+      # https://gitlab.com/gitlab-org/gitaly/-/issues/3966
       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)

data/ruby/proto/gitaly/repository_pb.rb

@@ -86,6 +86,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "gitaly.CreateRepositoryRequest" do
       optional :repository, :message, 1, "gitaly.Repository"
       optional :default_branch, :bytes, 2
+      optional :object_format, :enum, 3, "gitaly.ObjectFormat"
     end
     add_message "gitaly.CreateRepositoryResponse" do
     end

data/ruby/proto/gitaly/repository_services_pb.rb

@@ -43,7 +43,8 @@ module Gitaly
       # 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.
+      # Fsck checks the repository for consistency via git-fsck(1). This can be used to check for
+      # repository corruption.
       rpc :Fsck, ::Gitaly::FsckRequest, ::Gitaly::FsckResponse
       # This comment is left unintentionally blank.
       rpc :WriteRef, ::Gitaly::WriteRefRequest, ::Gitaly::WriteRefResponse
@@ -67,7 +68,8 @@ module Gitaly
       # 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.
+      # FindLicense looks in the given repository and attempts to detect all the
+      # details about the license used in the repository.
       rpc :FindLicense, ::Gitaly::FindLicenseRequest, ::Gitaly::FindLicenseResponse
       # This comment is left unintentionally blank.
       rpc :GetInfoAttributes, ::Gitaly::GetInfoAttributesRequest, stream(::Gitaly::GetInfoAttributesResponse)

data/ruby/proto/gitaly/shared_pb.rb

@@ -86,6 +86,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :TREE, 3
       value :TAG, 4
     end
+    add_enum "gitaly.ObjectFormat" do
+      value :OBJECT_FORMAT_UNSPECIFIED, 0
+      value :OBJECT_FORMAT_SHA1, 1
+      value :OBJECT_FORMAT_SHA256, 2
+    end
     add_enum "gitaly.SignatureType" do
       value :NONE, 0
       value :PGP, 1
@@ -114,6 +119,7 @@ module Gitaly
   PaginationCursor = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.PaginationCursor").msgclass
   GlobalOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.GlobalOptions").msgclass
   ObjectType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ObjectType").enummodule
+  ObjectFormat = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.ObjectFormat").enummodule
   SignatureType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.SignatureType").enummodule
   SortDirection = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gitaly.SortDirection").enummodule
 end

data/ruby/proto/gitaly/version.rb

@@ -1,4 +1,4 @@
 # This file is generated by build-proto-gem. Do not edit.
 module Gitaly
-  VERSION = '15.6.0-rc3'
+  VERSION = '15.8.0-rc1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitaly
 version: !ruby/object:Gem::Version
-  version: 15.6.0.pre.rc3
+  version: 15.8.0.pre.rc1
 platform: ruby
 authors:
 - Jacob Vosmaer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-11-15 00:00:00.000000000 Z
+date: 2023-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc