Viat¶

A tool for managing virtual file attributes.

The essence of the tool is that the attributes are stored in plain text formats that can be edited and committed to version control. The main unit of operation is a vault, which is determined by .viat subdirectory. In the simplest case, this subdirectory contains config.toml, storage.toml and possibly schema.json. The source repository contains several examples of how this project can be useful.

The package is published as viat on PyPI. See the installation page for more details.

For usage, see the tutorial and the man page. In short, in an empty vault, the command

viat set file.pdf --raw attr value

puts the following into storage.toml:

["file.pdf"]
attr = "value"

Determining which files are tracked by Viat is done via tracker providers, while storing the attributes is done via storage providers. Both protocols are very general and new providers can easily be added.