Swift File System Monitor is a Swift 5 library used to monitor changes to the filesystem. It is based on the convenient APIs from Daniel Pedersen's SKQueue but replaces kevent with Dispatch Source as the means for monitoring changes. The mechanism is similar to Apple's own Directory Monitor (reference to which can be found here), but SFSMonitor gives a complete API for maintaining a whole queue of watched files and folders.
- Swift 5
- Swift tools version 4
To add SFSMonitor to your Xcode project, simply add a Swift Package with the address
https://github.com/ClassicalDude/SFSMonitor.gitTo monitor the filesystem with SFSMonitor, you first need a SFSMonitorDelegate instance that can accept notifications.
URLs to watch can then be added with addUrl, as per the example below. The addUrl method returns an integer value: 0 for success, 1 if the URL is already monitored, 2 if maximum number of monitored files and directories is reached, 3 for general error.
Note: iOS, iPadOS and MacOS all have a limit on how many files and directories can be opened simultaneously, even just for the purpose of monitoring. That number includes all files used by your app, and as of iOS and iPadOS 13, and MacOS Catalina, it is set to 256 files. For more details, please read here. SFSMonitor has a limit set at 224 files and directories, which can be changed by altering the static variable SFSMonitor.maxMonitored.
Since it manages limited OS resources, all class instances will refer to the same static variables and dictionaries.
The code is well documented - please go through it for more details and methods.
import SFSMonitor
class SomeClass: SFSMonitorDelegate {
let monitorDispatchQueue = DispatchQueue(label: "monitorDispatchQueue", qos: .utility)
func receivedNotification(_ notification: SFSMonitorNotification, url: URL, queue: SFSMonitor) {
// Place actions into a utility-level Dispatch Queue.
// Remember to call UI updates from DispatchQueue.main.async blocks.
monitorDispatchQueue.async(flags: .barrier) { // Multithread protection
print("\(notification.toStrings().map { $0.rawValue }) @ \(url.path)")
}
}
}
let delegate = SomeClass()
let queue = SFSMonitor(delegate: delegate)
queue?.setMaxMonitored(number: 200)
_ = queue.addURL(URL(fileURLWithPath: "/Users/steve/Documents"))
let test = queue.addURL(URL(fileURLWithPath: "/Users/steve/Documents"))
if test == 1 {
print("The URL has already been added to the queue")
}
_ = queue.addURL(URL(fileURLWithPath: "/Users/steve/Documents/dog.jpg"))| Action | Sample Output |
|---|---|
Add or remove file in /Users/steve/Documents |
["Write"] @ /Users/steve/Documents |
Add or remove directory in /Users/steve/Documents |
["Write", "LinkCountChange"] @ /Users/steve/Documents |
Write to file /Users/steve/Documents/dog.jpg |
["Rename", "SizeIncrease"] @ /Users/steve/Documents/dog.jpg |
Important: when you call the removeAllURLs() function, it is performed asynchronously. Therefore, you must make sure it completes before adding new paths to watch. You can do so with a timer, as long as you make sure you set the main thread for the timer. If you wish for the timer thread to be a background thread, follow this tutorial.
let delegate = SomeClass()
let queue = SFSMonitor(delegate: delegate)
// Reset the queue
queue?.removeAllURLs()
// Add paths with a timer block, to make sure the queue reset has completed.
DispatchQueue.main.async {
Timer.scheduledTimer(withTimeInterval: 0.5, repeats: true) { (timer) in
if self.queue?.numberOfWatchedURLs() == 0 {
timer.invalidate()
// Add paths here
_ = queue.addURL(URL(fileURLWithPath: "/Users/steve/Documents"))
// ...
}
}
}- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D