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 |