Pythonでファイル名を取得する方法を現役エンジニアが解説【初心者向け】

Pythonでファイル名を取得する方法について解説します。

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

 

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

 

 

os.pathモジュールとは

Pythonでファイルパス形式の文字列からファイル名を取得するにはos.pathモジュールを使用します。

os.pathモジュールとは、ファイルパス形式の文字列から「ファイル名の取得」「フォルダ名(ディレクトリ名)の取得」「拡張子の取得」といった、ファイルパスに関する操作ができるモジュールです。

os.pathモジュールの基本的な使い方

import os.pathでモジュールをインポートして、各種関数にファイルパス形式の文字列を引数として渡すことで、様々な情報を取得することができます。

以下はdirname関数を使って、foo/bar/baz.txtというファイルパスから「フォルダ名のみ」を取得して表示するソースコードになります。

import os.path
print(os.path.dirname("foo/bar/baz.txt"))

これを実行すると、以下のようファイル名(baz.txt)を取り除いたfoo/barという結果が表示されます。

$ python os_path.py
foo/bar

os.pathで使用頻度が高いものをいくつか列挙しておきます。

• os.path.basename: ファイル名を取得(baz.txt)
• os.path.abspath: 絶対パスの表示(/Users/hoge/foo/bar/baz.txt)
• os.path.split: フォルダ名とファイル名をタプル(tuple)にして取得([‘foo/bar’, ‘baz.txt’])
• os.path.splitext: 拡張子とそれ以外をタプル(tuple)にして取得([‘foo/bar/baz’, ‘.txt’])
• os.path.join: 複数文字列からファイルパス形式の文字列を作成(os.path(“aa”, “bb”) # “aa/bb”)
• os.path.exists: ファイルやフォルダの存在を確認(True or False)
• os.path.isdir: ファイルかどうかをチェック(True or False)
• os.path.isfile: フォルダかどうかをチェック(True or False)

 

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

実際にファイル名を取得してみよう

中身は空で良いのでblog/posts/2019/my_post.txtというファイルを作って、os.pathモジュールでファイル名などの情報を取得してみましょう。

import os.path
file_path = "blog/posts/2019/my_post.txt"
print(f"basename: {os.path.basename(file_path)}")
print(f"abspath: {os.path.abspath(file_path)}")
print(f"split: {os.path.split(file_path)}")
print(f"splitext: {os.path.splitext(file_path)}")
print(f"exists: {os.path.exists(file_path)}")
print(f"isdir: {os.path.isdir(file_path)}")
print(f"isfile: {os.path.isfile(file_path)}")

上記の内容をos_path.pyというファイル名で保存して実行した結果が以下になります。

$ python os_path.py
basename: my_post.txt
abspath: /Users/hoge/blog/python/blog/posts/2019/my_post.txt
split: ('blog/posts/2019', 'my_post.txt')
splitext: ('blog/posts/2019/my_post', '.txt')
exists: True
isdir: False
isfile: True

上から順に、

• ファイル名
• 絶対パス
• フォルダ名とファイル名
• 拡張子とそれ以外
• ファイル、もしくはフォルダが存在するか
• フォルダかどうか
• ファイルかどうか

になっています。

os.pathモジュールでファイル名などの情報が取得できていますね。

監修してくれたメンター

メンター稲員さん フリーランスエンジニア。大手SEからフリーランスのWeb系エンジニアにジョブチェンジ。 経験言語：Ruby、Rails、Python、C/C++、Java、Perl、HTML/CSS3、JavaScript、CoffeeScript,Node.js。 おうち大好きマンです。

 

 

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

挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。