Class: Listen::Adapters::Darwin

Inherits:
Listen::Adapter show all
Extended by:
DependencyManager
Defined in:
lib/listen/adapters/darwin.rb

Overview

Adapter implementation for Mac OS X ‘FSEvents`.

Constant Summary collapse

LAST_SEPARATOR_REGEX = 
/\/$/

Constants included from DependencyManager

DependencyManager::BUNDLER_DECLARE_GEM, DependencyManager::GEM_INSTALL_COMMAND, DependencyManager::GEM_LOAD_MESSAGE

Constants inherited from Listen::Adapter

Listen::Adapter::DEFAULT_LATENCY, Listen::Adapter::MISSING_DEPENDENCY_MESSAGE, Listen::Adapter::POLLING_FALLBACK_MESSAGE

Instance Attribute Summary

Attributes inherited from Listen::Adapter

#directories, #latency, #paused

Class Method Summary collapse

Instance Method Summary collapse

Methods included from DependencyManager

add_loaded, already_loaded?, clear_loaded, dependencies_loaded?, dependency, extended, load_depenencies

Methods inherited from Listen::Adapter

#report_changes, select_and_initialize, #started?, usable_and_works?, #wait_for_callback, #wait_for_changes, works?

Constructor Details

#initialize(directories, options = {}, &callback) ⇒ Darwin

Initializes the Adapter. See Listen::Adapter#initialize for more info.



16
17
18
19
 
# File 'lib/listen/adapters/darwin.rb', line 16

def initialize(directories, options = {}, &callback)
  super
  @worker = init_worker
end

Class Method Details

.usable? ⇒ Boolean

Checks if the adapter is usable on the current OS.

Returns:

  • (Boolean) —

    whether usable or not



59
60
61
62
 
# File 'lib/listen/adapters/darwin.rb', line 59

def self.usable?
  return false unless RbConfig::CONFIG['target_os'] =~ /darwin(1.+)?$/i
  super
end

Instance Method Details

#start(blocking = true) ⇒ Object

Starts the adapter.

Parameters:

  • blocking (Boolean) (defaults to: true) —

    whether or not to block the current thread after starting



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'lib/listen/adapters/darwin.rb', line 25

def start(blocking = true)
  @mutex.synchronize do
    return if @stop == false
    super
  end

  @worker_thread = Thread.new { @worker.run }

  # The FSEvent worker needs sometime to startup. Turnstiles can't
  # be used to wait for it as it runs in a loop.
  # TODO: Find a better way to block until the worker starts.
  sleep 0.1

  @poll_thread = Thread.new { poll_changed_dirs } if @report_changes
  @worker_thread.join if blocking
end

#stop ⇒ Object

Stops the adapter.



44
45
46
47
48
49
50
51
52
53
 
# File 'lib/listen/adapters/darwin.rb', line 44

def stop
  @mutex.synchronize do
    return if @stop == true
    super
  end

  @worker.stop
  @worker_thread.join if @worker_thread
  @poll_thread.join if @poll_thread
end