Pythonでファイルやフォルダをtar.gzアーカイブに圧縮・追加する方法

Pythonの標準ライブラリである tarfile モジュールを使うと、ディレクトリ全体を簡単にtar形式のアーカイブ（gzip圧縮）としてまとめることができます。ディレクトリツリーの走査には os.walk を利用し、配下のファイルをすべて再帰的にアーカイブへ追加していきます。

基本的な実装例

import os
import tarfile

def tardir(path, tar_name):
    with tarfile.open(tar_name, "w:gz") as tar_handle:
        for root, dirs, files in os.walk(path):
            for file in files:
                tar_handle.add(os.path.join(root, file))

tardir('./my_folder', 'sample.tar.gz')

このコードを実行すると、my_folder 内のすべてのファイルが sample.tar.gz という名前でgzip圧縮され、カレントディレクトリに保存されます。

コードのポイント解説

1. with文による自動クローズ

with tarfile.open(...) の形式を使えば、処理終了後にアーカイブは自動的に閉じられるため、明示的な close() 呼び出しは不要です。リソースの解放漏れを防げるので、この書き方を推奨します。

2. モード指定「w:gz」について

"w:gz" は「新規作成＋gzip圧縮」を意味します。圧縮せずにtarのみを作成したい場合は "w" を、bzip2圧縮を使いたい場合は "w:bz2" を指定してください。

3. アーカイブ内のパスを整理したい場合

上記のコードでは、元のディレクトリパスがそのままアーカイブ内に記録されます。フルパスを含めたくない場合は、arcname 引数でアーカイブ内のパスを制御できます。

tar_handle.add(os.path.join(root, file), arcname=file)

こうすることで、アーカイブ内ではファイル名だけが記録され、展開時によりクリーンな構造になります。