OLD | NEW |
| (Empty) |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | |
2 // for details. All rights reserved. Use of this source code is governed by a | |
3 // BSD-style license that can be found in the LICENSE file. | |
4 | |
5 library watcher.directory_watcher; | |
6 | |
7 import 'dart:io'; | |
8 | |
9 import 'watch_event.dart'; | |
10 import '../watcher.dart'; | |
11 import 'directory_watcher/linux.dart'; | |
12 import 'directory_watcher/mac_os.dart'; | |
13 import 'directory_watcher/windows.dart'; | |
14 import 'directory_watcher/polling.dart'; | |
15 | |
16 /// Watches the contents of a directory and emits [WatchEvent]s when something | |
17 /// in the directory has changed. | |
18 abstract class DirectoryWatcher implements Watcher { | |
19 /// The directory whose contents are being monitored. | |
20 @Deprecated("Expires in 1.0.0. Use DirectoryWatcher.path instead.") | |
21 String get directory; | |
22 | |
23 /// Creates a new [DirectoryWatcher] monitoring [directory]. | |
24 /// | |
25 /// If a native directory watcher is available for this platform, this will | |
26 /// use it. Otherwise, it will fall back to a [PollingDirectoryWatcher]. | |
27 /// | |
28 /// If [pollingDelay] is passed, it specifies the amount of time the watcher | |
29 /// will pause between successive polls of the directory contents. Making this | |
30 /// shorter will give more immediate feedback at the expense of doing more IO | |
31 /// and higher CPU usage. Defaults to one second. Ignored for non-polling | |
32 /// watchers. | |
33 factory DirectoryWatcher(String directory, {Duration pollingDelay}) { | |
34 if (FileSystemEntity.isWatchSupported) { | |
35 if (Platform.isLinux) return new LinuxDirectoryWatcher(directory); | |
36 if (Platform.isMacOS) return new MacOSDirectoryWatcher(directory); | |
37 if (Platform.isWindows) return new WindowsDirectoryWatcher(directory); | |
38 } | |
39 return new PollingDirectoryWatcher(directory, pollingDelay: pollingDelay); | |
40 } | |
41 } | |
OLD | NEW |