google-cloud-artifact_registry-v1 0.5.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
 - data/AUTHENTICATION.md +1 -1
 - data/README.md +1 -1
 - data/lib/google/cloud/artifact_registry/v1/artifact_registry/client.rb +839 -48
 - data/lib/google/cloud/artifact_registry/v1/artifact_registry/paths.rb +122 -0
 - data/lib/google/cloud/artifact_registry/v1/artifact_registry.rb +1 -1
 - data/lib/google/cloud/artifact_registry/v1/version.rb +1 -1
 - data/lib/google/cloud/artifact_registry/v1.rb +2 -2
 - data/lib/google/devtools/artifactregistry/v1/artifact_pb.rb +75 -0
 - data/lib/google/devtools/artifactregistry/v1/file_pb.rb +2 -0
 - data/lib/google/devtools/artifactregistry/v1/service_pb.rb +1 -0
 - data/lib/google/devtools/artifactregistry/v1/service_services_pb.rb +16 -0
 - data/lib/google/devtools/artifactregistry/v1/version_pb.rb +4 -0
 - data/lib/google/devtools/artifactregistry/v1/vpcsc_config_pb.rb +42 -0
 - data/proto_docs/google/api/client.rb +318 -0
 - data/proto_docs/google/api/launch_stage.rb +71 -0
 - data/proto_docs/google/devtools/artifactregistry/v1/artifact.rb +226 -3
 - data/proto_docs/google/devtools/artifactregistry/v1/file.rb +11 -7
 - data/proto_docs/google/devtools/artifactregistry/v1/version.rb +11 -1
 - data/proto_docs/google/devtools/artifactregistry/v1/vpcsc_config.rb +82 -0
 - data/proto_docs/google/protobuf/empty.rb +0 -2
 - data/proto_docs/google/rpc/status.rb +4 -2
 - metadata +29 -5
 
| 
         @@ -47,8 +47,9 @@ module Google 
     | 
|
| 
       47 
47 
     | 
    
         
             
                    #   @return [::Google::Protobuf::Struct]
         
     | 
| 
       48 
48 
     | 
    
         
             
                    #     Output only. Repository-specific Metadata stored against this version.
         
     | 
| 
       49 
49 
     | 
    
         
             
                    #     The fields returned are defined by the underlying repository-specific
         
     | 
| 
       50 
     | 
    
         
            -
                    #     resource. Currently, the  
     | 
| 
      
 50 
     | 
    
         
            +
                    #     resource. Currently, the resources could be:
         
     | 
| 
       51 
51 
     | 
    
         
             
                    #     {::Google::Cloud::ArtifactRegistry::V1::DockerImage DockerImage}
         
     | 
| 
      
 52 
     | 
    
         
            +
                    #     {::Google::Cloud::ArtifactRegistry::V1::MavenArtifact MavenArtifact}
         
     | 
| 
       52 
53 
     | 
    
         
             
                    class Version
         
     | 
| 
       53 
54 
     | 
    
         
             
                      include ::Google::Protobuf::MessageExts
         
     | 
| 
       54 
55 
     | 
    
         
             
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         
     | 
| 
         @@ -113,6 +114,15 @@ module Google 
     | 
|
| 
       113 
114 
     | 
    
         
             
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         
     | 
| 
       114 
115 
     | 
    
         
             
                    end
         
     | 
| 
       115 
116 
     | 
    
         | 
| 
      
 117 
     | 
    
         
            +
                    # The metadata of an LRO from deleting multiple versions.
         
     | 
| 
      
 118 
     | 
    
         
            +
                    # @!attribute [rw] failed_versions
         
     | 
| 
      
 119 
     | 
    
         
            +
                    #   @return [::Array<::String>]
         
     | 
| 
      
 120 
     | 
    
         
            +
                    #     The versions the operation failed to delete.
         
     | 
| 
      
 121 
     | 
    
         
            +
                    class BatchDeleteVersionsMetadata
         
     | 
| 
      
 122 
     | 
    
         
            +
                      include ::Google::Protobuf::MessageExts
         
     | 
| 
      
 123 
     | 
    
         
            +
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         
     | 
| 
      
 124 
     | 
    
         
            +
                    end
         
     | 
| 
      
 125 
     | 
    
         
            +
             
     | 
| 
       116 
126 
     | 
    
         
             
                    # The view, which determines what version information is returned in a
         
     | 
| 
       117 
127 
     | 
    
         
             
                    # response.
         
     | 
| 
       118 
128 
     | 
    
         
             
                    module VersionView
         
     | 
| 
         @@ -0,0 +1,82 @@ 
     | 
|
| 
      
 1 
     | 
    
         
            +
            # frozen_string_literal: true
         
     | 
| 
      
 2 
     | 
    
         
            +
             
     | 
| 
      
 3 
     | 
    
         
            +
            # Copyright 2023 Google LLC
         
     | 
| 
      
 4 
     | 
    
         
            +
            #
         
     | 
| 
      
 5 
     | 
    
         
            +
            # Licensed under the Apache License, Version 2.0 (the "License");
         
     | 
| 
      
 6 
     | 
    
         
            +
            # you may not use this file except in compliance with the License.
         
     | 
| 
      
 7 
     | 
    
         
            +
            # You may obtain a copy of the License at
         
     | 
| 
      
 8 
     | 
    
         
            +
            #
         
     | 
| 
      
 9 
     | 
    
         
            +
            #     https://www.apache.org/licenses/LICENSE-2.0
         
     | 
| 
      
 10 
     | 
    
         
            +
            #
         
     | 
| 
      
 11 
     | 
    
         
            +
            # Unless required by applicable law or agreed to in writing, software
         
     | 
| 
      
 12 
     | 
    
         
            +
            # distributed under the License is distributed on an "AS IS" BASIS,
         
     | 
| 
      
 13 
     | 
    
         
            +
            # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
         
     | 
| 
      
 14 
     | 
    
         
            +
            # See the License for the specific language governing permissions and
         
     | 
| 
      
 15 
     | 
    
         
            +
            # limitations under the License.
         
     | 
| 
      
 16 
     | 
    
         
            +
             
     | 
| 
      
 17 
     | 
    
         
            +
            # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
         
     | 
| 
      
 18 
     | 
    
         
            +
             
     | 
| 
      
 19 
     | 
    
         
            +
             
     | 
| 
      
 20 
     | 
    
         
            +
            module Google
         
     | 
| 
      
 21 
     | 
    
         
            +
              module Cloud
         
     | 
| 
      
 22 
     | 
    
         
            +
                module ArtifactRegistry
         
     | 
| 
      
 23 
     | 
    
         
            +
                  module V1
         
     | 
| 
      
 24 
     | 
    
         
            +
                    # The Artifact Registry VPC SC config that apply to a Project.
         
     | 
| 
      
 25 
     | 
    
         
            +
                    # @!attribute [rw] name
         
     | 
| 
      
 26 
     | 
    
         
            +
                    #   @return [::String]
         
     | 
| 
      
 27 
     | 
    
         
            +
                    #     The name of the project's VPC SC Config.
         
     | 
| 
      
 28 
     | 
    
         
            +
                    #
         
     | 
| 
      
 29 
     | 
    
         
            +
                    #     Always of the form:
         
     | 
| 
      
 30 
     | 
    
         
            +
                    #     projects/\\{projectID}/locations/\\{location}/vpcscConfig
         
     | 
| 
      
 31 
     | 
    
         
            +
                    #
         
     | 
| 
      
 32 
     | 
    
         
            +
                    #     In update request: never set
         
     | 
| 
      
 33 
     | 
    
         
            +
                    #     In response: always set
         
     | 
| 
      
 34 
     | 
    
         
            +
                    # @!attribute [rw] vpcsc_policy
         
     | 
| 
      
 35 
     | 
    
         
            +
                    #   @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig::VPCSCPolicy]
         
     | 
| 
      
 36 
     | 
    
         
            +
                    #     The project per location VPC SC policy that defines the VPC SC behavior for
         
     | 
| 
      
 37 
     | 
    
         
            +
                    #     the Remote Repository (Allow/Deny).
         
     | 
| 
      
 38 
     | 
    
         
            +
                    class VPCSCConfig
         
     | 
| 
      
 39 
     | 
    
         
            +
                      include ::Google::Protobuf::MessageExts
         
     | 
| 
      
 40 
     | 
    
         
            +
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         
     | 
| 
      
 41 
     | 
    
         
            +
             
     | 
| 
      
 42 
     | 
    
         
            +
                      # VPCSCPolicy is the VPC SC policy for project and location.
         
     | 
| 
      
 43 
     | 
    
         
            +
                      module VPCSCPolicy
         
     | 
| 
      
 44 
     | 
    
         
            +
                        # VPCSC_POLICY_UNSPECIFIED - the VPS SC policy is not defined.
         
     | 
| 
      
 45 
     | 
    
         
            +
                        # When VPS SC policy is not defined - the Service will use the default
         
     | 
| 
      
 46 
     | 
    
         
            +
                        # behavior (VPCSC_DENY).
         
     | 
| 
      
 47 
     | 
    
         
            +
                        VPCSC_POLICY_UNSPECIFIED = 0
         
     | 
| 
      
 48 
     | 
    
         
            +
             
     | 
| 
      
 49 
     | 
    
         
            +
                        # VPCSC_DENY - repository will block the requests to the Upstreams for the
         
     | 
| 
      
 50 
     | 
    
         
            +
                        # Remote Repositories if the resource is in the perimeter.
         
     | 
| 
      
 51 
     | 
    
         
            +
                        DENY = 1
         
     | 
| 
      
 52 
     | 
    
         
            +
             
     | 
| 
      
 53 
     | 
    
         
            +
                        # VPCSC_ALLOW - repository will allow the requests to the Upstreams for the
         
     | 
| 
      
 54 
     | 
    
         
            +
                        # Remote Repositories if the resource is in the perimeter.
         
     | 
| 
      
 55 
     | 
    
         
            +
                        ALLOW = 2
         
     | 
| 
      
 56 
     | 
    
         
            +
                      end
         
     | 
| 
      
 57 
     | 
    
         
            +
                    end
         
     | 
| 
      
 58 
     | 
    
         
            +
             
     | 
| 
      
 59 
     | 
    
         
            +
                    # Gets the VPC SC config for a project.
         
     | 
| 
      
 60 
     | 
    
         
            +
                    # @!attribute [rw] name
         
     | 
| 
      
 61 
     | 
    
         
            +
                    #   @return [::String]
         
     | 
| 
      
 62 
     | 
    
         
            +
                    #     Required. The name of the VPCSCConfig resource.
         
     | 
| 
      
 63 
     | 
    
         
            +
                    class GetVPCSCConfigRequest
         
     | 
| 
      
 64 
     | 
    
         
            +
                      include ::Google::Protobuf::MessageExts
         
     | 
| 
      
 65 
     | 
    
         
            +
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         
     | 
| 
      
 66 
     | 
    
         
            +
                    end
         
     | 
| 
      
 67 
     | 
    
         
            +
             
     | 
| 
      
 68 
     | 
    
         
            +
                    # Sets the VPCSC config of the project.
         
     | 
| 
      
 69 
     | 
    
         
            +
                    # @!attribute [rw] vpcsc_config
         
     | 
| 
      
 70 
     | 
    
         
            +
                    #   @return [::Google::Cloud::ArtifactRegistry::V1::VPCSCConfig]
         
     | 
| 
      
 71 
     | 
    
         
            +
                    #     The project config.
         
     | 
| 
      
 72 
     | 
    
         
            +
                    # @!attribute [rw] update_mask
         
     | 
| 
      
 73 
     | 
    
         
            +
                    #   @return [::Google::Protobuf::FieldMask]
         
     | 
| 
      
 74 
     | 
    
         
            +
                    #     Field mask to support partial updates.
         
     | 
| 
      
 75 
     | 
    
         
            +
                    class UpdateVPCSCConfigRequest
         
     | 
| 
      
 76 
     | 
    
         
            +
                      include ::Google::Protobuf::MessageExts
         
     | 
| 
      
 77 
     | 
    
         
            +
                      extend ::Google::Protobuf::MessageExts::ClassMethods
         
     | 
| 
      
 78 
     | 
    
         
            +
                    end
         
     | 
| 
      
 79 
     | 
    
         
            +
                  end
         
     | 
| 
      
 80 
     | 
    
         
            +
                end
         
     | 
| 
      
 81 
     | 
    
         
            +
              end
         
     | 
| 
      
 82 
     | 
    
         
            +
            end
         
     | 
| 
         @@ -26,8 +26,6 @@ module Google 
     | 
|
| 
       26 
26 
     | 
    
         
             
                #     service Foo {
         
     | 
| 
       27 
27 
     | 
    
         
             
                #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
         
     | 
| 
       28 
28 
     | 
    
         
             
                #     }
         
     | 
| 
       29 
     | 
    
         
            -
                #
         
     | 
| 
       30 
     | 
    
         
            -
                # The JSON representation for `Empty` is empty JSON object `{}`.
         
     | 
| 
       31 
29 
     | 
    
         
             
                class Empty
         
     | 
| 
       32 
30 
     | 
    
         
             
                  include ::Google::Protobuf::MessageExts
         
     | 
| 
       33 
31 
     | 
    
         
             
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         
     | 
| 
         @@ -28,12 +28,14 @@ module Google 
     | 
|
| 
       28 
28 
     | 
    
         
             
                # [API Design Guide](https://cloud.google.com/apis/design/errors).
         
     | 
| 
       29 
29 
     | 
    
         
             
                # @!attribute [rw] code
         
     | 
| 
       30 
30 
     | 
    
         
             
                #   @return [::Integer]
         
     | 
| 
       31 
     | 
    
         
            -
                #     The status code, which should be an enum value of 
     | 
| 
      
 31 
     | 
    
         
            +
                #     The status code, which should be an enum value of
         
     | 
| 
      
 32 
     | 
    
         
            +
                #     [google.rpc.Code][google.rpc.Code].
         
     | 
| 
       32 
33 
     | 
    
         
             
                # @!attribute [rw] message
         
     | 
| 
       33 
34 
     | 
    
         
             
                #   @return [::String]
         
     | 
| 
       34 
35 
     | 
    
         
             
                #     A developer-facing error message, which should be in English. Any
         
     | 
| 
       35 
36 
     | 
    
         
             
                #     user-facing error message should be localized and sent in the
         
     | 
| 
       36 
     | 
    
         
            -
                #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized 
     | 
| 
      
 37 
     | 
    
         
            +
                #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
         
     | 
| 
      
 38 
     | 
    
         
            +
                #     by the client.
         
     | 
| 
       37 
39 
     | 
    
         
             
                # @!attribute [rw] details
         
     | 
| 
       38 
40 
     | 
    
         
             
                #   @return [::Array<::Google::Protobuf::Any>]
         
     | 
| 
       39 
41 
     | 
    
         
             
                #     A list of messages that carry the error details.  There is a common set of
         
     | 
    
        metadata
    CHANGED
    
    | 
         @@ -1,14 +1,14 @@ 
     | 
|
| 
       1 
1 
     | 
    
         
             
            --- !ruby/object:Gem::Specification
         
     | 
| 
       2 
2 
     | 
    
         
             
            name: google-cloud-artifact_registry-v1
         
     | 
| 
       3 
3 
     | 
    
         
             
            version: !ruby/object:Gem::Version
         
     | 
| 
       4 
     | 
    
         
            -
              version: 0. 
     | 
| 
      
 4 
     | 
    
         
            +
              version: 0.7.0
         
     | 
| 
       5 
5 
     | 
    
         
             
            platform: ruby
         
     | 
| 
       6 
6 
     | 
    
         
             
            authors:
         
     | 
| 
       7 
7 
     | 
    
         
             
            - Google LLC
         
     | 
| 
       8 
8 
     | 
    
         
             
            autorequire: 
         
     | 
| 
       9 
9 
     | 
    
         
             
            bindir: bin
         
     | 
| 
       10 
10 
     | 
    
         
             
            cert_chain: []
         
     | 
| 
       11 
     | 
    
         
            -
            date:  
     | 
| 
      
 11 
     | 
    
         
            +
            date: 2023-02-13 00:00:00.000000000 Z
         
     | 
| 
       12 
12 
     | 
    
         
             
            dependencies:
         
     | 
| 
       13 
13 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       14 
14 
     | 
    
         
             
              name: gapic-common
         
     | 
| 
         @@ -16,7 +16,7 @@ dependencies: 
     | 
|
| 
       16 
16 
     | 
    
         
             
                requirements:
         
     | 
| 
       17 
17 
     | 
    
         
             
                - - ">="
         
     | 
| 
       18 
18 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       19 
     | 
    
         
            -
                    version:  
     | 
| 
      
 19 
     | 
    
         
            +
                    version: 0.16.0
         
     | 
| 
       20 
20 
     | 
    
         
             
                - - "<"
         
     | 
| 
       21 
21 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       22 
22 
     | 
    
         
             
                    version: 2.a
         
     | 
| 
         @@ -26,7 +26,7 @@ dependencies: 
     | 
|
| 
       26 
26 
     | 
    
         
             
                requirements:
         
     | 
| 
       27 
27 
     | 
    
         
             
                - - ">="
         
     | 
| 
       28 
28 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       29 
     | 
    
         
            -
                    version:  
     | 
| 
      
 29 
     | 
    
         
            +
                    version: 0.16.0
         
     | 
| 
       30 
30 
     | 
    
         
             
                - - "<"
         
     | 
| 
       31 
31 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       32 
32 
     | 
    
         
             
                    version: 2.a
         
     | 
| 
         @@ -44,6 +44,26 @@ dependencies: 
     | 
|
| 
       44 
44 
     | 
    
         
             
                - - "~>"
         
     | 
| 
       45 
45 
     | 
    
         
             
                  - !ruby/object:Gem::Version
         
     | 
| 
       46 
46 
     | 
    
         
             
                    version: '1.0'
         
     | 
| 
      
 47 
     | 
    
         
            +
            - !ruby/object:Gem::Dependency
         
     | 
| 
      
 48 
     | 
    
         
            +
              name: google-cloud-location
         
     | 
| 
      
 49 
     | 
    
         
            +
              requirement: !ruby/object:Gem::Requirement
         
     | 
| 
      
 50 
     | 
    
         
            +
                requirements:
         
     | 
| 
      
 51 
     | 
    
         
            +
                - - ">="
         
     | 
| 
      
 52 
     | 
    
         
            +
                  - !ruby/object:Gem::Version
         
     | 
| 
      
 53 
     | 
    
         
            +
                    version: '0.3'
         
     | 
| 
      
 54 
     | 
    
         
            +
                - - "<"
         
     | 
| 
      
 55 
     | 
    
         
            +
                  - !ruby/object:Gem::Version
         
     | 
| 
      
 56 
     | 
    
         
            +
                    version: 2.a
         
     | 
| 
      
 57 
     | 
    
         
            +
              type: :runtime
         
     | 
| 
      
 58 
     | 
    
         
            +
              prerelease: false
         
     | 
| 
      
 59 
     | 
    
         
            +
              version_requirements: !ruby/object:Gem::Requirement
         
     | 
| 
      
 60 
     | 
    
         
            +
                requirements:
         
     | 
| 
      
 61 
     | 
    
         
            +
                - - ">="
         
     | 
| 
      
 62 
     | 
    
         
            +
                  - !ruby/object:Gem::Version
         
     | 
| 
      
 63 
     | 
    
         
            +
                    version: '0.3'
         
     | 
| 
      
 64 
     | 
    
         
            +
                - - "<"
         
     | 
| 
      
 65 
     | 
    
         
            +
                  - !ruby/object:Gem::Version
         
     | 
| 
      
 66 
     | 
    
         
            +
                    version: 2.a
         
     | 
| 
       47 
67 
     | 
    
         
             
            - !ruby/object:Gem::Dependency
         
     | 
| 
       48 
68 
     | 
    
         
             
              name: grpc-google-iam-v1
         
     | 
| 
       49 
69 
     | 
    
         
             
              requirement: !ruby/object:Gem::Requirement
         
     | 
| 
         @@ -202,9 +222,12 @@ files: 
     | 
|
| 
       202 
222 
     | 
    
         
             
            - lib/google/devtools/artifactregistry/v1/settings_pb.rb
         
     | 
| 
       203 
223 
     | 
    
         
             
            - lib/google/devtools/artifactregistry/v1/tag_pb.rb
         
     | 
| 
       204 
224 
     | 
    
         
             
            - lib/google/devtools/artifactregistry/v1/version_pb.rb
         
     | 
| 
      
 225 
     | 
    
         
            +
            - lib/google/devtools/artifactregistry/v1/vpcsc_config_pb.rb
         
     | 
| 
       205 
226 
     | 
    
         
             
            - lib/google/devtools/artifactregistry/v1/yum_artifact_pb.rb
         
     | 
| 
       206 
227 
     | 
    
         
             
            - proto_docs/README.md
         
     | 
| 
      
 228 
     | 
    
         
            +
            - proto_docs/google/api/client.rb
         
     | 
| 
       207 
229 
     | 
    
         
             
            - proto_docs/google/api/field_behavior.rb
         
     | 
| 
      
 230 
     | 
    
         
            +
            - proto_docs/google/api/launch_stage.rb
         
     | 
| 
       208 
231 
     | 
    
         
             
            - proto_docs/google/api/resource.rb
         
     | 
| 
       209 
232 
     | 
    
         
             
            - proto_docs/google/devtools/artifactregistry/v1/apt_artifact.rb
         
     | 
| 
       210 
233 
     | 
    
         
             
            - proto_docs/google/devtools/artifactregistry/v1/artifact.rb
         
     | 
| 
         @@ -215,6 +238,7 @@ files: 
     | 
|
| 
       215 
238 
     | 
    
         
             
            - proto_docs/google/devtools/artifactregistry/v1/settings.rb
         
     | 
| 
       216 
239 
     | 
    
         
             
            - proto_docs/google/devtools/artifactregistry/v1/tag.rb
         
     | 
| 
       217 
240 
     | 
    
         
             
            - proto_docs/google/devtools/artifactregistry/v1/version.rb
         
     | 
| 
      
 241 
     | 
    
         
            +
            - proto_docs/google/devtools/artifactregistry/v1/vpcsc_config.rb
         
     | 
| 
       218 
242 
     | 
    
         
             
            - proto_docs/google/devtools/artifactregistry/v1/yum_artifact.rb
         
     | 
| 
       219 
243 
     | 
    
         
             
            - proto_docs/google/iam/v1/iam_policy.rb
         
     | 
| 
       220 
244 
     | 
    
         
             
            - proto_docs/google/iam/v1/options.rb
         
     | 
| 
         @@ -247,7 +271,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement 
     | 
|
| 
       247 
271 
     | 
    
         
             
                - !ruby/object:Gem::Version
         
     | 
| 
       248 
272 
     | 
    
         
             
                  version: '0'
         
     | 
| 
       249 
273 
     | 
    
         
             
            requirements: []
         
     | 
| 
       250 
     | 
    
         
            -
            rubygems_version: 3. 
     | 
| 
      
 274 
     | 
    
         
            +
            rubygems_version: 3.4.2
         
     | 
| 
       251 
275 
     | 
    
         
             
            signing_key: 
         
     | 
| 
       252 
276 
     | 
    
         
             
            specification_version: 4
         
     | 
| 
       253 
277 
     | 
    
         
             
            summary: API Client library for the Artifact Registry V1 API
         
     |