Python で「ハイフンを含んだデータ名」の JSON を pydantic で受け取る場合の処理
Python で「JSON でデータを受け取る」ようなケースを考えた場合、データを pydantic でクラス化するケースがあると思います。 例えば FastAPI で POST された JSON を受け取る Web アプリケーションを開発する場合などです。 こういった場合、「JSON 内のデータ名」と「クラスの変数名」は同じ名前にするのが自然だと思います。 しかし、- を含む JSON を渡された場合、どういって処理するのか、メモしておきたいと思います。
1. 記号を含まないデータ名の場合¶
記号を含まない場合は特に処理を意識する必要がありません。 下記のサンプルでは「渡されるデータ名 → 受け取るデータ名」が「hostname → hostname」で一致しており、記号なども含んでいない為、特別な処理は不要です。
from pydantic import BaseModel
class Device(BaseModel):
hostname: str
external_data = {'hostname': 'RouterA'}
data = Device(**external_data)
print(data)
実行結果は以下の通りです。
2. データ名に「アンダースコア」を含む場合¶
データ名に _ (アンダースコア) を含む場合も、特に考慮はありません。 下記のサンプルでは「host_name → host_name」で一致しており、特別な処理は不要です。
from pydantic import BaseModel
class Device(BaseModel):
host_name: str
external_data = {'host_name': 'RouterA'}
data = Device(**external_data)
print(data)
実行結果は以下の通りです。
3. データ名に「ハイフン」を含む場合¶
データに - (ハイフン) を含む場合は問題があります。
from pydantic import BaseModel
class Device(BaseModel):
host-name: str # Error!
external_data = {'host-name': 'RouterA'}
data = Device(**external_data)
print(data)
実行結果は以下の通りです。 変数名に Python で理解出来ない - を含んでいる為、エラーになります。
$ python sample3.py
File "sample3.py", line 4
host-name: str # Error!
^
SyntaxError: illegal target for annotation
4. データ名の「ハイフン」を Alias で回避する¶
このエラーを回避するには変数名自体は host_name のようにアンダースコアを使うものの、alias を設定してデータ内の host-name というハイフンを含む名前を受け取れるようにします。
from pydantic import BaseModel, Field
class Device(BaseModel):
host_name: str = Field(..., alias='host-name')
external_data = {'host-name': 'RouterA'}
data = Device(**external_data)
print(data)
これでプログラム内部でアクセスする場合は host_name とアンダースコア形式ではあるものの、データを受け取る処理自体は host-name という alias が使えるようになりました。