tessl/pypi-pyfuse3
Python 3 bindings for libfuse 3 with async I/O support
anti-patterns.mddocs/examples/
Anti-Patterns
Common mistakes and what to do instead.
Wrong Exception Type
❌ Wrong
async def lookup(self, parent_inode, name, ctx):
if name not in self.entries:
raise KeyError("Not found") # Crashes filesystem!✅ Correct
async def lookup(self, parent_inode, name, ctx):
if name not in self.entries:
raise pyfuse3.FUSEError(errno.ENOENT)Premature Inode Deletion
❌ Wrong
async def unlink(self, parent_inode, name, ctx):
inode = self._find_entry(parent_inode, name)
del self.inodes[inode] # Kernel may still reference it!✅ Correct
async def unlink(self, parent_inode, name, ctx):
inode = self._find_entry(parent_inode, name)
self.inodes[inode]['nlink'] -= 1
# Deleted in forget() when safeBlocking Operations
❌ Wrong
async def read(self, fh, offset, size):
time.sleep(1) # Blocks worker task!
return self.data[offset:offset + size]✅ Correct
async def read(self, fh, offset, size):
await trio.sleep(1) # Yields to other tasks
return self.data[offset:offset + size]