listen 1.1.6 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 15c2061b4e5946ad201164615031c72bffe85ff0
-  data.tar.gz: c62a6832ec7627b5c5d62f319a69e5f0ec2a1a71
+  metadata.gz: 8776e2e4466c49d67aa6697bcee59db998508757
+  data.tar.gz: 296383775b460f0177cfb73232a20fee9aa15a97
 SHA512:
-  metadata.gz: d0d771a559f389f1d7992966fe0a92cf5966dab2ddd31687ee284d292718b846151580bf1ddaa624432daeb677d01fc7af5763a4ebc60e9b010b9691eac2b944
-  data.tar.gz: ec49484e993dca69208d7034e308fe8b1988ce551bbc898f6e614d831b6206cc5fe4a5e7c9843ade6ea61551003287bc216598992b9841f106b8f9f6d0ac2b84
+  metadata.gz: 154daba042dadf9e3a2b88e0ad8a5e9d4a9fde2768b0918556c3b76160d1dbf123ddb9fc9484e88468a2a5cd122bc37c4ab50b347f27b1949346db15c9eb0bd2
+  data.tar.gz: 89a846a26738db61e4128c2d81421efcabcba3c0312e854afc44a7353e142dd01347f99530534155007977bc8b8df64fa59dd3d97d8f875d64115ff2c5f66a83

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.2.0 - Jun 11, 2013
+
+### Improvement
+
+- [#124][] New `force_adapter` option, skip the `.listen_test` adapter test. ([@nicobrevin][])
+
 ## 1.1.6 - Jun 4, 2013
 
 ### Change
@@ -310,6 +316,7 @@
 [#118]: https://github.com/guard/listen/issues/118
 [#120]: https://github.com/guard/listen/issues/120
 [#122]: https://github.com/guard/listen/issues/122
+[#124]: https://github.com/guard/listen/issues/124
 [@Maher4Ever]: https://github.com/Maher4Ever
 [@ahoward]: https://github.com/ahoward
 [@akerbos]: https://github.com/akerbos
@@ -329,6 +336,7 @@
 [@napcs]: https://github.com/napcs
 [@netzpirat]: https://github.com/netzpirat
 [@nex3]: https://github.com/nex3
+[@nicobrevin]: https://github.com/nicobrevin
 [@nilbus]: https://github.com/nilbus
 [@nysalor]: https://github.com/nysalor
 [@piotr-sokolowski]: https://github.com/piotr-sokolowski

data/README.md

@@ -87,6 +87,7 @@ listener = listener.filter(/\.rb$/)
 listener = listener.latency(0.5)
 listener = listener.force_polling(true)
 listener = listener.polling_fallback_message(false)
+listener = listener.force_adapter(Listen::Adapters::Linux)
 listener = listener.change(&callback)
 listener.start
 ```
@@ -207,6 +208,9 @@ or via ["Object" API](#object-api) methods:
 :latency => 0.5                               # Set the delay (**in seconds**) between checking for changes
                                               # default: 0.25 sec (1.0 sec for polling)
 
+:force_adapter => Listen::Adapters::Linux     # Force the use of a particular adapter class
+                                              # default: none
+
 :force_polling => true                        # Force the use of the polling adapter
                                               # default: none
 
@@ -276,6 +280,11 @@ want to force the use of the polling adapter, either use the `:force_polling` op
 while initializing the listener or call the `#force_polling` method on your listener
 before starting it.
 
+It is also possible to force the use of a particular adapter, by using the `:force_adapter`
+option.  This option skips the usual adapter choosing mechanism and uses the given
+adapter class instead.  The adapter choosing mechanism requires write permission
+to your watched directories and will needlessly load code, which isn't always desirable.
+
 ## Polling fallback
 
 When a OS-specific adapter doesn't work the Listen gem automatically falls back to the polling adapter.

data/lib/listen/adapter.rb

@@ -42,7 +42,15 @@ module Listen
     # @return [Listen::Adapter] the chosen adapter
     #
     def self.select_and_initialize(directories, options = {}, &callback)
-      return Adapters::Polling.new(directories, options, &callback) if options.delete(:force_polling)
+      forced_adapter_class = options.delete(:force_adapter)
+      force_polling = options.delete(:force_polling)
+
+      if forced_adapter_class
+        forced_adapter_class.load_dependent_adapter
+        return forced_adapter_class.new(directories, options, &callback)
+      end
+
+      return Adapters::Polling.new(directories, options, &callback) if force_polling
 
       OPTIMIZED_ADAPTERS.each do |adapter|
         namespaced_adapter = Adapters.const_get(adapter)

data/lib/listen/listener.rb

@@ -21,6 +21,7 @@ module Listen
     # @option options [Boolean] relative_paths whether or not to use relative-paths in the callback
     # @option options [Boolean] force_polling whether to force the polling adapter or not
     # @option options [String, Boolean] polling_fallback_message to change polling fallback message or remove it
+    # @option options [Class] force_adapter force the use of this adapter class, skipping usual adapter selection
     #
     # @yield [modified, added, removed] the changed files
     # @yieldparam [Array<String>] modified the list of modified files
@@ -180,6 +181,21 @@ module Listen
       self
     end
 
+    # Sets whether to force the use of a particular adapter, rather than
+    # going through usual adapter selection process on start.
+    #
+    # @example Force use of Linux polling
+    #   force_adapter Listen::Adapters::Linux
+    #
+    # @param [Class] adapter class to use for file system event notification.
+    #
+    # @return [Listen::Listener] the listener
+    #
+    def force_adapter(adapter_class)
+      @adapter_options[:force_adapter] = adapter_class
+      self
+    end
+
     # Sets whether the paths in the callback should be
     # relative or absolute.
     #

data/lib/listen/version.rb

@@ -1,3 +1,3 @@
 module Listen
-  VERSION = '1.1.6'
+  VERSION = '1.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: listen
 version: !ruby/object:Gem::Version
-  version: 1.1.6
+  version: 1.2.0
 platform: ruby
 authors:
 - Thibaud Guillaume-Gentil
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-04 00:00:00.000000000 Z
+date: 2013-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rb-fsevent