Changelog — pyfuse3 3.4.3.dev19+g57a14ee07.d20260509 documentation

# Changelog

## pyfuse 3.5.0 (2026-05-13)

- Filesystems may now define a `poll` method to support the `epoll` and `select` system calls.

- The `FileHandleT` and `InodeT` types are no longer declared as NewTypes but are now simply aliases for int. This should make it easier to write type annotations.

- Future releases of pyfuse will be signed with signify rather than GPG. The public key to verify the signature of a the next version will always be included in the previous versions, so this version already ships the public key that will be used to sign the next versions, `signify/pyfuse-3.5.pub` for any bugfix releases and `signify/pyfuse-next.pub` for the next minor (or major) release.

## pyfuse 3.4.2 (2026-01-06)

- Removed the `pyfuse3_asyncio` module. This has been renamed to `pyfuse3.asyncio` for quite some time.

- Fixed a test failure in test_examples.py

- Many internal changes, modernizing build process and adding more type annotations.

## Release 3.4.1 (2025-12-22)

- Cythonized with latest Cython 3.2.3.

- CI: also test on Python 3.14, on Ubuntu 24.04.

- asyncio:

  - use .run and .get_running_loop, #106.

  - replace deprecated Future() with create_future; fix lazy trio.Lock init.

- use SPDX license identifier, #107

- fix LICENSE text: LGPL v2.1, #102

## Release 3.4.0 (2024-08-28)

- Cythonized with latest Cython 3.0.11 to support Python 3.13.

- CI: also test python 3.13, run mypy.

- Move `_pyfuse3` to `pyfuse3._pyfuse3` and add a compatibility wrapper for the old name.

- Move `pyfuse3_asyncio` to `pyfuse3.asyncio` and add a compatibility wrapper for the old name.

- Add `bytes` subclass `XAttrNameT` as the type of extended attribute names.

- Various fixes to type annotations.

- Add `py.typed` marker to enable external use of type annotations.

## Release 3.3.0 (2023-08-06)

- Note: This is the first pyfuse3 release compatible with Cython 3.0.0 release. Cython 0.29.x is also still supported.

- Cythonized with latest Cython 3.0.0.

- Drop Python 3.6 and 3.7 support and testing, #71.

- CI: also test python 3.12. test on cython 0.29 and cython 3.0.

- Tell Cython that callbacks may raise exceptions, #80.

- Fix lookup in examples/hello.py, similar to #16.

- Misc. CI, testing, build and sphinx related fixes.

## Release 3.2.3 (2023-05-09)

- cythonize with latest Cython 0.29.34 (brings Python 3.12 support)

- add a minimal pyproject.toml, require setuptools

- tests: fix integer overflow on 32-bit arches, fixes #47

- test: Use shutil.which() instead of external which(1) program

- setup.py: catch more generic OSError when searching Cython, fixes #63

- setup.py: require Cython >= 0.29

- fix basedir computation in setup.py (fix pip install -e .)

- use sphinx < 6.0 due to compatibility issues with more recent versions

## Release 3.2.2 (2022-09-28)

- remove support for python 3.5 (broken, out of support by python devs)

- cythonize with latest Cython 0.29.x (brings Python 3.11 support)

- use github actions for CI, remove travis-ci

- update README: minimal maintenance, not developed

- update setup.py with tested python versions

- examples/tmpfs.py: work around strange kernel behaviour (calling SETATTR after UNLINK of a (not open) file): respond with ENOENT instead of crashing.

## Release 3.2.1 (2021-09-17)

- Add type annotations

- Passing a XATTR_CREATE or XATTR_REPLACE to `setxattr` is now working correctly.

## Release 3.2.0 (2020-12-30)

- Fix long-standing rounding error in file date handling when the nanosecond part of file dates were > 999999500.

- There is a new `pyfuse3.terminate()` function to gracefully end the main loop.

## Release 3.1.1 (2020-10-06)

- No source changes. Regenerated Cython files with Cython 0.29.21 for Python 3.9 compatibility.

## Release 3.1.0 (2020-05-31)

- Made compatible with newest Trio module.

## Release 3.0.0 (2020-05-08)

- Changed `create` handler to return a `FileInfo` struct to allow for modification of certain kernel file attributes, e.g. `direct_io`.

  Note that this change breaks backwards compatibility, code that depends on the old behavior needs to be changed.

## Release 2.0.0

- Changed `open` handler to return the new `FileInfo` struct to allow for modification of certain kernel file attributes, e.g. `direct_io`.

  Note that this change breaks backwards compatibility, code that depends on the old behavior needs to be changed.

## Release 1.3.1 (2019-07-17)

- Fixed a bug in the `hello_asyncio.py` example.

## Release 1.3 (2019-06-02)

- Fixed a bug in the `tmpfs.py` and `passthroughfs.py` example file systems (so rename operations no longer fail).

## Release 1.2 (2018-12-22)

- Clarified that `invalidate_inode` may block in some circumstances.

- Added support for using the asyncio module instead of Trio.

## Release 1.1 (2018-11-02)

- Fixed `examples/passthroughfs.py` - was not handling readdir() correctly.

- `invalidate_entry_async` now accepts an additional ignore_enoent parameter. When this is set, no errors are logged if the kernel is not actually aware of the entry that should have been removed.

## Release 1.0 (2018-10-08)

- Added a new `syncfs` function.

## Release 0.9 (2018-09-27)

- First release

- pyfuse3 was forked from python-llfuse - thanks for all the work!

- If you need compatibility with Python 2.x or libfuse 2.x, you may want to take a look at python-llfuse instead.