Pythonでos.path.joinを使ったパス結合の基本と活用例10選

import os

# 基本的な使い方
path = os.path.join('ディレクトリ1', 'ディレクトリ2', 'ファイル名.拡張子')
print(path)

import os

# ディレクトリ名とファイル名を結合
path = os.path.join('documents', 'report.txt')
print(path)

import os

# 複数のディレクトリとファイル名を結合
path = os.path.join('home', 'user', 'documents', 'projects', 'python', 'script.py')
print(path)

import os

# 絶対パスと相対パスの結合
path1 = os.path.join('/usr', 'local', 'bin', 'python')
path2 = os.path.join('C:\\', 'Program Files', 'Python')
path3 = os.path.join('documents', '/usr', 'local', 'share')

print(path1)
print(path2)
print(path3)

/usr/local/bin/python
C:/Program Files/Python
/usr/local/share

\usr\local\bin\python
C:\Program Files\Python
\usr\local\share

import os

# ホームディレクトリを起点としたパス生成
home_dir = os.path.expanduser("~")
config_file = os.path.join(home_dir, ".config", "myapp", "settings.ini")
print(config_file)

import os
from datetime import datetime

# 現在の日時を取得
now = datetime.now()
date_str = now.strftime("%Y-%m-%d")

# ユーザー名を取得（実際のアプリケーションではユーザー入力や認証情報から取得することが多い）
username = "alice"

# 動的なファイル名生成
log_dir = os.path.join("logs", username)
log_file = os.path.join(log_dir, f"log_{date_str}.txt")

print(log_file)

import os

def create_project_structure(base_dir):
    dirs = [
        os.path.join(base_dir, "src"),
        os.path.join(base_dir, "tests"),
        os.path.join(base_dir, "docs"),
        os.path.join(base_dir, "data", "raw"),
        os.path.join(base_dir, "data", "processed")
    ]

    for dir_path in dirs:
        os.makedirs(dir_path, exist_ok=True)
        print(f"ディレクトリを作成しました: {dir_path}")

# プロジェクト構造を作成
create_project_structure("my_project")

ディレクトリを作成しました: my_project/src
ディレクトリを作成しました: my_project/tests
ディレクトリを作成しました: my_project/docs
ディレクトリを作成しました: my_project/data/raw
ディレクトリを作成しました: my_project/data/processed

import os

def change_extension(file_path, new_ext):
    # パスとファイル名を分割
    dir_path, file_name = os.path.split(file_path)
    # ファイル名と拡張子を分割
    name, _ = os.path.splitext(file_name)
    # 新しい拡張子でファイル名を再構成
    new_file_name = name + new_ext
    # 新しいパスを生成
    new_file_path = os.path.join(dir_path, new_file_name)
    return new_file_path

# 使用例
original_path = "/path/to/document.txt"
new_path = change_extension(original_path, ".pdf")
print(f"元のパス: {original_path}")
print(f"新しいパス: {new_path}")

元のパス: /path/to/document.txt
新しいパス: /path/to/document.pdf

import os
import platform

def get_config_path():
    system = platform.system()
    if system == "Windows":
        base_path = os.path.join(os.environ["APPDATA"], "MyApp")
    elif system == "Darwin":  # macOS
        base_path = os.path.join(os.path.expanduser("~"), "Library", "Application Support", "MyApp")
    else:  # Linux and other Unix-like
        base_path = os.path.join(os.path.expanduser("~"), ".config", "myapp")

    return os.path.join(base_path, "config.ini")

# 設定ファイルのパスを取得
config_path = get_config_path()
print(f"設定ファイルのパス: {config_path}")

import os

def create_unc_path(server, share, *args):
    unc_base = f"//{server}/{share}"
    return os.path.join(unc_base, *args)

# UNCパスの生成例
file_path = create_unc_path("fileserver", "shared", "documents", "report.docx")
print(f"生成されたUNCパス: {file_path}")

# UNCパスとローカルパスの結合
local_path = os.path.join("C:", "Users", "username", "Documents")
combined_path = os.path.join(file_path, local_path)
print(f"結合されたパス: {combined_path}")

生成されたUNCパス: //fileserver/shared/documents/report.docx
結合されたパス: //fileserver/shared/documents/report.docx/C:/Users/username/Documents

import os

def build_network_path(protocol, server, share, *path_elements):
    base_path = f"{protocol}://{server}/{share}"
    return os.path.join(base_path, *path_elements)

# SMBプロトコルを使用した例
smb_path = build_network_path("smb", "fileserver.local", "shared", "projects", "2024", "Q2", "report.xlsx")
print(f"SMBパス: {smb_path}")

# HTTPプロトコルを使用した例
http_path = build_network_path("http", "example.com", "api", "v1", "users", "profile")
print(f"HTTPパス: {http_path}")

# FTPプロトコルを使用した例
ftp_path = build_network_path("ftp", "ftp.example.com", "public", "downloads", "software", "latest.zip")
print(f"FTPパス: {ftp_path}")

SMBパス: smb://fileserver.local/shared/projects/2024/Q2/report.xlsx
HTTPパス: http://example.com/api/v1/users/profile
FTPパス: ftp://ftp.example.com/public/downloads/software/latest.zip

import os

# 空文字列を含むパス結合の例
path1 = os.path.join("/home/user", "", "documents")
path2 = os.path.join("/home/user", "documents", "")

print(f"パス1: {path1}")
print(f"パス2: {path2}")

パス1: /home/user/documents
パス2: /home/user/documents/

import os

def safe_join(*args):
    return os.path.join(*filter(bool, args))

# 安全なパス結合の例
safe_path1 = safe_join("/home/user", "", "documents")
safe_path2 = safe_join("/home/user", "documents", "")

print(f"安全なパス1: {safe_path1}")
print(f"安全なパス2: {safe_path2}")

安全なパス1: /home/user/documents
安全なパス2: /home/user/documents

import os

# スラッシュが混在したパスの例
mixed_path = os.path.join("C:\\Users", "username/Documents", "project/file.txt")
print(f"混在したパス: {mixed_path}")

import os

# パスの正規化
mixed_path = "C:\\Users/username\\Documents/project\\file.txt"
normalized_path = os.path.normpath(mixed_path)
print(f"正規化されたパス: {normalized_path}")

import os

# 重複したスラッシュの例
path_with_double_slash = os.path.join("//server", "/share", "/folder")
print(f"重複したスラッシュを含むパス: {path_with_double_slash}")

import os
import re

def custom_path_join(*args):
    path = os.path.join(*args)
    # UNCパスの先頭の // を保護
    if re.match(r'^//[^/]', path):
        return '/' + path.lstrip('/')
    return path

# カスタム関数の使用例
unc_path = custom_path_join("//server", "/share", "/folder")
print(f"カスタム結合されたUNCパス: {unc_path}")

from pathlib import Path

# pathlibを使用したパス結合
path = Path("home") / "user" / "documents" / "file.txt"
print(f"pathlibで結合されたパス: {path}")

# 絶対パスの取得
abs_path = path.absolute()
print(f"絶対パス: {abs_path}")

# ホームディレクトリを基準としたパス
home_path = Path.home() / "documents" / "file.txt"
print(f"ホームディレクトリからのパス: {home_path}")

pathlibで結合されたパス: home/user/documents/file.txt
絶対パス: /current/working/directory/home/user/documents/file.txt
ホームディレクトリからのパス: /home/username/documents/file.txt

# 文字列フォーマットを使用したパス構築（非推奨）
base_dir = "/home/user"
file_name = "document.txt"
path = f"{base_dir}/{file_name}"
print(f"文字列フォーマットで構築されたパス: {path}")

import os
from pathlib import Path

# os.path.joinを使用
path_os = os.path.join("/home/user", "document.txt")
print(f"os.path.joinで構築されたパス: {path_os}")

# pathlibを使用
path_pathlib = Path("/home/user") / "document.txt"
print(f"pathlibで構築されたパス: {path_pathlib}")

os.path.joinで構築されたパス: /home/user/document.txt
pathlibで構築されたパス: /home/user/document.txt