深いフォルダ階層にある100個のファイルを1つのフォルダにまとめよう

• 

  深いフォルダ階層にある複数ファイルを1つにまとめるプログラムを実行したところ

プログラムを実行する前に考えよう

深いフォルダ階層にある大量のファイルを1つのフォルダに移動することを考えた時、いくつか考えるべきことがある。プログラムを実行する前に考慮すべき、以下の点をよく考えよう。まずは箇条書きにしてみた。

• プログラム実行前にバックアップする
• フォルダ名を移動後のファイル名に加えて同名ファイルの衝突を避ける
• フォルダの中にあるフォルダ（サブフォルダ）のファイルも処理する

一つずつ考慮していこう。そもそも、大量のファイルを何も考えずに移動させると失敗することが多い。そのため、ファイルの移動が目的であったとしても、まずは、プログラムの実行前に入念にバックアップをとっておこう。Pythonのプログラムでは移動処理も可能だが、ここでは移動させるのではなくファイルコピーをすることにしよう。

それから複数フォルダに分かれたファイルを1つのフォルダにまとめようと思うと必ず起きるのがファイル名の衝突だ。例えば「2022-12/給料明細.xlsx」と「2022-11/給料明細.xlsx」というファイルがあったとしよう。（なお「/」はLinuxやmacOSでフォルダの区切り記号である。）これを1つのフォルダにまとめるなら、どちらもファイル名が「給料明細.xlsx」なので何も考えずにコピーするなら既にコピーしたファイルを後からコピーするファイルで上書きしてしまう。そのため、移動後のファイル名をどうするかを先に考えておく必要がある。この場合、「2022-12_給料明細.xlsx」「2022-11_給料明細.xlsx」のようにフォルダ名を移動先のファイル名に加えることができるだろう。

また、ファイルの一覧を取得する場合、指定のフォルダだけでなく、そのサブフォルダ以下にあるファイルも取得する必要がある。

サブフォルダ以下の複数ファイルを1つのフォルダにコピーするプログラム

上記の点を踏まえてプログラムを作ってみよう。

import tkinter.messagebox as msg
import tkinter.filedialog as dlg
import os, shutil, re
def main():
    # フォルダの選択 --- (*1)
    msg.showinfo(message='コピー元フォルダを選択してください')
    source_dir = dlg.askdirectory()
    if source_dir == '': return
    msg.showinfo(message='コピー先フォルダを選択してください')
    target_dir = dlg.askdirectory()
    if target_dir == '': return
    print('source=',type(source_dir))
    print('taget=', target_dir)
    # ファイルの一覧を列挙 --- (*2)
    for cur_dir, dirs, files in os.walk(source_dir):
        print(f'[{cur_dir}]')
        for f in files:
            # 保存ファイル名を決定 --- (*3)
            fdir = cur_dir[len(source_dir)+1:] + '_' + f
            savename = re.sub(r'[\\\/]', '_', fdir, 0)
            print('-', savename)
            try:
                # ファイルのコピー --- (*4)
                cp_from = os.path.join(cur_dir, f)
                cp_to = os.path.join(target_dir, savename)
                shutil.copy2(cp_from, cp_to)
            except:
                print('[ERROR]', cp_from)
if __name__ == '__main__':
    main()

上記のプログラムを「copy_files.py」という名前で保存しよう。そして、次のコマンドを実行しよう。あるいは、IDLEを起動してプログラムを実行しよう。

# Windowsの場合
$ python copy_files.py
# macOSの場合
$ python3 copy_files.py

プログラムを実行すると、フォルダの選択ダイアログが出るので、コピー元とコピー先と二つのフォルダを選択しよう。WindowsでもmacOSでも同じように実行できる。

• 

  Windowsで実行したところ

• 

  macOSで実行したところ

プログラムを確認しよう。(＊1)ではTkinterの機能を使ってフォルダ選択ダイアログを表示する。もしキャンセルボタンが押されたらダイアログを閉じる。(＊2)ではファイルの一覧を列挙する。os.walkメソッドを使うとサブフォルダ以下のファイルも列挙できる。

(＊3)ではファイル名の衝突を避けるために、保存ファイル名にフォルダ名を入れたものにする。(＊4)で実際にファイルのコピーを行う。

まとめ

以上、今回は深い階層にある複数ファイルを1つのフォルダにまとめるプログラムを作ってみた。単にファイルを列挙してコピーするだけだと問題が生じることも考慮して、ファイル名を工夫するようにした。昨今、ネットから適当にコピー＆ペーストしてプログラムを実行する人が増えているが、何も考えずに実行すると失敗することもあるだろう。しかし、必要な要素を最初にちょっと考えておいて、必要な点と参考にするプログラムを比べるだけでも失敗は減るだろう。

また、本プログラムでは既にファイルが存在する時もファイルを確認せず上書きしてしまうので、必要に応じて改良して使うと良いだろう。

自由型プログラマー。くじらはんどにて、プログラミングの楽しさを伝える活動をしている。代表作に、日本語プログラミング言語「なでしこ」 、テキスト音楽「サクラ」など。2001年オンラインソフト大賞入賞、2004年度未踏ユース スーパークリエータ認定、2010年 OSS貢献者章受賞。技術書も多く執筆している。直近では、「シゴトがはかどる Python自動処理の教科書(マイナビ出版)」「すぐに使える!業務で実践できる! PythonによるAI・機械学習・深層学習アプリのつくり方 TensorFlow2対応(ソシム)」「マンガでざっくり学ぶPython(マイナビ出版)」など。