etcdv3 0.8.3 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7deeb602a904edaf573fe4408d8b883c5da08abd
-  data.tar.gz: ff19147d87be054a9ba6c9d74d12926fbd46f480
+  metadata.gz: 2c90b3d66d75efdf3c6c608cc1ccaf9673731070
+  data.tar.gz: 7698e02e69968d2e6348dd01a7e6813d27d5d50e
 SHA512:
-  metadata.gz: 7de0619eac9940e637b4ebfd7dadaa14f2931c9ac2cf87fc2fcaf3fd1176b610e621ca93eb62cf4fb9bfa29a8c8cc3508ad89591a062125e350b78dd0f47a86a
-  data.tar.gz: b41a4a790e03e5d3aa342569a21efb114493b776fd0b21a37b2131328610c29e49d5c1aa910c2acba14c4e0098de1573cfb9b6ad0769e19bfddfef9cc9ef0a43
+  metadata.gz: 634ec36c4eccf0b93dd69b51a25e6515c06a26a1677264fb02d035c793cf905feb739ad9bde6e40ae30617416aebe7b85706bb4a1060cbb3d26d8b68e42a702f
+  data.tar.gz: 7043f69c71837cefc8168ff3d5c0225afc9109c4a1c5e9aab1bec7b5fcf56999c9866abac23c3a7b13e9de5422b1983ffae57448f85dafd65f5d369837d7d286

data/.travis.yml

@@ -1,16 +1,19 @@
 language: ruby
 rvm:
-  - 2.4.1
-  - 2.2
+  - 2.5.3
+  - 2.4.5
+  - 2.3.8
 
 env:
-  global:
-    - ETCD_VERSION=v3.2.0
+  - ETCD_VERSION=v3.1.20
+  - ETCD_VERSION=v3.2.25
+# v3.3.10 is not working for whatever reason (at least in travis, spec passes
+# locally for me)
+#  - ETCD_VERSION=v3.3.10
 
 install:
     - bundle install
-    - wget https://github.com/coreos/etcd/releases/download/$ETCD_VERSION/etcd-$ETCD_VERSION-linux-amd64.tar.gz -O etcd.tar.gz --no-check-certificate
-    - tar zxvf etcd.tar.gz
-    - export PATH=$PATH:etcd-$ETCD_VERSION-linux-amd64
+    - bundle exec rake download-etcd
+    - export PATH="$(dirname $(find /tmp -name 'etcd')):$PATH"
 
 script: bundle exec rspec

data/README.md

@@ -43,6 +43,9 @@ In the event of a failure, the client will work to restore connectivity by cycli
  # Get
  conn.get('my')
 
+ # Get actual value
+ value = conn.get('my').kvs.first.value
+
  # Get Key Range
  conn.get('foo', range_end: 'foo80')
 
@@ -110,7 +113,7 @@ conn.auth_disable
 conn.lease_grant(100)
 
 # Attach key to lease
-conn.put('foo', 'bar', lease_id: 1234566789)
+conn.put('foo', 'bar', lease: 1234566789)
 
 # Get information about lease and its attached keys
 conn.lease_ttl(1234566789)
@@ -161,6 +164,23 @@ conn.watch('boom') do |events|
 end
 ```
 
+## Locks
+```ruby
+# First, get yourself a lease
+lease_id = conn.lease_grant(100)['ID']
+
+# Attempt to lock distibuted lock 'foo', wait at most 10 seconds
+lock_key = conn.lock('foo', lease_id, timeout: 10).key
+
+# Unlock the 'foo' lock using the key returned from `lock`
+conn.unlock(key)
+
+# Perform a critical section while holding the lock 'hello'
+conn.with_lock('hello', lease_id) do
+  puts "kitty!"
+end
+```
+
 ## Alarms
 ```ruby
 # List all active Alarms

data/Rakefile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+ETCD_VERSION = ENV["ETCD_VERSION"] || "v3.2.0"
+ETCD_URL = "https://github.com/coreos/etcd/releases/download/#{ETCD_VERSION}/etcd-#{ETCD_VERSION}-linux-amd64.tar.gz"
+
+require "tmpdir"
+
+desc "Download etcd for it can be used in rspec"
+task :"download-etcd" do
+  tmpdir = Dir.mktmpdir
+  system("wget", ETCD_URL, "-O", "#{tmpdir}/etcd.tar.gz")   || exit(1)
+  system(*%W{tar -C #{tmpdir} -zxvf #{tmpdir}/etcd.tar.gz}) || exit(1)
+
+  puts "Etcd downloaded and extracted. Add it to the path:"
+  puts "    export PATH=\"#{tmpdir}/etcd-#{ETCD_VERSION}-linux-amd64:$PATH\""
+end

data/etcdv3.gemspec

@@ -14,6 +14,8 @@ Gem::Specification.new do |s|
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
 
-  s.add_dependency("grpc", "~> 1.6")
-  s.add_development_dependency("rspec")
+  s.add_dependency("grpc", "~> 1.17")
+  s.add_development_dependency("pry-byebug", "~> 3.6")
+  s.add_development_dependency("rake", "~> 12.3")
+  s.add_development_dependency("rspec", "~> 3.6")
 end

data/lib/etcdv3.rb

@@ -2,6 +2,7 @@ require 'grpc'
 require 'uri'
 
 require 'etcdv3/etcdrpc/rpc_services_pb'
+require 'etcdv3/etcdrpc/v3lock_services_pb'
 require 'etcdv3/auth'
 require 'etcdv3/kv/requests'
 require 'etcdv3/kv/transaction'
@@ -9,6 +10,7 @@ require 'etcdv3/kv'
 require 'etcdv3/maintenance'
 require 'etcdv3/lease'
 require 'etcdv3/watch'
+require 'etcdv3/lock'
 require 'etcdv3/connection'
 require 'etcdv3/connection_wrapper'
 
@@ -84,6 +86,37 @@ class Etcdv3
     @conn.handle(:kv, 'get', [key, opts])
   end
 
+  # Locks distributed lock with the given name. The lock will unlock automatically
+  # when lease with the given ID expires. If this is not desirable, provide a non-expiring
+  # lease ID as an argument.
+  # name                          - string
+  # lease_id                      - integer
+  # optional :timeout             - integer
+  def lock(name, lease_id, timeout: nil)
+    @conn.handle(:lock, 'lock', [name, lease_id, {timeout: timeout}])
+  end
+
+  # Unlock distributed lock using the key previously obtained from lock.
+  # key                           - string
+  # optional :timeout             - integer
+  def unlock(key, timeout: nil)
+    @conn.handle(:lock, 'unlock', [key, {timeout: timeout}])
+  end
+
+  # Yield into the critical section while holding lock with the given
+  # name. The lock will be unlocked even if the block throws.
+  # name                          - string
+  # lease_id                      - integer
+  # optional :timeout             - integer
+  def with_lock(name, lease_id, timeout: nil)
+    key = lock(name, lease_id, timeout: timeout).key
+    begin
+      yield
+    ensure
+      unlock(key, timeout: timeout)
+    end
+  end
+
   # Inserts a new key.
   # key                           - string
   # value                         - string
@@ -116,6 +149,11 @@ class Etcdv3
     @conn.handle(:lease, 'lease_ttl', [id, timeout: timeout])
   end
 
+  # Sends one lease keep-alive request
+  def lease_keep_alive_once(id, timeout: nil)
+    @conn.handle(:lease, 'lease_keep_alive_once', [id, timeout: timeout])
+  end
+
   # List all roles.
   def role_list(timeout: nil)
     @conn.handle(:auth, 'role_list', [timeout: timeout])

data/lib/etcdv3/auth.rb

@@ -1,6 +1,7 @@
 
 class Etcdv3
   class Auth
+    include GRPC::Core::TimeConsts
 
     PERMISSIONS = {
       :read => Authpb::Permission::Type::READ,
@@ -122,7 +123,7 @@ class Etcdv3
     private
 
     def deadline(timeout)
-      Time.now.to_f + (timeout || @timeout)
+      from_relative_time(timeout || @timeout)
     end
   end
 end

data/lib/etcdv3/connection.rb

@@ -6,7 +6,8 @@ class Etcdv3
       kv: Etcdv3::KV,
       maintenance: Etcdv3::Maintenance,
       lease: Etcdv3::Lease,
-      watch: Etcdv3::Watch
+      watch: Etcdv3::Watch,
+      lock: Etcdv3::Lock,
     }
 
     attr_reader :endpoint, :hostname, :handlers, :credentials

data/lib/etcdv3/etcdrpc/annotations_pb.rb

@@ -0,0 +1,13 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: annotations.proto
+
+require 'google/protobuf'
+
+#require 'http_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+end
+
+module Google
+  module Api
+  end
+end

data/lib/etcdv3/etcdrpc/rpc_pb.rb

@@ -5,6 +5,7 @@ require 'google/protobuf'
 
 require_relative 'kv_pb'
 require_relative 'auth_pb'
+require_relative 'annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "etcdserverpb.ResponseHeader" do
     optional :cluster_id, :uint64, 1

data/lib/etcdv3/etcdrpc/rpc_services_pb.rb

@@ -1,5 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: rpc.proto for package 'etcdserverpb'
+
+require 'grpc'
 require_relative 'rpc_pb'
 
 module Etcdserverpb

data/lib/etcdv3/etcdrpc/v3lock_pb.rb

@@ -0,0 +1,30 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: v3lock.proto
+
+require 'google/protobuf'
+
+require_relative 'annotations_pb'
+require_relative 'rpc_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "v3lockpb.LockRequest" do
+    optional :name, :bytes, 1
+    optional :lease, :int64, 2
+  end
+  add_message "v3lockpb.LockResponse" do
+    optional :header, :message, 1, "etcdserverpb.ResponseHeader"
+    optional :key, :bytes, 2
+  end
+  add_message "v3lockpb.UnlockRequest" do
+    optional :key, :bytes, 1
+  end
+  add_message "v3lockpb.UnlockResponse" do
+    optional :header, :message, 1, "etcdserverpb.ResponseHeader"
+  end
+end
+
+module V3lockpb
+  LockRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("v3lockpb.LockRequest").msgclass
+  LockResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("v3lockpb.LockResponse").msgclass
+  UnlockRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("v3lockpb.UnlockRequest").msgclass
+  UnlockResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("v3lockpb.UnlockResponse").msgclass
+end

data/lib/etcdv3/etcdrpc/v3lock_services_pb.rb

@@ -0,0 +1,25 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: v3lock.proto for package 'v3lockpb'
+
+require 'grpc'
+require_relative 'v3lock_pb'
+
+module V3lockpb
+  module Lock
+    class Service
+
+      include GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'v3lockpb.Lock'
+
+      # Lock acquires a distributed shared lock on a given named lock.
+      rpc :Lock, LockRequest, LockResponse
+      # Unlock takes a key returned by Lock and releases the hold on lock.
+      rpc :Unlock, UnlockRequest, UnlockResponse
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/etcdv3/kv.rb

@@ -2,6 +2,7 @@
 class Etcdv3
   class KV
     include Etcdv3::KV::Requests
+    include GRPC::Core::TimeConsts
 
     def initialize(hostname, credentials, timeout, metadata={})
       @stub = Etcdserverpb::KV::Stub.new(hostname, credentials)
@@ -36,7 +37,7 @@ class Etcdv3
     private
 
     def deadline(timeout)
-      Time.now.to_f + (timeout || @timeout)
+      from_relative_time(timeout || @timeout)
     end
 
     def generate_request_ops(requests)

data/lib/etcdv3/lease.rb

@@ -1,5 +1,7 @@
 class Etcdv3
   class Lease
+    include GRPC::Core::TimeConsts
+
     def initialize(hostname, credentials, timeout, metadata={})
       @stub = Etcdserverpb::Lease::Stub.new(hostname, credentials)
       @timeout = timeout
@@ -21,10 +23,17 @@ class Etcdv3
       @stub.lease_time_to_live(request, metadata: @metadata, deadline: deadline(timeout))
     end
 
+    def lease_keep_alive_once(id, timeout: nil)
+      request = Etcdserverpb::LeaseKeepAliveRequest.new(ID: id)
+      @stub.lease_keep_alive([request], metadata: @metadata, deadline: deadline(timeout)).each do |resp|
+        return resp
+      end
+    end
+
     private
 
     def deadline(timeout)
-      Time.now.to_f + (timeout || @timeout)
+      from_relative_time(timeout || @timeout)
     end
   end
 end

data/lib/etcdv3/lock.rb

@@ -0,0 +1,27 @@
+class Etcdv3
+  class Lock
+    include GRPC::Core::TimeConsts
+
+    def initialize(hostname, credentials, timeout, metadata = {})
+      @stub = V3lockpb::Lock::Stub.new(hostname, credentials)
+      @timeout = timeout
+      @metadata = metadata
+    end
+
+    def lock(name, lease_id, timeout: nil)
+      request = V3lockpb::LockRequest.new(name: name, lease: lease_id)
+      @stub.lock(request, deadline: deadline(timeout))
+    end
+
+    def unlock(key, timeout: nil)
+      request = V3lockpb::UnlockRequest.new(key: key)
+      @stub.unlock(request, deadline: deadline(timeout))
+    end
+
+    private
+
+    def deadline(timeout)
+      from_relative_time(timeout || @timeout)
+    end
+  end
+end

data/lib/etcdv3/protos/v3lock.proto

@@ -0,0 +1,55 @@
+syntax = "proto3";
+package v3lockpb;
+
+import "annotations.proto";
+import "rpc.proto";
+import "gogo.proto";
+
+option (gogoproto.marshaler_all) = true;
+option (gogoproto.unmarshaler_all) = true;
+
+service Lock {
+  // Lock acquires a distributed shared lock on a given named lock.
+  rpc Lock(LockRequest) returns (LockResponse) {
+      option (google.api.http) = {
+        post: "/v3alpha/lock/lock"
+        body: "*"
+    };
+  }
+
+  // Unlock takes a key returned by Lock and releases the hold on lock.
+  rpc Unlock(UnlockRequest) returns (UnlockResponse) {
+      option (google.api.http) = {
+        post: "/v3alpha/lock/unlock"
+        body: "*"
+    };
+  }
+}
+
+message LockRequest {
+  // name is the identifier for the distributed shared lock to be acquired.
+  bytes name = 1;
+  // lease is the ID of the lease that will be attached to ownership of the
+  // lock. If the lease expires or is revoked and currently holds the lock,
+  // the lock is automatically released. Calls to Lock with the same lease will
+  // be treated as a single acquisition; locking twice with the same lease is a
+  // no-op.
+  int64 lease = 2;
+}
+
+message LockResponse {
+  etcdserverpb.ResponseHeader header = 1;
+  // key is a key that will exist on etcd for the duration that the Lock caller
+  // owns the lock. Users should not modify this key or the lock may exhibit
+  // undefined behavior.
+  bytes key = 2;
+}
+
+message UnlockRequest {
+  // key is the lock ownership key granted by Lock.
+  bytes key = 1;
+}
+
+message UnlockResponse {
+  etcdserverpb.ResponseHeader header = 1;
+}

data/lib/etcdv3/version.rb

@@ -1,3 +1,3 @@
 class Etcdv3
-  VERSION = '0.8.3'.freeze
+  VERSION = '0.9.0'.freeze
 end

data/spec/etcdv3/lease_spec.rb

@@ -24,6 +24,16 @@ describe Etcdv3::Lease do
     end
   end
 
+  describe '#lease_keep_alive_once' do
+    let(:id) { stub.lease_grant(60)['ID'] }
+    subject { stub.lease_keep_alive_once(id) }
+    it { is_expected.to be_an_instance_of(Etcdserverpb::LeaseKeepAliveResponse) }
+    it 'raises a GRPC:DeadlineExceeded if the request takes too long' do
+      stub = local_stub(Etcdv3::Lease, 0)
+      expect { stub.lease_keep_alive_once(id) }.to raise_error(GRPC::DeadlineExceeded)
+    end
+  end
+
   describe '#lease_ttl' do
     let(:stub) { local_stub(Etcdv3::Lease, 1) }
     let(:lease_id) { stub.lease_grant(10)['ID'] }

data/spec/etcdv3/lock_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+# Locking is not implemented in etcd v3.1.X
+unless $instance.version < Gem::Version.new("3.2.0")
+  describe Etcdv3::Lock do
+    let(:stub) { local_stub(Etcdv3::Lock, 1) }
+    let(:lease_stub) { local_stub(Etcdv3::Lease, 1) }
+
+    it_should_behave_like "a method with a GRPC timeout", described_class, :unlock, :unlock, 'foo'
+    #it_should_behave_like "a method with a GRPC timeout", described_class, :lock, :lock, 'foo'
+
+    describe '#lock' do
+      let(:lease_id) { lease_stub.lease_grant(10)['ID'] }
+      subject { stub.lock('foo', lease_id) }
+      it { is_expected.to be_an_instance_of(V3lockpb::LockResponse) }
+    end
+
+    describe '#unlock' do
+      subject { stub.unlock('foo') }
+      it { is_expected.to be_an_instance_of(V3lockpb::UnlockResponse) }
+    end
+  end
+end

data/spec/etcdv3_spec.rb

@@ -1,8 +1,9 @@
 require 'spec_helper'
 
 describe Etcdv3 do
-  context 'Insecure connection without Auth' do
+  let(:lease_stub) { local_stub(Etcdv3::Lease, 1) }
 
+  context 'Insecure connection without Auth' do
     let(:conn) { local_connection }
 
     describe '#initialize' do
@@ -103,6 +104,26 @@ describe Etcdv3 do
       it_should_behave_like "Etcdv3 instance using a timeout", :get, 'apple'
     end
 
+    # Locking is not implemented in etcd v3.1.X
+    unless $instance.version < Gem::Version.new("3.2.0")
+      describe '#lock' do
+        let(:lease_id) { lease_stub.lease_grant(10)['ID'] }
+        subject { conn.lock('bar', lease_id) }
+        it { is_expected.to be_an_instance_of(V3lockpb::LockResponse) }
+      end
+
+      describe '#with_lock' do
+        let(:lease_id) { lease_stub.lease_grant(10)['ID'] }
+        let(:lease_id_2) { lease_stub.lease_grant(15)['ID'] }
+        it 'locks' do
+          conn.with_lock('foobar', lease_id) do
+            expect { conn.lock('foobar', lease_id_2, timeout: 0.1) }
+              .to raise_error(GRPC::DeadlineExceeded)
+          end
+        end
+      end
+    end
+
     describe '#put' do
       subject { conn.put('test', 'value') }
       it { is_expected.to_not be_nil }
@@ -160,6 +181,20 @@ describe Etcdv3 do
       end
     end
 
+    describe '#lease_keep_alive_once' do
+      let!(:lease_id) { conn.lease_grant(2)['ID'] }
+      subject { conn.lease_keep_alive_once(lease_id) }
+      it { is_expected.to_not be_nil }
+      it "raises a GRPC::DeadlineExceeded exception when it takes too long"  do
+        expect do
+          conn.lease_keep_alive_once(lease_id, timeout: 0)
+        end.to raise_exception(GRPC::DeadlineExceeded)
+      end
+      it "accepts a timeout" do
+        expect{ conn.lease_keep_alive_once(lease_id, timeout: 10) }.to_not raise_exception
+      end
+    end
+
     describe '#user_add' do
       after { conn.user_delete('test') rescue nil }
       subject { conn.user_add('test', 'user') }

data/spec/helpers/shared_examples_for_timeout.rb

@@ -1,22 +1,23 @@
 shared_examples_for "a method with a GRPC timeout" do |stub_class, method_name, expectation_target, *args|
+  include GRPC::Core::TimeConsts
+
   context "#{stub_class} timeouts for #{method_name}" do
     let(:handler) { local_stub(stub_class, 5) }
     let(:client_stub) { handler.instance_variable_get "@stub"}
     it 'uses the timeout value' do
-      start_time = Time.now
-      deadline_time = start_time.to_f + 5
-      allow(Time).to receive(:now).and_return(start_time)
+      deadline = from_relative_time(5)
+      allow(handler).to receive(:deadline).with(nil).and_return(deadline)
+      allow(handler).to receive(:deadline).with(5).and_return(deadline)
 
-      expect(client_stub).to receive(expectation_target).with(anything, hash_including(deadline: deadline_time)).and_call_original
+      expect(client_stub).to receive(expectation_target).with(anything, hash_including(deadline: deadline)).and_call_original
 
       handler.public_send(method_name, *args)
     end
 
     it "can have a seperate timeout passed in" do
-      start_time = Time.now
-      deadline_time = start_time.to_f + 1
-      allow(Time).to receive(:now).and_return(start_time)
-      expect(client_stub).to receive(expectation_target).with(anything, hash_including(deadline: deadline_time)).and_call_original
+      deadline = from_relative_time(1)
+      allow(handler).to receive(:deadline).with(1).and_return(deadline)
+      expect(client_stub).to receive(expectation_target).with(anything, hash_including(deadline: deadline)).and_call_original
       handler.public_send(method_name, *args, timeout: 1)
     end
 

data/spec/helpers/test_instance.rb

@@ -13,6 +13,8 @@ module Helpers
 
     MINIMUM_VERSION = Gem::Version.new('3.0.0')
 
+    attr_accessor :version
+
     def initialize
       @pids = []
       @tmpdir = Dir.mktmpdir

data/spec/spec_helper.rb

@@ -1,15 +1,17 @@
 $LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift File.expand_path('./helpers', __FILE__)
 
-require 'etcdv3'
 require 'simplecov'
 require 'codecov'
+SimpleCov.start
+SimpleCov.formatter = SimpleCov::Formatter::Codecov
+
+require 'etcdv3'
 require 'helpers/test_instance'
 require 'helpers/connections'
 require 'helpers/shared_examples_for_timeout'
 
-SimpleCov.start
-SimpleCov.formatter = SimpleCov::Formatter::Codecov
+$instance = Helpers::TestInstance.new
 
 RSpec.configure do |config|
   config.include(Helpers::Connections)
@@ -22,12 +24,11 @@ RSpec.configure do |config|
   end
   config.shared_context_metadata_behavior = :apply_to_host_groups
 
-  instance = Helpers::TestInstance.new
   config.before(:suite) do
-    # $stderr = File.open(File::NULL, "w")
-    instance.start
+    $stderr = File.open(File::NULL, "w")
+    $instance.start
   end
   config.after(:suite) do
-    instance.stop
+    $instance.stop
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: etcdv3
 version: !ruby/object:Gem::Version
-  version: 0.8.3
+  version: 0.9.0
 platform: ruby
 authors:
 - Shaun Davis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-05 00:00:00.000000000 Z
+date: 2018-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc
@@ -16,28 +16,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '1.17'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '1.17'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.6'
 description: Etcd v3 Ruby Client
 email: davissp14@gmail.com
 executables: []
@@ -50,19 +78,24 @@ files:
 - Gemfile
 - LICENSE
 - README.md
+- Rakefile
 - etcdv3.gemspec
 - lib/etcdv3.rb
 - lib/etcdv3/auth.rb
 - lib/etcdv3/connection.rb
 - lib/etcdv3/connection_wrapper.rb
+- lib/etcdv3/etcdrpc/annotations_pb.rb
 - lib/etcdv3/etcdrpc/auth_pb.rb
 - lib/etcdv3/etcdrpc/kv_pb.rb
 - lib/etcdv3/etcdrpc/rpc_pb.rb
 - lib/etcdv3/etcdrpc/rpc_services_pb.rb
+- lib/etcdv3/etcdrpc/v3lock_pb.rb
+- lib/etcdv3/etcdrpc/v3lock_services_pb.rb
 - lib/etcdv3/kv.rb
 - lib/etcdv3/kv/requests.rb
 - lib/etcdv3/kv/transaction.rb
 - lib/etcdv3/lease.rb
+- lib/etcdv3/lock.rb
 - lib/etcdv3/maintenance.rb
 - lib/etcdv3/protos/annotations.proto
 - lib/etcdv3/protos/auth.proto
@@ -71,6 +104,7 @@ files:
 - lib/etcdv3/protos/http.proto
 - lib/etcdv3/protos/kv.proto
 - lib/etcdv3/protos/rpc.proto
+- lib/etcdv3/protos/v3lock.proto
 - lib/etcdv3/version.rb
 - lib/etcdv3/watch.rb
 - spec/etcdv3/auth_spec.rb
@@ -78,6 +112,7 @@ files:
 - spec/etcdv3/connection_wrapper_spec.rb
 - spec/etcdv3/kv_spec.rb
 - spec/etcdv3/lease_spec.rb
+- spec/etcdv3/lock_spec.rb
 - spec/etcdv3/maintenance_spec.rb
 - spec/etcdv3_spec.rb
 - spec/helpers/connections.rb
@@ -104,7 +139,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: A Etcd client library for Version 3
@@ -114,6 +149,7 @@ test_files:
 - spec/etcdv3/connection_wrapper_spec.rb
 - spec/etcdv3/kv_spec.rb
 - spec/etcdv3/lease_spec.rb
+- spec/etcdv3/lock_spec.rb
 - spec/etcdv3/maintenance_spec.rb
 - spec/etcdv3_spec.rb
 - spec/helpers/connections.rb