@spec compress(binary(), single_algo()) :: {:ok, binary()} | {:error, binary()}

Compresses a single file with the specified algorithm. Replaces the original with the compressed version. Delegates to Trebejo.Compress.Algorithm.compress/2.

@spec create_7z(binary(), [binary()], keyword()) ::
  {:ok, binary()} | {:error, binary()}

Creates a 7z archive from source paths.

@spec create_rar(binary(), [binary()], keyword()) ::
  {:ok, binary()} | {:error, binary()}

Creates a RAR archive from source paths.

@spec decompress(binary(), single_algo()) :: {:ok, binary()} | {:error, binary()}

Decompresses a single file. Algorithm auto-detected from extension. Delegates to Trebejo.Compress.Algorithm.decompress/2.

@spec detect_type(binary()) :: archive_type()

Detects the archive or compression type from a file extension. Delegates to Trebejo.Compress.Format.detect_type/1.

@spec extract(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Extracts an archive, auto-detecting the format from its extension.

Options

• :output — destination directory (default: current directory)
• :password — optional password for zip/7z/rar

@spec extract_7z(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Extracts a 7z archive.

@spec extract_rar(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Extracts a RAR archive.

@spec gunzip(binary()) :: {:ok, binary()} | {:error, binary()}

Decompresses a gzip file, keeping the original.

@spec gzip(binary()) :: {:ok, binary()} | {:error, binary()}

Compresses a file with gzip (replaces original with .gz).

@spec list(binary()) :: {:ok, [binary()]} | {:error, binary()}

Lists the contents of an archive. Auto-detects format.

@spec tar(binary(), binary(), keyword()) :: {:ok, binary()} | {:error, binary()}

Creates a tar archive. Supports compression: :gzip, :bzip2, :xz, :zstd, :none. Delegates to Trebejo.Compress.Tar.tar/3.

@spec untar(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Extracts a tar archive. Compression auto-detected from extension.

@spec unzip(
  binary(),
  keyword()
) :: {:ok, binary()} | {:error, binary()}

Extracts a zip archive. Delegates to Trebejo.Compress.Zip.unzip/2.

@spec zip(binary(), [binary()], keyword()) :: {:ok, binary()} | {:error, binary()}

Creates a zip archive from source paths. Supports password. Delegates to Trebejo.Compress.Zip.zip/3.