The stream's element is now the enum InotifyEvent, and the struct that describes a change to a watched item is FileSystemEvent. A queue overflow was an event with descriptor -1 and an empty path that every consumer had to know about; as a case, the compiler makes them handle it. The enum is also where failed watches of a growing tree will be reported, since no call site can catch them.
33 lines
1.1 KiB
Swift
33 lines
1.1 KiB
Swift
import SystemPackage
|
|
|
|
/// A change to a watched file or directory, as delivered by an ``Inotify``
|
|
/// instance inside ``InotifyEvent/fileSystem(_:)``.
|
|
public struct FileSystemEvent: Sendable, Hashable, CustomStringConvertible {
|
|
public let watchDescriptor: Int32
|
|
public let mask: InotifyEventMask
|
|
public let cookie: UInt32
|
|
public let path: FilePath
|
|
/// Whether the event was produced by the library for an item that already
|
|
/// existed when its directory became watched, rather than by the kernel.
|
|
public let synthesized: Bool
|
|
|
|
public var description: String {
|
|
var parts = ["FileSystemEvent(wd: \(watchDescriptor), mask: \(mask), path: \"\(path)\""]
|
|
if cookie != 0 { parts.append("cookie: \(cookie)") }
|
|
return parts.joined(separator: ", ") + ")"
|
|
}
|
|
}
|
|
|
|
extension FileSystemEvent {
|
|
public init(from rawEvent: RawInotifyEvent, inDirectory path: String) {
|
|
let dirPath = FilePath(path)
|
|
self.init(
|
|
watchDescriptor: rawEvent.watchDescriptor,
|
|
mask: rawEvent.mask,
|
|
cookie: rawEvent.cookie,
|
|
path: dirPath.appending(rawEvent.name),
|
|
synthesized: rawEvent.synthesized
|
|
)
|
|
}
|
|
}
|