PythonでURLを扱うときに使う標準ライブラリ urllib.parse の機能について学んだことを、自分用の学習メモとしてまとめました。URLの分解や結合、クエリの操作、エンコードなど、よく使う基本を整理しています。
URLを構成要素に分解する（urlparse()）
URLをスキーム・ドメイン・パス・クエリなどに分解するには urlparse() を使います。
from urllib.parse import urlparse
url = "https://example.com/path/to/page?name=alice&age=30"
parsed = urlparse(url)
print(parsed.scheme) # 'https'
print(parsed.netloc) # 'example.com'
print(parsed.path) # '/path/to/page'
print(parsed.query) # 'name=alice&age=30'
https
example.com
/path/to/page
name=alice&age=30
クエリ文字列を辞書形式に変換する（parse_qs()）
URLのクエリ文字列を辞書のように扱うには parse_qs() を使います。返される値はリスト型です。
from urllib.parse import parse_qs
query = "name=alice&age=30&age=25"
params = parse_qs(query)
print(params)
{'name': ['alice'], 'age': ['30', '25']}
クエリ文字列をタプルのリストにする（parse_qsl()）
クエリの順番を保持した(キー, 値)のリストが欲しいときは parse_qsl() を使います
from urllib.parse import parse_qsl
query = "name=alice&age=30&age=25"
params = parse_qsl(query)
print(params)
[('name', 'alice'), ('age', '30'), ('age', '25')]
辞書からクエリ文字列を作る（urlencode()）
辞書などのデータをURLのクエリ文字列に変換するには urlencode() を使います。
from urllib.parse import urlencode
params = {'name': 'alice', 'age': 30}
query_string = urlencode(params)
print(query_string)
name=alice&age=30
リストの値を含む場合、doseq=True を指定すると複数キーになります。
params = {'age': [30, 25]}
print(urlencode(params, doseq=True))
age=30&age=25
URLエンコードとデコード（quote() / unquote()）
URLに使えない文字（日本語など）を含む文字列は、エンコードして安全に送れるようにします。
from urllib.parse import quote, unquote
original = "こんにちは"
encoded = quote(original)
decoded = unquote(encoded)
print(encoded)
print(decoded)
%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF
こんにちは
相対URLを組み立てる（urljoin()）
ベースとなるURLに対して相対パスを組み合わせて、絶対URLを作ることができます。
from urllib.parse import urljoin
base = "https://example.com/path/"
relative = "sub/page.html"
full_url = urljoin(base, relative)
print(full_url)
https://example.com/path/sub/page.html
おわりに
今回はURLの構造を理解したり、クエリや文字列のエンコード・デコードをするための基本的な使い方を整理しました