Pretty-up log format a bit:

• Include time stamps.
• Use prettier description of function for "Entering x" and "Leaving x" messages.

(Forest Bond)

Rewrote command-line option parsing. Options are now handled completely independently from the underlying FUSE library. The following options are no longer supported:

• -o default_permissions
• -o fsname
• -o large_read
• -o max_read
• -o hard_remove
• -o use_ino
• -o readdir_ino
• -o direct_io
• -o kernel_cache
• -o umask
• -o entry_timeout
• -o negative_timeout
• -o attr_timeout

In general, the options for which support was removed are now considered implementation details, as they should have been previously. (Forest Bond)

Fix incompatibility with python-fuse 0.2 by returning fuse.Stat instances instead of os.stat_result instances from getattr, fgetattr. This issue did not exist with python-fuse 0.2pre3. Previously, users of 0.2 would see EINVAL from stat calls. Reported by Chris Pickel, Jeremy Jones. (Forest Bond)

Added option -o verbosity=VERBOSITY; VERBOSITY should be one of debug, info, warning, error, critical. -d/-o debug overrides this, and forces verbosity to debug. (Forest Bond)

With -d/-o debug, log to both .log and stderr. Otherwise, log to .log only. (Forest Bond)

Limit size of in-memory log file (.log) to 1MB. (Forest Bond)

Allow size of in-memory log file to be overridden via -o logsize. (Forest Bond)

Fixed bug preventing addition of tags to previously untagged mp3 files. (Forest Bond)

Improved inotify performance for case where source files are updated numerous times between event processing calls; DeferredInotifySourceTreeMonitor. (Forest Bond)

Improved performance by only processing add, remove, and update events for sources files after initialization (post populate) and prior to getattr calls. (Forest Bond)

Fix bug causing reads on a recently truncated fd to return the removed content by using direct_io = True for ReadWriteFile's. (Forest Bond)

Fix bug (sort of) where getattr calls for a file currently open for writing return the size of the file before being opened. Now, we defer to fgetattr on the open file object. This would cause, for instance, mutagen to badly truncate OGG files. (Forest Bond)

Fix broken setup.py that forgets to install sub-packages. (Forest Bond)

Fix missing import log_traceback in pytagsfs.sourcetree. (Forest Bond)

Fix handling of transient conflicts. Previously, when two or more source files map to the same file name under the mount point, and one of those source files was either removed or modified such that it mapped to a different path, the mount path became a "dead" file, with zero links. Now, that path will become reassociated with the next source file candidate. (Forest Bond)

Fix pytags, pytagsfs always exiting with zero status, despite errors. (Forest Bond)

Log to stderr when option -f/-o foreground is specified. (Forest Bond)

Introduced fallback mechanism for source tree change monitoring backends. Source tree monitors are tried in the following order: pyinotify, gamin, dummy.

• pyinotify only works on Linux, but is faster than gamin.
• gamin possibly works on other Unix-like systems (like the BSD's).
• The dummy backend doesn't actually do anything, so changes to the source tree are not reflected in the mount tree.

Non-Linux users should report success or failure with the gamin backend.

(Forest Bond)

Added BUGS. (Forest Bond)

A virtual log file (".log") is created under the moint point. The contents of this file are stored in memory. In the event of a (detected) bug, tracebacks and other critical debugging data will be accessible by reading this file. (Forest Bond)

If a file is truncated (directly, without being opened), the effects of this are not immediately visible. Reads will continue to return the file contents prior to truncation. However, if the file is opened in write-only or read-write mode, the truncation will be apparent to the opener. Once the file is closed, reads will return the new content. This makes it possible to successfully re-tag files in such a way that the file path changes. (Forest Bond)

Write support is now considered reliable. (Forest Bond)

Removed support for the following filesystem functions, which were either incorrect or irrelevant given currently supported features:

• readlink
• mknod
• mkdir
• unlink
• symlink
• rename
• link

(Forest Bond)

Fixed incorrect stat results due to out of date cache values. This also corrects issue where writes would not show up in mounted tree. (Forest Bond)

Drastic performance improvement via stat() result caching. (Forest Bond)

Fixed bug in setup.py causing version information to be excluded from generated .egg file. (Forest Bond)