Bird
Raised Fist0
PythonHow-ToBeginner · 3 min read

How to Extract Tar File in Python: Simple Guide

Use Python's tarfile module to open and extract tar files. Call tarfile.open() with the file path, then use extractall() to unpack all contents.
📐

Syntax

To extract a tar file in Python, use the tarfile module. The main steps are:

  • tarfile.open(filename, mode): Opens the tar file. Use mode 'r' for reading.
  • extractall(path): Extracts all files to the specified directory. If path is omitted, extracts to the current directory.
  • close(): Closes the tar file after extraction.
python
import tarfile

tar = tarfile.open('archive.tar', 'r')
tar.extractall(path='destination_folder')
tar.close()
💻

Example

This example shows how to extract all files from sample.tar into a folder named extracted_files. It creates the folder if it doesn't exist.

python
import tarfile
import os

file_path = 'sample.tar'
destination = 'extracted_files'

if not os.path.exists(destination):
    os.makedirs(destination)

with tarfile.open(file_path, 'r') as tar:
    tar.extractall(path=destination)

print(f'Files extracted to {destination}')
Output
Files extracted to extracted_files
⚠️

Common Pitfalls

Common mistakes when extracting tar files include:

  • Not closing the tar file, which can lock the file or cause resource leaks.
  • Extracting files without specifying a safe destination, which may overwrite important files.
  • Trying to extract compressed tar files (like .tar.gz) without the correct mode (use 'r:gz' for gzip compressed files).

Always use with statement to handle files safely.

python
import tarfile

# Wrong: Not using 'with' and not closing
# tar = tarfile.open('archive.tar', 'r')
# tar.extractall()

# Right: Using 'with' to auto-close
with tarfile.open('archive.tar', 'r') as tar:
    tar.extractall()
📊

Quick Reference

FunctionDescription
tarfile.open(filename, mode)Open a tar file with mode 'r', 'r:gz', or 'r:bz2'
extractall(path=None)Extract all files to the given path or current directory
getnames()List all file names inside the tar archive
close()Close the tar file (if not using 'with')
✅

Key Takeaways

Use the tarfile module's open() and extractall() to extract tar files easily.
Always use a 'with' block to open tar files for safe automatic closing.
Specify the correct mode for compressed tar files like 'r:gz' for .tar.gz files.
Extract files to a dedicated folder to avoid overwriting important files.
Check the contents with getnames() before extracting if unsure.