Class: Zlk::Lock

Inherits:
Object
  • Object
show all
Defined in:
lib/zlk/lock.rb

Constant Summary collapse

LockWaitTimeoutError = 
Class.new(StandardError)

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(path) ⇒ Lock

Returns a new instance of Lock.



9
10
11
 
# File 'lib/zlk/lock.rb', line 9

def initialize(path)
  @path = sanitize_path(path)
end

Instance Attribute Details

#path ⇒ Object (readonly)

Returns the value of attribute path.



7
8
9
 
# File 'lib/zlk/lock.rb', line 7

def path
  @path
end

Instance Method Details

#acquirable? ⇒ Boolean

Returns:

  • (Boolean) 


39
40
41
42
43
 
# File 'lib/zlk/lock.rb', line 39

def acquirable?
  with_locker do |locker|
    locker.acquirable?
  end
end

#run_exclusively ⇒ Object 



13
14
15
16
17
 
# File 'lib/zlk/lock.rb', line 13

def run_exclusively
  with_locker do |locker|
    locker.with_lock(wait: true) { yield }
  end
end

#with_timeout(timeout) ⇒ Object 



19
20
21
22
23
24
25
26
27
 
# File 'lib/zlk/lock.rb', line 19

def with_timeout(timeout)
  with_locker do |locker|
    begin
      locker.with_lock(wait: timeout) { yield(true) }
    rescue ZK::Exceptions::LockWaitTimeoutError => e
      yield(false)
    end
  end
end

#with_timeout!(timeout) ⇒ Object 



29
30
31
32
33
34
35
36
37
 
# File 'lib/zlk/lock.rb', line 29

def with_timeout!(timeout)
  with_timeout(timeout) do |locked|
    if locked
      yield
    else
      fail Zlk::Lock::LockWaitTimeoutError
    end
  end
end