メインコンテンツまでスキップ

Pythonでディレクトリ内のファイルを反復処理する方法

Pythonを使用してディレクトリ内のファイルを反復処理する方法について、詳しいステップバイステップのチュートリアルをご紹介します。

ステップ1: 必要なモジュールをインポートする​

まず、操作システムと対話する方法を提供する「os」モジュールをインポートする必要があります。このモジュールは、指定したディレクトリ内のファイルとディレクトリにアクセスすることができます。

import os

ステップ2: ディレクトリのパスを指定する​

次に、反復処理するディレクトリのパスを指定する必要があります。絶対パス（例: /path/to/directory）または相対パス（例: ./directory）を指定できます。ディレクトリが存在し、必要な権限があることを確認してください。

directory = '/path/to/directory'

ステップ3: ディレクトリ内のファイルを反復処理する​

これで、os.listdir()関数を使用して指定したディレクトリ内のファイルとディレクトリのリストを取得することができます。次に、このリストを反復処理して各ファイルを個別に処理することができます。

for filename in os.listdir(directory):
    # ファイルを処理する
    print(filename)

ステップ4: アイテムがファイルかどうかを確認する​

ループ内で、ディレクトリではなくファイルに対して特定のアクションを実行したい場合、os.path.isfile()関数を使用してループ内の現在のアイテムがファイルかどうかを確認することができます。

for filename in os.listdir(directory):
    if os.path.isfile(os.path.join(directory, filename)):
        # ファイルを処理する
        print(filename)

ステップ5: フルファイルパスを取得する​

ループ内でファイルにアクセスする必要がある場合は、フルファイルパスが必要です。os.path.join()関数を使用してディレクトリパスとループ内の現在のファイル名を結合することができます。

for filename in os.listdir(directory):
    if os.path.isfile(os.path.join(directory, filename)):
        full_path = os.path.join(directory, filename)
        # フルファイルパスを使用してファイルを処理する
        print(full_path)

ステップ6: 拡張子によるファイルのフィルタリング​

特定のファイル拡張子のファイルのみを処理したい場合があります。str.endswith()メソッドを使用して拡張子に基づいてファイルをフィルタリングすることができます。

extension = '.txt'  # 処理したいファイルの拡張子を指定する

for filename in os.listdir(directory):
    if filename.endswith(extension) and os.path.isfile(os.path.join(directory, filename)):
        full_path = os.path.join(directory, filename)
        # 指定した拡張子のファイルを処理する
        print(full_path)

ステップ7: サブディレクトリを再帰的に処理する​

ディレクトリにサブディレクトリが含まれており、それらのサブディレクトリ内のすべてのファイルを反復処理したい場合、再帰呼び出しを使用することができます。サブディレクトリが見つかるたびに、自身を呼び出す別の関数を作成することができます。

def iterate_files(directory):
    for filename in os.listdir(directory):
        if os.path.isfile(os.path.join(directory, filename)):
            full_path = os.path.join(directory, filename)
            # ファイルを処理する
            print(full_path)
        else:
            subdirectory = os.path.join(directory, filename)
            iterate_files(subdirectory)  # サブディレクトリのために関数を再帰的に呼び出す

# 初期ディレクトリで関数を呼び出す
iterate_files(directory)

以上です！これでPythonを使用してディレクトリ内のファイルを反復処理する方法についての詳細なチュートリアルが完成しました。特定のニーズに基づいてこれらのコード例をカスタマイズして使用してください。