v3.0.0

KNOWN ISSUES

• #319, #258 - TCP is no longer part of Listen, and there's currently no alternative except downgrading to Listen 2.x

API CHANGES

• TCP functionality removed (Listen.on, Adapter::TCP, Adapter::TCP::Broadcaster, etc.)
• Listener#start should be used instead of Listener#unpause
• Listener#directories is no longer available
• Listener#options is no longer available as public API

IMPROVEMENTS

• Major performance improvements (CPU), especially for Polling
• Celluloid is no longer required by Listen (which means: better performance, less dependencies, less threads used, less version conflicts, easier debugging, less potential issues/bugs)
• TCP is no longer part of Listen (which means: more maintainable codebase and possibility to create much better TCP implementation without the tradeoffs)

Development

• major codebase rewrite
• better logging by default

v2.10.1

Bugfixes

• #320 - latency option was completely ignored for both OSX and when Polling
• #302 - fix bug related to move_to/move_from breaking TCP functionality

v2.10.0

Major changes

• #304 - lock to Cellulloid 0.16 (if you need Celluloid 0.15, use Listen 2.9.0 and ask for backports if necessary)

Bugfixes

• #301 - avoid BSD adapter crash when watched file doesn't exist

Improvements

• #303 - allow listen tool to watch multiple directories

v2.9.0

Improvements

• #297 - implement :relative option (mostly for TCP when paths differ between VM host and guest)

v2.8.6

Bugfixes

• #296 - avoid crashing when network filesystem is disconnected

v2.8.5

Bugfixes

• #292 - BSD support re-added (thanks to @smortex!)

Improvements

• #291 - avoid evaluating code in debug log statements
• removed unnecessary content from gem (spec files, etc.)

v2.8.4

Improvements

• #288 - Listen now reports sed -i command on a file as :modified and not :added

v2.8.3

Bugfixes

• #282 fix regression where files are incorrectly included in symlink loop checking

v2.8.2

Improvements

• #273 Listen now tries to skip scanning duplicate directories (see details below)

Duplicate directory handling

Previous versions of listen (2.8.0 and 2.8.1) aborted on duplicate directories.

Now, an error is shown and listen continues (and how the backend handles this is undefined).

More details here: https://github.com/guard/listen/wiki/Duplicate-directory-errors

v2.8.1

Improvements

Improve error message about symlinks with more specific tips on what to do.

Notes

Given 2.8.x has little improvements over 2.7.x, it's perfectly fine to freeze to the previous version until automatic duplicate directory autodetection is implemented.

In your Gemfile:

gem 'listen', '~> 2.7.12'

NOTE: Sass/Compass has a compatibility issue with Listen since 2.7.12, so you may want to lock your version to 2.7.11 until the following patch is released: sass/sass#1527