Ratarmount

Semantic versioning of GUIs and CLIs is not easy to define.
The simplest GUI usage has not changed since the first version and even the index file format has been mostly compatible since version 0.2.0 and there is a lot of code for version checking.
Based on the [semver](https://semver.org/) FAQ, the 1.0.0. release should probably have been a long time ago.
Here it is now!

Features

- Bundle modified fusepy in order to add libfuse3 support in case only that one is installed.
Contributions to the [mfusepy](https://github.com/mxmlnkn/mfusepy) fork would be welcome!
- Add message for first time users to show the result mount point.
- (ratarmountcore 0.8.0) Add fsspec implementation and register it as ratar://.
- (ratarmountcore 0.8.0) Add support for new formats: SquashFS, Git, FAT12, FAT16, FAT32.
- (ratarmountcore 0.8.0) Add support for fsspec backends. Archives and even index files can now be specified via URIs:
dropbox://, ftp://, git://, github://, http://, https://, ipfs://, ipns://, s3://, ssh://, sftp://, smb://, webdav://.
- (ratarmountcore 0.8.0) Add support for remote and compressed index files. Ratarmount will automatically look for
index files with .gz and other common extensions and extracts these into `/tmp/` or `RATARMOUNT_INDEX_TMPDIR`
before using them.

Performance

- Disable Python-side buffering when opening files via FUSE.
- Forward underlying archive block sizes to statfs and stat implementations.
- (ratarmountcore 0.8.0) Import [compiled zip decrypter](https://github.com/mxmlnkn/fast-zip-decryption/) for 100x speedup for Standard ZIP 2.0 encrypted ZIP files
- (ratarmountcore 0.8.0) Speed up `readdir` and therefore simple use cases such as `find` to iterate all files and folders by 3x.
- (ratarmountcore 0.8.0) Avoid reading the whole appended TAR parts into memory for the check has-been-appended-to check.
- (ratarmountcore 0.8.0) Fix block size being ignored when reading everything via `io.BufferedReader`.
- (ratarmountcore 0.8.0) Do not use parallelization with possibly huge prefetches for simple file type checks.

Fixes

- `statfs` did not work when using a write overlay and calling it on a file not in the overlay folder.
- Union mounting of inputs with the same name, even if in different folders, ignored all but the first.
- Suppress teardown warning in case the mount source was not even created yet.
- Make mounting work with only a write overlay.
- Avoid hangs and errors caused by non-joined threads before forking into the background by checking for running threads.
- Set locale to C when calling GNU tar to get more reproducible output on `--commit-overlay`.
- (ratarmountcore 0.8.0) Argument to `--gzip-seek-point-spacing` was ignored when using the rapidgzip backend.
- (ratarmountcore 0.8.0) Index creation did not work with default arguments with an archive in a read-only location.
- (ratarmountcore 0.8.0) Close sqlite3 dummy connection after querying the SQLite version.
- (ratarmountcore 0.8.0) Avoid resource leaks in case a `MountSource` constructor throws.

- Setting either the owner or group for a file with `--write-overlay` would reset the group or user respectively.
- Setting owner or group to 0 (root) with `--write-overlay` was not working.
- (ratarmountcore 0.7.2) Fix error when combining `--recursive` or `--recursion-depth` with `--write-overlay`.

- Show install suggestions when FUSE is missing.
- File deletion with `--commit-overlay` did not work.
- (ratarmountcore 0.7.1) Fix the missing indentation for the index version check.
- (ratarmountcore 0.7.1) Make `--help` and `--version` work even if `libarchive.so` is not installed.
- (ratarmountcore 0.7.1) Fix `LibarchiveMountSource` compatibility issues with older libarchive versions.
- (ratarmountcore 0.7.1) Fix the exception in `StenciledFile` when seeking before the file start.

- Print indicators for versions of loaded shared libraries.
- (ratarmountcore 0.7.0) Add libarchive backend and detection support for:
grzip, lrzip, lz4, lzip, lzma, lzop, rpm, uuencode, compress, 7zip, ar, cab, deb, xar, cpio, iso, war, cxar.
- (ratarmountcore 0.7.0) Add `--transform` option to map each archive entry path via a regex to some user-specified one.
- (ratarmountcore 0.7.0) Upgrade rapidgzip from 0.10 to 0.13 to add zlib support. Other notable features are:
- (ratarmountcore 0.7.0) Remove `indexed_bzip2` dependency in favor of `rapidgzip`, which in the future should support even more formats.
- (ratarmountcore 0.7.0) Store backend name into the index and check that the index fits to the current backend / `MountSource`.
- (ratarmountcore 0.7.0) Store `isGnuIncremental` flag in the index.
- (ratarmountcore 0.7.0) Determine incremental archives from index rows to avoid seeks.
- (ratarmountcore 0.7.0) `utils.findModuleVersion`: Return version not name if `__version__` does not exist.
- (ratarmountcore 0.7.0) Apply specified priorities for opening all archives not just gzip.

- Do not check mount point because of faulty `os.path.ismount`, simply try fusermount.
- Avoid total I/O hang when lazy-mounting a folder with archives onto itself
- (ratarmountcore 0.6.4) Return a valid file info and file version count for `/`.
- (ratarmountcore 0.6.4) Make the original archive viewable as an older file version when using `AutoMountLayer`.
- (ratarmountcore 0.6.4) Resolve symbolic links pointing outside the source folder given to `FolderMountSource` to not break them.
- (ratarmountcore 0.6.4) Do not return a valid `FileInfo` for invalid paths such as `../..`.
- (ratarmountcore 0.6.4) Make `--index-minimum-file-count` work for the TAR backend.
- (ratarmountcore 0.6.5) The index should not be created for very small archives.
- (ratarmountcore 0.6.5) Root file info userdata was not initialized correctly.
- (ratarmountcore 0.6.5) Index validation did fail for TAR entries with more than 2 metadata blocks.
- (ratarmountcore 0.6.5) Do not check for folder consistency because parent folders get automatically added to the index.
- (ratarmountcore 0.6.5) Move `_createFileInfo` out of `MountSource` class to fix "protected-access" warning.
- (ratarmountcore 0.6.5) Joined files (`a.001`, `a.002`) did not work because of an accidentally shared list.
- (ratarmountcore 0.6.5) Do not check file header for zip, only for the footer, to detect self-extracting archives.

- Fix `AttributeError: module 'fuse' has no attribute 'errno'`.
- Fix `--commit-overlay`, which did not add newly created empty folders to TARs.
- Do not ask for confirmation if there is nothing to commit when using `--commit-overlay`.
- Improve unmounting with `ratarmount -u`, especially with the AppImage.
- (ratarmountcore 0.6.3) Properly close opened file objects in mount sources.
- (ratarmountcore 0.6.3) Fix `--disable-union-mount`, which returned an I/O error.
- (ratarmountcore 0.6.3) Fix that `--use-backend=indexed_gzip` still did use `rapidgzip`.
It only worked when both were specified.
- (ratarmountcore 0.6.3) Fix detection of self-extracting RAR files.
- (ratarmountcore 0.6.3) Improve the error message when a file cannot be read because of a missing dependency.
- (ratarmountcore 0.6.3) Improve debug message when the index does not yet contain a gzip index.
- (ratarmountcore 0.6.2) Fix faulty seek forward for files opened via `RarMountSource` when whence is not `io.SEEK_SET`.
- (ratarmountcore 0.6.1) Skip data offset collection for zip files because it takes too long and is unused.