ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

LSP-file-watcher-chokidar

by sublimelsp ST4

Chokidar-based file watcher implementation for LSP

Details

Installs

  • Total 7K
  • Win 2K
  • Mac 2K
  • Linux 2K
May 29 May 28 May 27 May 26 May 25 May 24 May 23 May 22 May 21 May 20 May 19 May 18 May 17 May 16 May 15 May 14 May 13 May 12 May 11 May 10 May 9 May 8 May 7 May 6 May 5 May 4 May 3 May 2 May 1 Apr 30 Apr 29 Apr 28 Apr 27 Apr 26 Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20 Apr 19 Apr 18 Apr 17 Apr 16 Apr 15 Apr 14
Windows 0 6 4 0 2 3 2 4 5 7 2 4 3 2 4 5 6 2 1 6 7 3 5 4 3 2 5 6 6 7 9 0 8 5 3 7 5 4 3 4 4 3 1 7 2 5
Mac 2 2 3 1 2 2 3 4 2 3 1 0 6 4 3 3 3 2 0 0 3 1 2 4 1 1 3 4 4 2 1 4 0 1 4 9 8 8 5 3 5 6 5 2 4 4
Linux 0 5 2 5 2 3 6 3 4 8 3 6 4 6 4 5 2 5 1 2 4 9 2 3 2 2 2 5 4 4 2 4 6 5 5 4 6 2 6 3 1 8 4 1 2 2

Readme

Source
raw.​githubusercontent.​com

LSP-file-watcher-chokidar

A non-native file watcher implementation for LSP that enables support for the workspace/didChangeWatchedFiles LSP notification.

Installation

  • Install LSP-file-watcher-chokidar from Package Control
  • Restart Sublime.

Usage

Having this package installed alongside LSP enables the workspace.didChangeWatchedFiles capability and support for the workspace/didChangeWatchedFiles notification. The servers can also dynamically register file watchers.

For LSP-* packages that are within the sublimelsp organization it should be enough to just install this package and file watching should work without any extra configuration.

In other cases, it might “just work” (if the server registers watchers dynamically) or it might require manual configuration using the the file_watcher object on the Client configuration object.

file_watcher object properties:

Name Optional Description
patterns No An array of glob patterns defining which files within the workspace should be watched. The patterns are relative to the workspace root. Example: ["{**/*.js,**/*.ts,**/*.json}"]. See also supported pattern syntax.
events Yes An array with the type of events to watch. Default: ["create", "change", "delete"] (all supported types).
ignores Yes An array of glob exclude patterns. By default this includes patterns from Sublime Text's folder_exclude_patterns and file_exclude_patterns settings and additionally the '**/node_modules/**' pattern. When overriding this option the defaults are not included anymore.

Implementation

Registering a watcher creates a new Node process behind the scenes. The current implementation creates at most one process for any number of registrations (even through different language servers).

The reason that this is implemented as a separate package, and not natively within the LSP package, is that this relies on a separate process that does the file watching and for the built-in implementation we would like to use a native API provided by Sublime Text that it doesn't provide at the moment. See the LSP issue #892 for supporting it natively within the LSP package.