Fixed hard-coded path to docbook stylesheet for building manpages in setup.py. Thanks to Zong Sharo. (Forest Bond)

Fixed rather serious bug that would have prevented pytagsfs mounts from working correctly when the mount point directory depth was smaller than the virtual path directory depth (as defined by the format string). (Forest Bond)

Re-work PathStore interface:

• create_directory was renamed to add_directory, and it is no longer an optional method for sub-classes to implement.
• remove_file and remove_directory have been replaced with a single method, remove.
• rename_file and rename_directory have been replaced with a single method, rename.
• Method get_real_subpaths was added (actually it was added previously, but the addition wasn't mentioned here).

Most users won't care about these changes. (Forest Bond)

Renames to paths containing too many levels of directories now fail with EINVAL. (Forest Bond)

Re-implemented pytagsfs.subspat and re-worked pytagsfs.sourcetreerep to use the new API. (Forest Bond)

Added PathStore meta-data methods: get_meta_data, set_meta_data, unset_meta_data. These are currently being used by SourceTreeRepresentation to store per-path Splitter objects. (Forest Bond)

Fixed some errors with getattr (stat):

• Instead of returning zero for atime, ctime, and mtime for empty directories, return times as for the source tree root directory.
• st_dev was being read from the source tree root for empty directories, or the source file for virtual files, but now is always set to zero. This is probably most correct given that our filesystem is virtual and those parameters are consequently meaningless.

(Forest Bond)

Fixed a bug in utime, which previously assumed that its argument was always a file end point. The new implementation updates the times on the source tree root if the argument is an empty directory, or updates all contained end points if the argument is a non-empty directory. (Forest Bond)

Files with tags containing slashes are not represented in the virtual directory tree. Log messages should indicate when this is the case. Change your tags if you want to see them. (Forest Bond)

PathStore implementations can now expect all paths to be specified as unicode strings (previously, ASCII byte strings were allowed). (Forest Bond)

Tags with multiple values are now supported. Files with multiple tag values will appear under multiple directories. Renames are supported. (Forest Bond)

pytags command-line options have changed:

• Option --pattern was renamed to --format to be consistent with pytagsfs itself.
• Option --add was added.
• The order of options is now important. --format must be specified first, if at all. --set, --add, and --remove are then process in order, with each option affecting tags as it is processed.

(Forest Bond)

Tags that mutagen does not treat as lists or tuples are ignored. I'm currently aware of some mp4 tags that are like this (cpil, pgap, pcst, tmpo). Other mp4 tags were already being handled specially to translate to mp4-specific representations (tracknumber/trkn). (Forest Bond)

Renamed test module "integration" to "blackbox". (Forest Bond)

Simplified many blackbox tests, and removed some that primarily tested functionality at a layer that is now being thoroughly unit tested. (Forest Bond)

Removed filesystem implementation of access method. We use -o default_permissions, anyway, so this method was probably not even being called (and would return incorrect results for directories if it was). (Forest Bond)

Fixed buggy handling of mutagen track number tag leading to an attempt to convert a list to an integer rather than converting each list member to an integer. (Forest Bond)

Renamed long version of mutagen substitution pattern "N" from "NUMBER" to "TRACKNUMBER" in order to be consistent with pair "n", "tracknumber". (Forest Bond)

Added mount option "-o nocache", which disables caching of stat results and other virtual path properties. (Forest Bond)

Added mount option "-o profile". This turns on some additional profiling output in the log file. (Forest Bond)

Implemented util/profile, a utility that can analyze profiling information in the log, as well as run standardized benchmarks. (Forest Bond)

In order to support benchmarking, a new meta store implementation was added: TestLinesMetaStore. This meta store implementation should not be used with real data files, as it has the potential to destory file data via renames. It is for testing and benchmarking only. (Forest Bond)

Added mount option "-o metastores", which allows the user to specify which meta store implementation(s) to use. This option is currently undocumented, and was primarily introduced to support standardized benchmarking. In the future, though, it will likely be useful for mounting directories containing non-media source files using alternative tag formats. (Forest Bond)

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)