Skip to content

v2.8.0

Compare
Choose a tag to compare
@e2 e2 released this 15 Nov 13:30
· 475 commits to master since this release

Improvements

  • #273 abort on filesystem loop

Notes

Listen will refuse to watch multiple copies of a physical directory within a watched directory.

This means you can either watch symlinked directories or the real ones - but not both.

This also means you can only have one symlink to a physical directory (which has to be outside the watched directory anyway).

Reasoning

It may be very "convenient" to listen to a "whole project", but this causes a confusion and a whole array of issues with symlinks.

Solutions / workarounds

  1. Ideally, watch only the physical directories you need to monitor

  2. Help with a technically related feature request #274 (PRs are welcome)

  3. Freeze Listen in your Gemfile:

gem 'listen', '~> 2.7.12'

Issues

If none of the above solutions are acceptable in your case, feel free to post new issues or comment on existing ones

If despite this change symlinks don't work as accepted, please file a bug with a specific issue.

Caveats

On Linux, Listen "cheats" by translating events on physical paths to being relative to the watched directory.

This make is seem like Listen handles symlinks transparently, but likely won't work in every case.

(Feel free to post specific cases causing problems).