【Python】フォルダを作成する方法

はじめに
基本的なフォルダ作成方法
フォルダの存在確認
実用例
pathlibモジュールの利用
例外処理の追加
最後に

はじめに

Pythonはその柔軟性と簡潔さから、多くの開発者に愛用されています。ファイルやフォルダ（ディレクトリ）の操作もその一環として非常に簡単に行うことができます。この記事では、Pythonでフォルダを作成する方法について、基本的な使い方から実用的な例までを詳しく解説します。

基本的なフォルダ作成方法

標準ライブラリのosモジュールを使用します。このモジュールを利用するとシステムのファイルやフォルダに対する操作が行えます。

os.mkdir()

os.mkdir()関数を使用すると、新しいフォルダを作成することができます。基本的な使い方は次の通りです。

import os

# 新しいフォルダを作成
os.mkdir('new_folder')
print("フォルダを作成しました。")

このコードを実行すると作業ディレクトリにnew_folderが作成されます。

os.makedirs()

os.makedirs()関数は、指定されたパスに存在しない親ディレクトリも含めて一気に作成する場合に使用します。

import os

# 複数のディレクトリを含む新しいパスを作成
os.makedirs('parent_folder/child_folder')
print("フォルダを作成しました。")

このコードを実行すると、parent_folderが存在しない場合でも、child_folderとともに一緒に作成されます。

フォルダの存在確認

フォルダを作成する前に、既に同じ名前のフォルダが存在しないか確認することが重要です。存在しない場合のみフォルダを作成するようにすると、エラーを防ぐことができます。

import os

folder_path = 'example_folder'

# フォルダが存在しない場合にのみ作成
if not os.path.exists(folder_path):
    os.mkdir(folder_path)
    print(f"{folder_path} を作成しました。")
else:
    print(f"{folder_path} は既に存在します。")

このコードでは、example_folderが既に存在するかどうかを確認し、存在しない場合にのみexample_folderを作成します。

実用例

ここでは、いくつかの実用例を紹介します。

例①：プロジェクトのディレクトリ構造を作成

新しいプロジェクトを始める際に、ディレクトリ構造を自動で作成するスクリプトを作成できます。

import os

# プロジェクトのディレクトリ構造
project_name = 'my_project'
folders = [
    f'{project_name}/data',
    f'{project_name}/src',
    f'{project_name}/docs',
    f'{project_name}/tests'
]

# 各フォルダを作成
for folder in folders:
    if not os.path.exists(folder):
        os.makedirs(folder)
        print(f"{folder} を作成しました。")
    else:
        print(f"{folder} は既に存在します。")

このスクリプトは、指定されたプロジェクトのディレクトリ構造を自動で作成します。

例②：日付ごとのフォルダを作成

毎日データを保存するために、日付ごとのフォルダを作成するスクリプトも便利です。

import os
from datetime import datetime

# 今日の日付を取得
today = datetime.today().strftime('%Y-%m-%d')

# 日付ごとのフォルダを作成
folder_path = f'data/{today}'
if not os.path.exists(folder_path):
    os.makedirs(folder_path)
    print(f"{folder_path} を作成しました。")
else:
    print(f"{folder_path} は既に存在します。")

このスクリプトは、日付ごとのデータ保存に役立ちます。

pathlibモジュールの利用

より直感的にファイルやフォルダを操作する方法としてpathlibモジュールがあります。

from pathlib import Path

# フォルダを作成
folder_path = Path('example_pathlib_folder')

# フォルダが存在しない場合に作成
if not folder_path.exists():
    folder_path.mkdir()
    print(f"{folder_path} を作成しました。")
else:
    print(f"{folder_path} は既に存在します。")

pathlibモジュールを使用すると、オブジェクト指向のアプローチでパス操作が行えるため、コードが読みやすくなります。

例外処理の追加

何らかのエラーが発生した場合に備えて、例外処理を追加することが推奨されます。

import os

folder_path = 'safe_folder_creation'

try:
    if not os.path.exists(folder_path):
        os.mkdir(folder_path)
        print(f"{folder_path} を作成しました。")
    else:
        print(f"{folder_path} は既に存在します。")
except OSError as e:
    print(f"フォルダの作成中にエラーが発生しました: {e}")

この例では、OSErrorをキャッチして、エラーが発生した場合に適切なメッセージを表示します。エラーハンドリングを行うことで、予期せぬ問題に対処することができます。

最後に

Pythonでフォルダを作成する方法について、基本的な使い方から実用的な例までを紹介しました。この記事が少しでも参考になれば幸いです。この記事を読んでいただき、ありがとうございました！他にも、Pythonに関する様々な記事を投稿していますので、ぜひご覧になってください。質問やフィードバックがあれば、コメント欄に残してください。皆さんの声をもとに、より良いコンテンツを提供していきたいと思います。これからもよろしくお願いします！

私の経歴などについては以下の記事から確認することができます！