はじめに
OutlookのPSTファイル（Personal Storage Table）をPythonで読み込んで検索・分析したいことがありますが、Windows環境でのセットアップは少し複雑です。この記事では、Windows 11環境でPSTファイルを扱うためのライブラリのインストールから実際のプログラム作成まで、詳細な手順を解説します。
必要な環境
- Windows 11
- Python 3.8以上（今回はAnacondaで）
- Visual Studio Community 2022（コンパイル用）
PSTファイル読み込みライブラリの選択肢
PythonでPSTファイルを読み込むライブラリはいくつかありますが、最も安定して動作するのは以下です：
- libpff-python（推奨）- 事前コンパイル済み
- pypff-python - 自分でコンパイルが必要
- extract-msg - MSGファイル向け（代替案）
インストール手順
1. Visual Studio Community 2022のインストール
PSTライブラリのコンパイルには、Microsoft Visual C++コンパイラが必要です。
- Visual Studio Community 2022をダウンロード
- インストール時に「C++によるデスクトップ開発」を選択
- 必要なビルドツールが自動的にインストールされます
2. 管理者権限でコマンドプロンプトを開く
Windows + R → cmd → Ctrl + Shift + Enter
3. Anaconda環境をアクティベート
conda activate base
4. 必要なパッケージのインストール
# ビルドツールを最新化
pip install setuptools wheel
# libpff-pythonをコンパイル＆インストール
pip install --no-binary :all: libpff-python
5. インストール成功の確認
以下のような出力が表示されれば成功です：
Building wheels for collected packages: libpff-python
Building wheel for libpff-python (pyproject.toml) ... done
Created wheel for libpff-python: filename=libpff_python-20231205-cp312-cp312-win_amd64.whl
Successfully installed libpff-python-20231205
インストール確認テストプログラム
インストールが正しく完了したかを確認するテストプログラムを作成します。
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
pypff インストール確認テスト
"""
import os
import sys
def test_pypff_installation():
"""pypffのインストール状況を確認"""
print("=" * 60)
print("pypff インストール確認テスト")
print("=" * 60)
# 1. インポートテスト
try:
import pypff
print("✅ pypff インポート成功")
print(f" モジュール場所: {pypff.__file__}")
except ImportError as e:
print(f"❌ pypff インポート失敗: {e}")
return False
# 2. 主要なクラス・関数の確認
print("\n📋 利用可能な機能:")
functions_to_check = ['file', 'folder', 'message']
for func_name in functions_to_check:
if hasattr(pypff, func_name):
print(f" ✅ pypff.{func_name} - 利用可能")
else:
print(f" ❌ pypff.{func_name} - 利用不可")
# 3. DLLファイルの確認
print("\n🔍 インストールファイルの確認:")
pypff_dir = os.path.dirname(pypff.__file__)
print(f" pypffディレクトリ: {pypff_dir}")
if os.path.exists(pypff_dir):
files = os.listdir(pypff_dir)
print(" インストールされたファイル:")
for file in sorted(files):
file_path = os.path.join(pypff_dir, file)
file_size = os.path.getsize(file_path) if os.path.isfile(file_path) else 0
if file.endswith('.pyd'):
print(f" 📦 {file} ({file_size:,} bytes) - DLLライブラリ ⭐")
elif file.endswith('.py'):
print(f" 🐍 {file} ({file_size:,} bytes) - Pythonコード")
# 4. 基本的な機能テスト
print("\n🧪 基本機能テスト:")
try:
pst_file = pypff.file()
print(" ✅ pypff.file() オブジェクト作成成功")
methods = [method for method in dir(pst_file) if not method.startswith('_')]
print(f" 📝 利用可能なメソッド数: {len(methods)}")
except Exception as e:
print(f" ❌ 基本機能テスト失敗: {e}")
print("\n" + "=" * 60)
print("✅ テスト完了 - pypffは正常にインストールされています！")
print("=" * 60)
return True
def show_system_info():
"""システム情報を表示"""
print("💻 システム情報:")
print(f" Python バージョン: {sys.version.split()[0]}")
print(f" プラットフォーム: {sys.platform}")
print(f" 実行パス: {sys.executable}")
if __name__ == "__main__":
show_system_info()
test_pypff_installation()
実際のPSTファイル操作プログラム
インストールが完了したら、実際にPSTファイルを読み込んで操作するプログラムを作成できます。
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
PST File Reader - 簡単なPSTファイル読み込みサンプル
"""
import pypff
import sys
import os
class SimplePSTReader:
def __init__(self, pst_file_path):
self.pst_file_path = pst_file_path
self.pst_file = None
def open(self):
"""PSTファイルを開く"""
try:
self.pst_file = pypff.file()
self.pst_file.open(self.pst_file_path)
print(f"✅ PSTファイルを開きました: {self.pst_file_path}")
return True
except Exception as e:
print(f"❌ PSTファイルを開けませんでした: {e}")
return False
def show_folder_structure(self):
"""フォルダ構造を表示"""
if not self.pst_file:
print("❌ PSTファイルが開かれていません")
return
print("\n📁 フォルダ構造:")
print("-" * 40)
def show_folder(folder, level=0):
indent = " " * level
folder_name = folder.name if folder.name else "名前なし"
message_count = folder.number_of_sub_messages
print(f"{indent}📁 {folder_name} ({message_count}件)")
# サブフォルダを表示
for i in range(folder.number_of_sub_folders):
try:
sub_folder = folder.get_sub_folder(i)
show_folder(sub_folder, level + 1)
except:
continue
root_folder = self.pst_file.get_root_folder()
show_folder(root_folder)
def show_recent_messages(self, count=5):
"""最新のメッセージを表示"""
if not self.pst_file:
print("❌ PSTファイルが開かれていません")
return
print(f"\n📧 最新メッセージ ({count}件):")
print("-" * 40)
messages = []
def collect_messages(folder):
for i in range(folder.number_of_sub_messages):
try:
message = folder.get_sub_message(i)
if message.creation_time:
messages.append(message)
except:
continue
for i in range(folder.number_of_sub_folders):
try:
sub_folder = folder.get_sub_folder(i)
collect_messages(sub_folder)
except:
continue
root_folder = self.pst_file.get_root_folder()
collect_messages(root_folder)
# 日時でソート
messages.sort(key=lambda x: x.creation_time or "", reverse=True)
# 指定件数を表示
for i, message in enumerate(messages[:count]):
subject = message.subject if message.subject else "件名なし"
sender = message.sender_name if message.sender_name else "送信者不明"
date = message.creation_time if message.creation_time else "日時不明"
print(f"[{i+1}] {subject}")
print(f" 差出人: {sender}")
print(f" 日時: {date}")
print()
def close(self):
"""PSTファイルを閉じる"""
if self.pst_file:
self.pst_file.close()
print("✅ PSTファイルを閉じました")
def main():
if len(sys.argv) < 2:
print("使用方法: python simple_pst_reader.py <PSTファイルのパス>")
print("例: python simple_pst_reader.py C:\\Users\\username\\Documents\\archive.pst")
sys.exit(1)
pst_file_path = sys.argv[1]
if not os.path.exists(pst_file_path):
print(f"❌ ファイルが見つかりません: {pst_file_path}")
sys.exit(1)
# PSTリーダーを作成
reader = SimplePSTReader(pst_file_path)
try:
# PSTファイルを開く
if reader.open():
# フォルダ構造を表示
reader.show_folder_structure()
# 最新メッセージを表示
reader.show_recent_messages(5)
finally:
# ファイルを閉じる
reader.close()
if __name__ == "__main__":
main()
使用方法
1. インストール確認
python test_pypff_installation.py
2. PSTファイルの読み込み
python simple_pst_reader.py "C:\path\to\your\archive.pst"
インストールされるファイル
コンパイルが成功すると、以下の場所にファイルが作成されます：
D:\anaconda3\Lib\site-packages\pypff\
├── __init__.py # Pythonパッケージ初期化
├── pypff.py # Pythonラッパーコード
├── _pypff.pyd # メインのDLLライブラリ（重要）
└── __pycache__\ # Pythonキャッシュ
_pypff.pydが実際のPSTファイル解析を行うWindows DLLファイルです。
トラブルシューティング
よくあるエラーと対処法
-
Microsoft Visual C++ 14.0 is required
→ Visual Studio Community 2022をインストール -
No module named 'pypff'
→pip install libpff-pythonを再実行 -
Building wheel failed
→ 管理者権限でコマンドプロンプトを実行 -
ImportError: DLL load failed
→ Windows Defenderなどでブロックされている可能性があります
代替インストール方法
もしコンパイルに失敗する場合は、以下を試してください：
# 方法1: 事前ビルド版
pip install libpff-python
# 方法2: 別のビルド版
pip install pypff-20221025
まとめ
Windows 11環境でPythonからPSTファイルを読み込むには、Visual Studioの開発環境が必要ですが、一度セットアップすれば安定して動作します。この手順に従って環境を構築すれば、OutlookのPSTファイルから効率的にメールデータを抽出・分析できるようになります。
参考リンク
動作確認環境
- Windows 11 Pro
- Python 3.12
- Visual Studio Community 2022
- Anaconda 2024.02