【Python】ディレクトリを作成・削除する方法

ディレクトリの作成

コード内からディレクトリを作成するには以下の方法があります。

パスを指定して作成する[mkdir関数]

osモジュールのmkdir関数を使うことでディレクトリを作成できます。
引数には作成するディレクトリのパスを渡します。

すでに同じパスのディレクトリが存在している場合はエラーとなります。

import os

os.mkdir(パス)

サンプル

試しにデスクトップにディレクトリを作成してみましょう。

import os

# デスクトップのパス(使っているPCのデスクトップのパスを指定)
path = '/Users/ユーザー名/Desktop'

# ディレクトリ名
dir_name = 'dir'

# ディレクトリの作成
os.mkdir(os.path.join(path, dir_name))

これでデスクトップにdirディレクトリが作成されました。

パスを指定して再帰的に作成する[makedirs関数]

先ほどの方法ではデスクトップにディレクトリを作成して、その中にサブディレクトリを作成しようとすると２回同じようなコードを書く必要があります。

osモジュールのmakedirs関数を使うことで引数に渡したパス通りにディレクトリを作成できるので、1度にまとめてディレクトリを作成した場合に便利です。

import os

os.makedirs(パス)

os.makedirs(path, exist_ok=True)

サンプル

試しにデスクトップにディレクトリとサブディレクトリを作成してみます。

import os

# デスクトップのパス
path = '/Users/ユーザー名/Desktop'

# デスクトップに作成するディレクトリ名
dir_name1 = 'dir'

# dirディレクトリ内に作成するサブディレクトリ名
dir_name2 = 'sub_dir'

# ディレクトリの作成
os.makedirs(os.path.join(path, dir_name1, dir_name2))

このコードを実行するとデスクトップに下の画像のようなディレクトリが作成されます。

dirディレクトリ内にsub_dirディレクトリが作成されています。

ディレクトリの削除

コード内からディレクトリを削除するには以下の方法があります。

空のディレクトリの削除[rmdir関数]

空のディレクトリを削除するには、osモジュールのrmdir関数を使います。
引数には削除したいディレクトリのパスを渡します。

削除するディレクトリが存在しない場合と、削除するディレクトリが空でない場合にエラーになります。

import os

os.rmdir(パス)

import os

# デスクトップのパス
path = '/Users/ユーザー名/Desktop'

# ディレクトリ名
dir_name = 'Test'

# ディレクトリの削除
os.rmdir(os.path.join(path, dir_name))

再帰的に空のディレクトリを削除する[removedirs関数]

osモジュールのremovedirs関数を使うことで、空ディレクトリを末端ディレクトリから親ディレクトリに向かってまとめて削除できます。

import os

os.removedirs(パス)

import os

# デスクトップのパス
path = '/Users/ユーザー名/Desktop'

# ディレクトリ名
dir_name1 = 'dir'

# dirディレクトリのサブディレクトリ名
dir_name2 = 'sub_dir'

# 再帰的にディレクトリを削除
os.removedirs(os.path.join(path, dir_name1, dir_name2))

空ではないディレクトリの削除[rmtree関数]

shutilモジュールのrmtree関数を使うことで、ファイルなどが格納されているディレクトリも削除することができます。

import shutil

shutil.rmtree(パス)

import os
import shutil

# デスクトップに作成するディレクトリのパス
dir_path = '/Users/ユーザー名/Desktop/dir'

# ディレクトリの作成
os.mkdir(dir_path)

# dirディレクトリにtest.txtを作成
with open(os.path.join(dir_path, 'test.txt'), 'w') as f:
    pass

上記のコードを実行するとデスクトップにtest.txtを保持したdirディレクトリが作成されます。デスクトップを確認してみましょう。

それではdirディレクトリを削除してみます。

# dirディレクトリの削除
shutil.rmtree('/Users/ユーザー名/Desktop/dir')

これでデスクトップからdirディレクトリが削除されました。
デスクトップを確認してみてください。

ちなみに、rmtree関数の引数にディレクトリではなく、ファイルのパスを渡すとエラーになるので注意しましょう。

まとめ

今回はソースコード内からディレクトリを作成・削除する方法を解説しました。

コード内からディレクトリを操作することで、ログや設定ファイルを保存するディレクトリを外部に生成することができます。

今回の内容はここまでになります。それではまたどこかで〜！