arc-file-extractor 0.1.0

Basic Commands

Extract a file:

arc x archive.zip
arc x document.tar.gz
arc x backup.7z

This will extract the file to a directory with the same name (without extension).

Compress a file or directory:

arc c myfile.txt
arc c mydirectory/
arc c source/ -o backup.tar.gz

If no output file is specified, it defaults to creating a .zip file.

List supported formats:

arc list

Check system dependencies:

arc check

Advanced Usage

Verbose output:

arc x archive.zip -v
arc c mydir/ -v

Custom output file:

arc c myproject/ -o backup.tar.gz
arc c documents/ -o docs_backup.7z

Supported Formats

Extraction: - ZIP (.zip) - TAR (.tar, .tar.gz, .tgz, .tar.bz2, .tbz, .tar.xz, .txz) - GZIP (.gz) - BZIP2 (.bz2) - XZ (.xz) - 7-Zip (.7z) - RAR (.rar)

Compression: - ZIP (.zip) - TAR (.tar, .tar.gz, .tgz, .tar.bz2, .tbz, .tar.xz, .txz) - 7-Zip (.7z) - RAR (.rar)

Dependencies

Arc File Extractor uses system tools for compression and extraction. Install the required tools:

Ubuntu/Debian:

sudo apt install unzip tar gzip bzip2 xz-utils p7zip-full unrar zip

Fedora/RHEL:

sudo dnf install unzip tar gzip bzip2 xz p7zip unrar zip

Arch Linux:

sudo pacman -S unzip tar gzip bzip2 xz p7zip unrar zip

macOS:

brew install p7zip unrar zip

Core Classes

ArcFileExtractor

Main class for file extraction and compression operations.

from arc_file_extractor import ArcFileExtractor

extractor = ArcFileExtractor()

# Extract a file
result = extractor.extract("archive.zip")

# Compress a file/directory
result = extractor.compress("source_dir", "output.tar.gz")

Methods:

• extract(file_path: str) -> int: Extract a file to a directory with the same name

• compress(source_path: str, output_file: str = None) -> int: Compress a file or directory

Utility Functions

check_dependencies() -> List[str]

Check if required external tools are installed. Returns a list of missing dependencies.

get_supported_formats() -> dict

Get supported file formats for extraction and compression.

validate_file_path(file_path: str) -> bool

Validate if a file path exists and is readable.

get_file_size(file_path: str) -> str

Get human-readable file size.