HOWTO · Python
Python でファイル拡張子を取得する
Python でファイルの拡張子を取得する方法を実演します。
このページの内容
Python でファイル名の拡張子を取得するには、最後の拡張子だけが必要な場合は os.path.splitext() を、.tar.bz2 のように複数の拡張子部分が必要な場合は pathlib.Path.suffixes を使います。以下の例では、それぞれの結果の形式を示します。必要な形式を選ぶ際の参考にしてください。
Python でファイルから拡張子を取得するには os.path モジュールを使う
os.path には、オペレーティングシステムのパスを扱うためのユーティリティ関数があります。その splitext() 関数は、ルートパスと最後の拡張子からなる2要素のタプルを返します。変数名が異なっていても、タプルの要素はこの順序で代入してください。
パスの末尾が .docx の場合を例に見てみましょう。
このセクションのコードと表示されるラベルや出力は英語のままです。
import os
path = "/Users/user/Documents/sampledoc.docx"
root, extension = os.path.splitext(path)
print("Root:", root)
print("Extension:", extension)
Root: /Users/user/Documents/sampledoc
Extension: .docx
出力では、ルートパスが先に、拡張子が後に表示されます。splitext() が扱うのは最後の拡張子だけです。たとえば backup.tar.gz の場合は .gz を分離し、backup.tar はルートに残します。
splitext() が返す拡張子には先頭のドットが含まれるため、extension == ".csv" のように比較できます。ファイル名に拡張子がない場合、拡張子部分は空文字列になり、ルートにはファイル名全体が残ります。先頭のドットだけでは拡張子と見なされないため、この規則では .profile に拡張子はありません。
Python でファイルから拡張子を取得するには pathlib モジュールを使う
pathlib では、パスをオブジェクトとして扱います。パス文字列から Path を作成し、その属性を確認します。parent は親パス、name はパスの最後の要素、suffix は先頭のドットを含む最後の拡張子です。
sampledoc.docx のように拡張子が1つのファイルでは、path.suffix は .docx になります。これらの属性は値なので、括弧を付けずに読み取ります。次の単独の例では、suffix と suffixes の違いも確認できます。
このセクションのコードと表示されるラベルや出力は英語のままです。
import pathlib
single = pathlib.Path("/Users/user/Documents/sampledoc.docx")
archive = pathlib.Path("/Users/user/Documents/app_sample.tar.bz2")
print("Parent:", single.parent)
print("Filename:", single.name)
print("Final suffix:", single.suffix)
print("Suffix parts:", single.suffixes)
print("Archive suffix:", "".join(archive.suffixes))
Parent: /Users/user/Documents
Filename: sampledoc.docx
Final suffix: .docx
Suffix parts: ['.docx']
Archive suffix: .tar.bz2
出力には、親パス、最後のファイル名、最後の拡張子、拡張子のリスト、連結したアーカイブ用拡張子が表示されます。suffixes はリストです。sampledoc.docx では要素が1つで .docx が入り、app_sample.tar.bz2 では .tar と .bz2 が入ります。これらを空文字列で連結すると .tar.bz2 になります。アプリケーションが複合拡張子を1つの値として扱う場合に便利ですが、多くのファイル名の拡張子は1つだけです。
パスに拡張子がない場合、Path.suffix は空文字列、Path.suffixes は空のリストになります。.profile のように先頭にドットがあるだけでは、拡張子として返されません。後続のコードで各部分を調べるならリストのまま使い、複合値を1つとして扱う必要がある場合にだけ連結してください。これらの属性が示すのはパスの最後の要素であり、そのパスが現在存在するファイルを指しているかどうかは関係ありません。
最後の拡張子だけが必要な場合や、同時にルートも取得したい場合は os.path.splitext() を選びます。オブジェクトとして扱うパスの拡張子が1つなら Path.suffix を使い、拡張子の各部分を個別に扱う、または複合値として連結する場合は Path.suffixes を使います。どちらも名前を調べる方法であり、ファイルの存在は確認しません。