Initialize the compressor with the path of the archive to create.

Add a directory (recursively) to the archive.

Add the content of dir_path at the archive root.

Each top-level entry inside dir_path is added under its own name, so the resulting archive does not contain dir_path itself as a wrapping folder.

Add a single file to the archive.

Add a filesystem node (file or directory) to the archive.

Dispatches to :meth:add_dir or :meth:add_file based on the node type.

Finalize the archive and write it to destination_file_path.

Must be called once all entries have been added.

Return true if the file can be uncompressed by this class

Compress a folder into a tar.gz file.

Compress the content of a folder without creating a subfolder hierarchy. Files and folders inside dir_path will be at the root of the compressed file.

Uncompress a tar.gz file.

Return the list of supported extensions for this compress class without '.'

Return the list of all supported extensions without '.'

Return a mapping of supported extension (without leading dot) to its Compress class. Built dynamically from child classes so new compressors are picked up automatically.

Check if the file is a compressed file.

Validate and normalize an archive entry name to a safe relative path.

Rejects empty names, absolute paths, and any segment that would escape the archive root via ... Returned value is suitable for joining with a staging directory.

Detect the extension of the compressed file and use the right decompress method.