PythonでURLを安全に扱う：urllib.parse.quoteとunquoteの徹底解説

from urllib.parse import quote

# 日本語とスペースを含む文字列
text_to_encode = "PythonでURL エンコード"

# 文字列をURLエンコード
encoded_text = quote(text_to_encode)

print(f"元の文字列: {text_to_encode}")
print(f"エンコード後: {encoded_text}")

# 出力例:
# 元の文字列: PythonでURL エンコード
# エンコード後: Python%E3%81%A7URL%20%Eエンコード

from urllib.parse import quote

# スラッシュを含むパスのような文字列
path_to_encode = "data/ファイル名 with スペース.txt"

# スラッシュをエンコードしない場合 (safe='/')
encoded_path_safe_slash = quote(path_to_encode, safe='/')

# スラッシュもエンコードする場合 (デフォルト)
encoded_path_default = quote(path_to_encode)

print(f"元のパス: {path_to_encode}")
print(f"スラッシュをsafeにした場合: {encoded_path_safe_slash}")
print(f"デフォルトの場合: {encoded_path_default}")

# 出力例:
# 元のパス: data/ファイル名 with スペース.txt
# スラッシュをsafeにした場合: data/%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E5%90%8D%20with%20%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9.txt
# デフォルトの場合: data%2F%E3%83%95%E3%83%A3%E3%82%A4%E3%83%AB%E5%90%8D%20with%20%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9.txt

from urllib.parse import unquote

# エンコードされたURL文字列
encoded_url_string = "https://example.com/search?q=%E3%83%91%E3%82%A4%E3%82%BD%E3%83%B3+%E3%83%87%E3%83%BC%E3%82%BF%E5%8F%96%E5%BE%97"

# クエリパラメータ部分だけをデコードしたい場合
# まずはクエリ文字列を抽出
from urllib.parse import urlparse
parsed_url = urlparse(encoded_url_string)
query_string = parsed_url.query

# クエリ文字列をデコード
decoded_query_string = unquote(query_string)

print(f"元のURL文字列: {encoded_url_string}")
print(f"デコードされたクエリ文字列: {decoded_query_string}")

# 出力例:
# 元のURL文字列: https://example.com/search?q=%E3%83%91%E3%82%A4%E3%82%BD%E3%83%B3+%E3%83%87%E3%83%BC%E3%82%BF%E5%8F%96%E5%BE%97
# デコードされたクエリ文字列: q=Python データ取得

from urllib.parse import quote, quote_plus, unquote, unquote_plus

text = "スペース と + 記号"

# quote と quote_plus の比較
encoded_quote = quote(text)
encoded_quote_plus = quote_plus(text)

print(f"元の文字列: {text}")
print(f"quoteでエンコード: {encoded_quote}")
print(f"quote_plusでエンコード: {encoded_quote_plus}")

# unquote と unquote_plus の比較
# quote_plusでエンコードしたものをデコード
decoded_unquote = unquote(encoded_quote_plus)
decoded_unquote_plus = unquote_plus(encoded_quote_plus)

print(f"quote_plusでエンコードしたもの:")
print(f"  unquoteでデコード: {decoded_unquote}")
print(f"  unquote_plusでデコード: {decoded_unquote_plus}")

# 出力例:
# 元の文字列: スペース と + 記号
# quoteでエンコード: %E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9%20%E3%81%A8%20%2B%20%E8%A8%98%E5%8F%B7
# quote_plusでエンコード: %E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9+%E3%81%A8+%2B+%E8%A8%98%E5%8F%B7
# quote_plusでエンコードしたもの:
#   unquoteでデコード: %E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9 + %E3%81%A8 + %2B + %E8%A8%98%E5%8F%B7 # ここがポイント！
#   unquote_plusでデコード: スペース と + 記号