Pythonでファイルリストをサブディレクトリも含めて取得する方法を現役エンジニアが解説【初心者向け】

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

Pythonでファイルリストをサブディレクトリも含めて取得する方法について、TechAcademyのメンター(現役エンジニア)が実際のコードを使用して、初心者向けに解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

 

なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

Pythonでファイルリストをサブディレクトリも含めて取得する方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

目次

  1. globモジュールを利用してファイルリストを取得する方法
  2. os.walk関数を利用してファイルリストを取得する方法
  3. 実際に書いてみよう
  4. まとめ

 

globモジュールを利用してファイルリストを取得する方法

globモジュールとは、指定したパターンにマッチするファイルのパスを取得するモジュールです。このモジュールを使えば、個々のファイルに対して様々な操作ができるようになります。

例えば以下のようなフォルダ構成でtry.ipynbファイルからglobモジュールを利用してみることにします。(実行環境はjupyter notebookです。)

Pythonのglobモジュールを使ってファイルリストを取得するサンプルとしてjupyter notebook環境を使った例。

それではglobモジュールを実際に使用してみましょう。glob()の引数には*(ワイルドカード)を使用しています。なお、globモジュールを使用するにはimportが必要です。

実行結果

<try.ipynb>

import glob
glob.glob("bbb/*.ipynb")

 

出力結果

['bbb/orange.ipynb', 'bbb/banana.ipynb', 'bbb/apple.ipynb']

出力結果をご覧になればわかるように、peach.pyのファイルパスが出力されていません。

ちゃんとbbbフォルダ中の拡張子が.ipynbのファイルパスだけを取得することができました。

[PR] Pythonで挫折しない学習方法を動画で公開中

os.walk関数を利用してファイルリストを取得する方法

非常に便利なglobモジュールなのですが、1つだけ問題があります。それは、サブフォルダの中までは探索できない点です。

この問題を解決してくれるのがos.walk関数です。osモジュールにあるこの関数は、サブフォルダの中まで渡り歩くことができるのです。os.walk関数は引数に「探索するフォルダのパス」を渡すことで以下の3つの情報を返してくれます。

  • 現在いるフォルダのパス
  • 現在いるフォルダの中のサブフォルダ名のリスト
  • 現在いるフォルダの中のファイル名のリスト
1時間でできる無料体験!

 

実際に書いてみよう

説明だけではまだイメージがあまり湧かないと思いますので、実際にコードを書いてみましょう。osモジュールを使用するにもimportが必要です。なお、今回は以下のフォルダ構成でtry2.ipynbを実行します。

Pythonのos.walk関数を使ってサブディレクトリを含めたファイルリストを取得するためのフォルダ構成の画像。

実行結果

<try2.ipynb>

import os
 for current, subfolders, subfiles in os.walk("bbb"):
    print(f"現在のフォルダは{current}です。")
    print(f"サブフォルダは{subfolders}です。")
    print(f"サブファイルは{subfiles}です。")
    print("-------------------------------------------------------")

 

出力結果

現在のフォルダはbbbです。
サブフォルダは['ddd', 'ccc']です。
サブファイルは['white.ipynb']です。
-------------------------------------------------------
現在のフォルダはbbb/dddです。
サブフォルダは[]です。
サブファイルは['coffee.ipynb', 'water.ipynb']です。
-------------------------------------------------------
現在のフォルダはbbb/cccです。
サブフォルダは[]です。
サブファイルは['cat.ipynb', 'dog.ipynb']です。
-------------------------------------------------------

このような動作をする関数を自分で1から作り上げるとなると大変ですが、os.walk関数を使えば簡単にサブフォルダまで巡回できるのです。

コラム

実は私も!?独学で損する人の特徴

「スクールは高いから独学で成功する」という気持ちの方は多いと思います。
もちろんその方が金額は低く抑えられるでしょう。
ただ 独学には向き不向きがあり、実はスクールが向いている人も大勢います。

そんな方のために参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

  • ・困って挫折しそうなときに、質問や相談できる相手がいる環境で学んでいきたいなと思った
  • ・わかった気になっているだけだったので、自分を追い込む環境に置いた方がいいと感じた
  • ・スクールのカリキュラムで市場に求められるスキルを学ぶべきと思った

少しでも当てはまる部分があれば、 スクールが向いているかもしれません。
お試しのつもりで、まずは一度 無料体験 に参加してみませんか?

初心者でも最短1時間で学習が体験できるカリキュラム、現役エンジニアに何でも相談できるカウンセリング、無制限のチャット質問サービスすべて無料で体験 できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら体験者限定の割引特典付き! 無料体験はこちら

まとめ

この記事では、ファイルリストをサブディレクトリも含めて取得する方法についてご紹介しました。

os.walk関数を使いこなせるようになると、深い階層でもディレクトリ内のファイル操作が簡単にできて便利です。動作の理解が最初は少し難しいかもしれませんが、是非とも使いこなせるようになりましょう。

監修してくれたメンター

柴山真沙希(しばやままさき)

大手IT企業などでエンジニアとして2年ほど勤務した後、個人事業主としてプログラミングスクール「エンペサール」を経営。子供から大人まで幅広い層を対象にプログラミングを教えている。

得意言語はPython, HTML, CSSで、機械学習やデータ分析、スクレイピングなどが得意。サッカー観戦や読書が趣味である。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

TechAcademyでは、初心者でも、Pythonを使った人工知能(AI)や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。

また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。

独学に限界を感じたら…テックアカデミーに相談しよう

プログラミングを独学していて、このように感じた経験はないでしょうか?

  • ・調べてもほしい情報が見つからない
  • ・独学のスキルが実際の業務で通用するのか不安
  • ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 独学に不安を抱えている方へ、現役エンジニア講師とマンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう 厳しい試験を通過した講師 があなたの相談に真摯に向き合います。

「ただ気になることを相談したい」
「漠然としているがプロの話を聞いてみたい」

こんな気持ちでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。(1週間限定)

今なら参加者限定の割引特典付き! 無料で予約する